安装rbenv并配置shell环境，使用rbenv管理Ruby版本；2. 在VSCode中安装Ruby、Solargraph和Debug扩展；3. 设置settings.json指定rbenv路径；4. Gemfile添加debug gem并配置launch.json调试项；5. 使用binding.b插入断点启动调试。
在 VSCode 中配置 Ruby 开发环境，尤其是集成 rbenv 和调试器（如 debug gem），可以让开发更高效。以下是一套实用、清晰的配置方法，适用于 macOS 和 Linux 系统。
1. 安装 rbenv 与 Ruby 版本管理
确保 rbenv 已正确安装并配置到你的 shell 环境中。
- 使用 Homebrew（macOS）或直接克隆仓库安装 rbenv：
macOS 示例：
brew install rbenv rbenv init
- 将 rbenv 添加到 shell 配置文件（如 ~/.zshrc 或 ~/.bashrc）：
export PATH="$HOME/.rbenv/bin:$PATH" eval "$(rbenv init -)"
- 安装 Ruby 版本并设置项目本地版本：
rbenv install 3.1.2 rbenv local 3.1.2
确认当前 Ruby 版本：
ruby -v which ruby
2. 安装 VSCode 扩展
打开 VSCode，安装以下扩展：
- Ruby（由 misogi 提供）— 语法高亮、代码跳转
- Ruby Solargraph — 智能补全、文档提示
- Debug for Ruby — 支持断点调试
Solargraph 安装后建议运行：
gem install solargraph solargraph download-core solargraph bundle
3. 配置 VSCode 使用 rbenv 的 Ruby 解释器
VSCode 默认可能使用系统 Ruby，需手动指定 rbenv 管理的路径。
- 查找 rbenv 的 Ruby 可执行文件路径：
which ruby # 输出类似：/Users/yourname/.rbenv/shims/ruby
- 在 VSCode 设置中（settings.json）添加：
"ruby.interpreter.command": "rbenv exec ruby", "ruby.pathToBundler": "/Users/yourname/.rbenv/shims/bundle", "ruby.useLanguageServer": true, "solargraph.commandPath": "/Users/yourname/.rbenv/shims/solargraph"
这样 VSCode 就会通过 rbenv 正确调用 Ruby 和相关工具。
4. 配置调试器（使用 debug gem）
Ruby 3.1+ 推荐使用内置的 debug gem 替代 byebug。
- 在项目 Gemfile 中添加：
group :development, :test do gem 'debug', '~> 1.8' end
- 运行 bundle install：
bundle install
{
"version": "0.2.0",
"configurations": [
{
"name": "Debug Current File",
"type": "Ruby",
"request": "launch",
"program": "${workspaceFolder}/${relativeFile}",
"cwd": "${workspaceFolder}",
"env": {
"RBENV_VERSION": "3.1.2"
},
"pathToRDebugIDE": "/Users/yourname/.rbenv/versions/3.1.2/bin/rdebug-ide"
}
]
}
注意：pathToRDebugIDE 要指向你当前 rbenv 版本下的 rdebug-ide 路径，可通过以下命令查找：
rbenv which rdebug-ide
5. 启动调试
在代码中插入断点或使用 binding.b（debug gem 的快捷断点）：
def hello
name = "world"
binding.b # 程序会在此暂停
puts "Hello, #{name}!"
end
点击 VSCode 调试面板中的 “Debug Current File” 即可启动调试会话。
基本上就这些。只要 rbenv 路径正确，gem 安装完整，VSCode 就能无缝支持 Ruby 开发与调试。不复杂但容易忽略的是环境变量和 shim 路径的匹配问题，多检查 which ruby 和 rbenv which 输出即可。
