首先安装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，而不是全局命令。这样才能加载正确的环境和依赖。