vscode运行rspec需确保走项目bundler环境，禁用全局rspec和byebug，显式配置"ruby.testcommand": "bundle exec rspec"，启用usebundler并安装ruby-debug-ide与debase，windows用户注意路径分隔符。
VSCode 能直接运行和调试 RSpec，但必须绕过两个默认陷阱：一是它不会自动用 bundle exec 启动测试，二是默认调试器（byebug）在 Ruby 3.1+ 上根本不可用。
为什么 rspec 命令在终端能跑，VSCode 里点“运行测试”却报错？
常见错误现象：command not found: rspec、uninitialized constant RSpec、或直接卡住无响应。根本原因不是插件没装，而是 VSCode 没走项目的 Bundler 环境。
- VSCode 集成终端默认不加载 shell 的
rbenv init或rvm reload，导致which rspec找不到 bundle 包装后的可执行文件 - 即使
rspec命令可用，VSCode 默认调用的是全局rspec，而非bundle exec rspec，Gemfile.lock 里的版本约束被绕过 - 某些插件（如旧版
ruby-test）会硬编码调用rspec，完全忽略BUNDLE_GEMFILE和GEM_HOME
怎样让 VSCode 正确识别并运行项目级 rspec？
关键不是装更多插件，而是把执行路径“钉死”在 bundle 环境里。实操建议如下：
- 在项目根目录的
.vscode/settings.json中显式指定测试命令："ruby.testCommand": "bundle exec rspec"
- 确保
bundle exec rspec --version在 VSCode 集成终端中能正常输出——如果失败，先解决 rbenv/rvm 环境加载问题（source ~/.zshrc或重启终端） - 禁用所有带“test”字样的 Ruby 插件（如
ruby-test、rspec-snippets），只保留wingrunr21.vscode-ruby+shawncarter.rails-run-specs（后者专为 Rails 项目优化，支持行级it块执行） - 若用非 Rails 项目，手动在
.vscode/launch.json中加一个配置：{ "name": "Run current spec file", "type": "Ruby", "request": "launch", "useBundler": true, "program": "${file}", "cwd": "${workspaceFolder}" }
调试单个 it 块时，为什么断点不生效或跳过？
根本原因是 Ruby 调试器链路断裂：VSCode → rdebug-ide → 实际代码。Ruby 3.1+ 已弃用 byebug，而 ruby-debug-ide 依赖的 debase 在某些 Bundler 场景下无法注入。
- 必须在 Gemfile 中声明：
group :development, :test do<br> gem 'ruby-debug-ide'<br> gem 'debase'<br>end
，然后运行bundle install - 不要用
gem install ruby-debug-ide全局安装——它和 bundle 环境不一致，VSCode 找不到对应版本 - 在
launch.json中启用useBundler: true，并确认pathToBundler指向项目内bundle（如${workspaceFolder}/bin/bundle，Rails 7+ 项目常用此路径） - 首次调试前，在待测 spec 文件顶部加一句
binding.break，验证是否能真正中断；若不能，说明ruby-debug-ide未被 bundle 加载
如何避免每次打开项目都要手动检查 rspec 环境？
最省事的方式是把环境校验变成自动化步骤，而不是靠人眼确认。
- 在项目根目录加一个
.vscode/tasks.json，定义check-rspec任务：{ "label": "check-rspec", "type": "shell", "command": "bundle exec rspec --dry-run -f d", "group": "build", "presentation": { "echo": true, "reveal": "always", "focus": false } } - 设置 VSCode 启动时自动运行：
"editor.codeActionsOnSave": { "source.fixAll": true },<br>"files.associations": { "*.spec.rb": "ruby" },<br>"ruby.intellisense": "rubyLocate" - 最关键的隐藏点：Windows 用户若用 msys2+rbenv，
bundle exec可能因路径分隔符（/vs）失败，此时必须在launch.json中设"windows": { "pathToBundler": "C:\msys64\home\user\project\bin\bundle" }
复杂点往往藏在路径和加载顺序里——bundle exec 不是开关，而是一条必须全程贯通的管道；断在哪一环，测试就停在哪一步。
