VSCode配置Ruby开发环境 VSCode安装Ruby插件及调试-VSCode-PHP中文网

ruby插件无反应，主因是vscode未继承ruby环境：终端which ruby有输出但集成终端为空，需确保rbenv/rvm路径正确注入shell配置并完全重启vscode；必须安装ruby-lsp gem且版本匹配，调试需配置launch.json和ruby-debug-ide，测试执行须通过bundle exec对齐gemfile.lock版本。

vscode配置ruby开发环境 vscode安装ruby插件及调试

VSCode 里 Ruby 插件装了一堆却没反应？不是插件没点开，而是 Ruby 环境根本没进 VSCode 的上下文——which ruby 在终端里有输出，但在 VSCode 集成终端里是空的，那所有后续配置都白搭。

ruby 命令在 VSCode 终端里找不到？先查环境变量加载路径

VSCode 启动时默认不读 ~/.zshrc（macOS）、~/.bashrc（Linux）或 PATH 注册表项（Windows），它靠的是系统级 shell 启动时的环境快照。你手动在终端里 source ~/.zshrc 有效，不代表 VSCode 能继承。

macOS：检查 ~/.zshrc 是否包含 export PATH="$HOME/.rbenv/bin:$PATH" 和 eval "$(rbenv init - zsh)"；改完后必须完全退出 VSCode（不是关窗口，是 Cmd+Q），再重开
Windows：RubyInstaller 安装时务必勾选 “Add Ruby executables to your PATH”；若已安装未勾选，需手动把 C:\Ruby32-x64\bin 加进系统环境变量，然后重启 VSCode
验证方式：在 VSCode 集成终端中运行 which ruby（macOS/Linux）或 where ruby（Windows），输出路径必须含 .rbenv/、.rvm/ 或 Ruby32-x64\bin，不能是 /usr/bin/ruby

装了 Ruby 插件但跳转/补全失效？ruby-lsp gem 没装或版本不匹配

目前稳定可用的 Ruby LSP 实现是 ruby-lsp，不是 Solargraph（已停更）、也不是旧版 rebornix.ruby 自带的语言服务。只装 VSCode 插件 castwide.ruby-lsp 不起作用，必须本地装 gem。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

在项目根目录运行：gem install ruby-lsp；如果用 rbenv，确保当前 shell 的 Ruby 版本与项目一致（rbenv local 3.2.2），再执行安装
旧版 Ruby（如 2.6 以下）不兼容最新 ruby-lsp，会静默失败；查看 VSCode Output 面板 → “Ruby LSP”，看到 Failed to start language server 就是这个原因
项目用 Bundler？在插件设置里把 rubyLsp.serverPath 改成 bundle exec ruby-lsp，否则 LSP 无法加载 Gemfile.lock 锁定的依赖

按 F5 调试直接报错？launch.json 缺失或 ruby-debug-ide 配置错位

VSCode Ruby 调试器不支持零配置启动。所谓“装完插件就能 F5”是常见误解。真正起作用的是 ruby-debug-ide + debase（或 Rails 7.1+ 的 debug），而 VSCode 只是前端调用者。

调试前必须在项目根目录创建 .vscode/launch.json，内容至少包含一个 "type": "Ruby" 配置；空文件或缺字段都会报 No configuration found for launch
debug gem（Rails 7.1+ 默认带）和 ruby-debug-ide（老项目用）互斥；若 Gemfile 里有 gem 'debug'，就别装 ruby-debug-ide，反之亦然
launch.json 中 "pathToRDebugIDE" 必须指向 bundle exec rdebug-ide（不是 rdebug，也不是全局 rdebug-ide），否则断点只在 require 之后的文件生效（比如 app/controllers/ 可以，config/application.rb 不行）

为什么 bundle exec rspec 在终端能跑，VSCode 里点“Run Test”就报错？

VSCode 插件默认调用 rspec 命令走的是 $PATH 第一个可执行文件，不是你 Gemfile.lock 里锁死的版本。结果就是本地 RSpec 3.14 跑通，VSCode 却调了系统里残留的 RSpec 2.x，语法直接崩。

解决办法：在项目根目录建 .vscode/settings.json，写入：{"ruby.lsp.bundlePath":"bundle"}；这会让 Ruby LSP、rubocop、rspec 插件全部走 bundle exec 上下文
如果你用 shawncarter.rails-run-specs 插件跑单个 it 块，它内部也依赖这个设置；不配的话，点行号运行仍会用错 RSpec 版本
别信“全局配置 ruby.formatting.prettierPath 就够了”——格式化路径和测试执行路径是两套机制，必须分别对齐 bundle exec

最常被忽略的一点：VSCode 的 Ruby 插件之间存在隐式依赖链，castwide.ruby-lsp 要求 gem install ruby-lsp，misogi.ruby-debug-ide 要求 bundle add debug 或 gem install ruby-debug-ide，而这两者又都依赖 which ruby 输出正确。三者缺一，编辑、跳转、调试就各掉一块，但错误现象分散，容易误判为“插件冲突”。