安装ruby扩展、配置解释器路径、安装solargraph与调试gem、设置launch.json后即可在vscode中调试Ruby代码。

要在VSCode中搭建Ruby开发环境并配置调试功能，关键在于安装合适的扩展、正确设置运行时路径以及配置调试器。只要完成几个核心步骤，就能高效编写和调试Ruby代码。

安装必要扩展

打开VSCode的扩展面板（Ctrl+Shift+X），搜索并安装以下扩展：

• Ruby（由rebornix提供）：提供语法高亮、智能提示和代码导航。
• Ruby Solargraph：增强代码补全和文档提示，需额外安装solargraph gem。
• Debugger for Ruby：支持断点调试，基于ruby-debug-ide和debase实现。

安装后建议重启VSCode，确保扩展正常加载。

配置Ruby运行环境

确保系统已安装Ruby，并能通过命令行调用。可通过终端执行以下命令验证：

ruby -v

如果命令未找到，请先安装Ruby（推荐使用rbenv或RVM管理版本）。在VSCode中，还需设置Ruby解释器路径：

• 进入设置（Ctrl+,），搜索“ruby.path”。
• 填写Ruby可执行文件的完整路径，例如linux/macOS下通常是/usr/bin/ruby或rbenv路径下的ruby。

若使用Solargraph，还需在终端运行：

gem install solargraph

然后在项目根目录初始化：

solargraph config

配置调试功能

调试需要ruby-debug-ide和debase两个gem：

面试猫

AI面试助手，在线面试神器，助你轻松拿Offer

39

查看详情

gem install ruby-debug-ide gem install debase

在项目根目录创建.vscode文件夹，添加launch.json文件：

{   "version": "0.2.0",   "configurations": [     {       "name": "Debug Ruby",       "type": "Ruby",       "request": "launch",       "program": "${file}",       "cwd": "${workspaceFolder}"     }   ] }

该配置表示调试当前打开的Ruby文件。你也可以指定具体脚本路径，如：

"program": "${workspaceFolder}/bin/app.rb"

设置断点后，按F5启动调试，VSCode会自动暂停并显示变量状态。

常见问题处理

若调试无法启动，检查以下几点：

• 确认ruby-debug-ide和debase已正确安装。
• 确保launch.json中的路径无拼写错误。
• 关闭其他可能占用调试端口的进程。
• 在集成终端中运行which ruby，确认VSCode使用的Ruby与gem安装环境一致。

基本上就这些。环境搭好后，写Ruby代码就能获得良好的编辑体验和调试能力。