Windows10及以上系统VSCode调试Ruby3.2.x+的问题求助

推荐扩展 #

• Debugger for Ruby：目前适配Ruby 3.2+版本的主流调试扩展，Windows环境下兼容性较好，支持断点设置、变量查看、步进调试等核心调试功能。
• Ruby LSP：官方维护的扩展，调试功能本身可用，大概率是配置问题导致无法正常运行，调整配置后可稳定使用。

调试基本步骤 #

使用Debugger for Ruby调试 #

1. 安装扩展后，先确认本地Ruby环境正常：打开终端执行ruby -v，能正确输出3.2+版本号；Windows下可执行where ruby验证Ruby的bin目录已加入系统环境变量。
2. 打开要调试的Ruby文件，点击左侧调试面板（快捷键Ctrl+Shift+D），点击「创建launch.json文件」，选择「Ruby」环境自动生成基础配置。
3. 若调试单个文件，可将launch.json调整为：

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "调试当前Ruby文件",
      "type": "Ruby",
      "request": "launch",
      "program": "${file}"
    }
  ]
}

4. 在代码行号左侧点击设置断点，点击调试面板的启动按钮即可开始调试。

修复Ruby LSP的调试问题 #

1. 更新Ruby LSP到最新版本，然后在项目目录（或全局）执行gem install debug，安装调试所需的依赖gem。
2. 修改launch.json适配Ruby 3.2+：

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "ruby_lsp",
      "name": "调试Ruby文件",
      "request": "launch",
      "program": "${file}",
      "useBundler": false, // 若用Bundler管理依赖，改为true并确保Gemfile中添加了debug
      "rubyPath": "C:/Ruby32-x64/bin/ruby.exe" // 替换为你的Ruby实际安装路径，Windows下路径用正斜杠或双反斜杠
    }
  ]
}

3. 设置断点后启动调试，若仍有问题，检查VSCode右下角的Ruby环境是否切换到你的3.2+版本。

注意事项 #

• Windows下避免将Ruby项目放在含中文或空格的路径中，可能导致调试路径解析失败。
• 若使用WSL中的Ruby，需切换VSCode到WSL远程环境，再安装对应扩展调试。

内容的提问来源于stack exchange，提问作者muratp