首先安装Ruby扩展和debug gem，然后在Gemfile的development组中添加gem 'debug', '~> 1.8'并运行bundle install；接着在项目根目录创建.vscode/launch.json文件，配置Rails Server、Rails Console和Debug RSpec三种调试模式，确保program指向${workspaceFolder}/bin/rails以使用本地可执行文件；最后在VS Code中按F5选择配置，设置断点即可启动调试。
要在 VS Code 中为 Ruby on Rails 项目配置调试器，关键是使用 Ruby 扩展和 debug gem（以前叫 debase）。下面是如何一步步完成配置的实用指南。
安装必要的工具和扩展
确保你已经安装了以下内容：
- Ruby 环境（建议使用 rbenv 或 rvm 管理版本）
- Rails 项目已能正常运行
- VS Code
在 VS Code 中安装推荐的扩展：
- Ruby（由 misogachi 维护）
- Debug for Ruby（由 rebornix 提供）
- Ruby Solargraph（可选，用于代码补全）
添加 debug gem 到项目
打开你的 Gemfile，在 development 组中添加：
group :development do gem 'debug', '~> 1.8' end
然后运行：
bundle install
这个 gem 是标准库 debug 的封装，支持 VS Code 调试协议。
配置 VS Code 启动调试器
在项目根目录创建文件夹 .vscode，并新建 launch.json 文件：
{
"version": "0.2.0",
"configurations": [
{
"name": "Rails Server",
"type": "ruby",
"request": "launch",
"program": "${workspaceFolder}/bin/rails",
"args": [
"server"
],
"cwd": "${workspaceFolder}"
},
{
"name": "Rails Console",
"type": "ruby",
"request": "launch",
"program": "${workspaceFolder}/bin/rails",
"args": [
"console"
],
"cwd": "${workspaceFolder}"
},
{
"name": "Debug RSpec",
"type": "ruby",
"request": "launch",
"program": "${workspaceFolder}/bin/rspec",
"args": [
"${relativeFile:-spec}"
],
"cwd": "${workspaceFolder}",
"terminal": "integrated"
}
]
}这样你就可以调试 Rails 服务、控制台或 RSpec 测试。
开始调试
按 F5 或点击“运行和调试”侧边栏，选择你要启动的配置，比如 Rails Server。
在代码中打上断点（点击行号左侧），当请求到达对应代码时，执行会暂停，你可以查看变量、调用栈和表达式求值。
例如，在控制器中加个断点：
def show @user = User.find(params[:id]) # 在这行设断点 render json: @user end
访问 /users/1，VS Code 就会进入调试模式。
基本上就这些。只要 gem 装好，launch.json 配置正确，VS Code 就能顺利调试 Rails 应用。不复杂但容易忽略的是确保用的是项目本地的 bin/rails，而不是全局命令。这样才能加载正确的环境和依赖。
