如何在VSCode中配置Ruby开发环境？【教程】

vscode 需手动配置 ruby 解释器路径、启用 Solargraph、显式指定 rubyVersion 和 pathToBundler，并确保 bundle exec 环境生效，否则调试、补全、依赖均失效。

rbenv 或 rvm 装 ruby 本身不是 vscode 的事，vscode 只负责识别、调试和补全——配置不对，ruby 命令能跑，但 launch.json 会找不到解释器，solargraph 会连不上，bundle install 的 gem 也常被无视。

确认 Ruby 解释器路径并设为 VSCode 默认

VSCode 不自动继承 shell 的 PATH（尤其 macOS 上用 rbenv 或 rvm 时），它可能只看到系统自带的 Ruby（如 /usr/bin/ruby），导致 bundle、rails 命令报错“command not found”。

• 在终端运行 which ruby，记下输出（例如 /Users/you/.rbenv/shims/ruby 或 /Users/you/.rvm/rubies/ruby-3.2.2/bin/ruby）
• 打开 VSCode 设置（Cmd+, ），搜索 ruby interpreter path，填入上面路径
• 如果用 rbenv，别填 ~/.rbenv/shims/ruby —— 它是 bash 函数代理，VSCode 执行不了；应填 ~/.rbenv/versions/3.2.2/bin/ruby（用 rbenv version 确认当前版本）

安装并启用 Solargraph 扩展（非可选）

没有 solargraph，VSCode 对 Ruby 几乎没有智能提示、跳转或文档支持。它不是装个插件就完事——服务端必须手动启动并匹配项目 Ruby 版本。

• 先在项目根目录运行：

  gem install solargraph

• 确保 solargraph 使用的是当前项目的 Ruby：运行 ruby -v 和 which solargraph，二者 PATH 应指向同一 rbenv 或 rvm 版本
• 在 VSCode 中按 Cmd+Shift+P → 输入 Solargraph: Restart，观察右下角状态栏是否显示 Solargraph is running
• 若提示 “Failed to start Solargraph”，检查终端能否直接执行 solargraph stdio；不能则说明 solargraph 不在当前 Ruby 的 GEM_PATH 下

调试配置必须显式指定 rubyVersion 和 pathToBundler

VSCode 的 Ruby 调试器（rebornix.ruby 已弃用，现主流用 fxa96.ruby-debug-ide 或官方 ruby-rdbg）默认不读 .ruby-version 或 Gemfile，不配就崩。

• 生成调试配置：Cmd+Shift+P → Debug: Open launch.json → 选 Ruby
• 在 configurations 里补充：

  {   "type": "rdbg",   "name": "Debug Current File",   "request": "launch",   "script": "${file}",   "rubyVersion": "3.2.2",   "pathToBundler": "/Users/you/.rbenv/shims/bundle" }

• rubyVersion 必须与 .ruby-version 一致；pathToBundler 必须是 shim 路径（不是 bundle 命令本身），否则断点不触发、binding.irb 失效

Bundle 依赖不生效？检查 VSCode 是否用了错误的 GEM_HOME

常见现象：终端里 bundle exec rails s 正常，VSCode 里运行 RSpec 却报 cannot load such file -- rspec/core。本质是 VSCode 启动的进程没加载 bundle exec 环境。

• 不要依赖全局 rspec 命令；在 tasks.json 或调试配置中，一律用 bundle exec 前缀：

  "command": "bundle exec rspec"

• 在 VSCode 设置中搜 terminal integrated env，添加环境变量：

  "RUBYOPT": "-rbundler/setup"

  （仅当项目有 Gemfile 时有效）

• 最稳方案：关掉 VSCode，从终端用 code . 启动——这样它能完整继承 shell 的 rbenv/rvm 环境变量

Ruby 开发环境的脆弱点不在 VSCode 插件多寡，而在解释器路径、GEM_HOME、bundle shim 三者是否对齐。少一个，require 就失败，debugger 就静默退出，solargraph 就标红整个文件。