VSCode中Ruby开发需安装rebornix.Ruby扩展实现语法高亮，fxa90111.ruby-debug扩展支持断点调试，castwide.solargraph扩展提供智能补全，还需手动配置ruby.interpreterPath指定Ruby路径。
如果您在 Visual Studio Code 中进行 Ruby 开发，但无法获得语法高亮、代码补全或断点调试支持，则可能是 Ruby 插件未正确安装或配置。以下是实现 Ruby 开发与调试功能的多种方法：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装 Ruby 官方扩展（rebornix.Ruby）
该扩展由社区维护，提供基础语言支持，包括语法高亮、括号匹配、简单跳转和片段补全，适用于轻量级 Ruby 项目开发。
1、打开 VSCode，点击左侧活动栏的扩展图标（或按 Cmd+Shift+X）。
2、在搜索框中输入 rebornix.Ruby，找到作者为 rebornix 的扩展。
3、点击“安装”按钮，安装完成后点击“重新加载”使插件生效。
4、重启 VSCode，新建 .rb 文件，确认语法高亮已启用。
二、配置 Ruby Debug 扩展（fxa90111.ruby-debug）
该扩展基于 ruby-debug-ide 和 debase，支持断点、变量查看、调用栈跟踪等完整调试能力，需配合本地 Ruby 环境使用。
1、确保系统已安装 Ruby 3.0 或更高版本，并通过终端执行 ruby -v 验证。
2、在终端中运行 gem install debase ruby-debug-ide 安装调试依赖。
3、在 VSCode 中安装扩展 fxa90111.ruby-debug。
4、在项目根目录创建 .vscode/launch.json，添加 Ruby 调试配置，其中 program 字段需指向主执行文件路径。
三、启用 Solargraph 语言服务器
Solargraph 提供语义分析、智能补全、文档提示与重构支持，依赖本地 gem，适合中大型 Ruby 项目。
1、终端执行 gem install solargraph 安装语言服务器。
2、在 VSCode 中安装扩展 castwide.solargraph。
3、打开 VSCode 设置（Cmd+,），搜索 solargraph.autoInstall，勾选以启用自动初始化。
4、在项目根目录运行 solargraph bundle，生成项目专属类型索引。
四、手动配置 Ruby 解释器路径
当 VSCode 无法自动识别 Ruby 可执行路径时，需显式指定 interpreterPath，否则调试与 linting 将失败。
1、终端执行 which ruby 获取当前 Ruby 可执行文件绝对路径。
2、在 VSCode 设置中搜索 ruby.interpreterPath。
3、点击“编辑 in settings.json”，在用户或工作区设置中添加键值对："ruby.interpreterPath": "/opt/homebrew/bin/ruby"（路径需替换为上一步结果）。
4、保存文件后，重启 VSCode 窗口（Cmd+Shift+P → Developer: Reload Window）。
