Ruby插件无反应，主因是VSCode未继承Ruby环境：终端which ruby有输出但集成终端为空，需确保rbenv/rvm路径正确注入shell配置并完全重启VSCode；必须安装ruby-lsp gem且版本匹配，调试需配置launch.json和ruby-debug-ide，测试执行须通过bundle exec对齐Gemfile.lock版本。
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。
- 在项目根目录运行：
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 -
debuggem（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 输出正确。三者缺一，编辑、跳转、调试就各掉一块，但错误现象分散，容易误判为“插件冲突”。
