VSCode 运行 Ruby 脚本时 RVM 动态切换路径失效排查

在开发环境中摸爬滚打久了，你会发现大多数Ruby环境问题的根源并不复杂，无非是上下文没对齐。VSCode与RVM的组合，就是一个典型的重灾区。明明在终端里切换了Ruby版本，脚本一跑就是系统自带的，或者调试器怎么也连不上。这些问题的本质其实很一致——VSCode启动集成终端时，并没有加载你的shell初始化文件，比如~/.zshrc。这意味着它根本不知道RVM的存在。你在终端里手动执行rvm use 3.2.2虽然能切换，但那只是当前会话有效，VSCode启动时是“干净”的，不继承这些手动操作。

VSCode 终端里 rvm use 有效但脚本仍跑在系统 Ruby 上？

怎么验证？直接在VSCode集成终端里运行rvm current。如果输出的是system，或者干脆报command not found: rvm，问题就坐实了。解决方案其实很简单，但有个坑需要注意：

• macOS用户检查~/.zshrc是否包含RVM初始化代码：[[ -s "$HOME/.rvm/scripts/rvm" ]] && source "$HOME/.rvm/scripts/rvm"
• 改完之后，必须完全退出VSCode（Cmd+Q），不能只是关窗口。只关窗口的话，之前的进程上下文还在，改了也白改。
• Windows用户基本不用RVM，别折腾；WSL下装的RVM对原生VSCode不可见，得用WSL版VSCode才能正确继承环境。

which ruby 显示 /Users/xxx/.rvm/rubies/ruby-3.2.2/bin/ruby 但 bundle exec 报错？

这种情况说明RVM路径本身没问题，但Bundler没对齐当前gemset或Ruby版本。RVM的gemset是隔离的，你bundle install安装的gem只在当前gemset里可见。如果VSCode没有激活对应的gemset，那么bundle exec就会fallback到全局或默认gemset，自然找不到项目依赖的gem。

• 在项目根目录下运行rvm use 3.2.2@myproject（假设你有命名gemset），确保gemset对齐。
• 确认.ruby-version和.ruby-gemset文件存在且内容正确，这两个文件是RVM自动切换的依据。
• VSCode启动前，确保终端已激活目标gemset。否则即使路径对，bundle exec也会用错上下文。
• 插件如ruby-lsp默认不读取RVM的gemset，需要在设置里显式指定rubyLsp.serverPath为bundle exec ruby-lsp，否则它可能用全局的gem去解析项目。

点右上角 ▶️ 运行 Ruby 脚本，却提示 LoadError: cannot load such file？

VSCode的“运行”按钮默认调用的是ruby script.rb，它绕过了Bundler，直接用当前Ruby解释器加载文件。你的代码里如果用了require_relative、autoload_paths或直接依赖Gemfile里的gem，那么只有bundle exec ruby script.rb才能正常解析依赖关系。

• 最直接的办法：不要依赖右上角按钮，统一用集成终端执行bundle exec ruby your_script.rb。
• 如果非要一键运行，可以装formulahendry.code-runner插件，并在settings.json中配置："code-runner.executorMap": {"ruby": "cd $dir && bundle exec ruby $fileName"}。
• 注意：RVM的default gemset不等于项目gemset，别指望一句rvm --default就能解决所有问题。项目级别的依赖必须用bundle exec来隔离。

调试时断点灰掉、F5 报 No configuration found for launch？

Ruby调试不支持零配置，launch.json必须手动写，而且要和RVM当前激活的Ruby版本严格匹配。Ruby 3.1+已经废弃了ruby-debug-ide，新版必须用debug gem。但debug的二进制名、路径、甚至launch.json里的path字段都会随RVM切换而变，没法一劳永逸。

• 先在当前gemset下运行gem install debug。
• 生成.vscode/launch.json，关键字段是"ruby": "bundle exec ruby"和"debugger": "debug"。
• 别再用ruby-debug-ide了，它在Ruby 3.1+上会静默失败或报undefined method write' for nil:NilClass，属于历史遗留问题。
• 每次RVM切换Ruby版本后，都要重新gem install debug。旧版本的debug gem与新解释器不兼容，这也是最常见的踩坑点。

RVM的动态路径切换机制本身没有问题。问题永远出在VSCode的启动上下文与shell环境的割裂，再加上Bundler、gemset、debugger三者之间没有对齐。最稳妥的做法是：先确保rvm current在VSCode终端里输出预期版本，再在这个前提下配置bundle exec和debug。这一步做扎实了，后面基本不会出什么意外。