需安装Ruby、Rails、Ruby Solargraph三扩展并重启；配置.solargraph.yml与solargraph.autoStart；启用rails.enableRouteHighlighting；安装ruby-debug-ide与debase并配置launch.json；将.erb文件关联至Ruby (Rails)语言模式。
如果您正在使用 VSCode 开发 Ruby on Rails 应用，但发现语法高亮异常、调试无法启动或代码跳转失效，则可能是由于扩展配置缺失或语言服务未正确初始化。以下是针对该场景的适配性设置与调试支持方案：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装核心扩展组合
Ruby on Rails 开发依赖多个协同工作的扩展，单一插件无法覆盖语法解析、智能提示与调试全流程。需按功能角色分别启用对应组件。
1、打开 VSCode 扩展市场（快捷键 Cmd+Shift+X）。
2、依次搜索并安装以下三个扩展：Ruby（由 castwide 提供）、Rails（由 bung87 提供）、Ruby Solargraph（由 castwide 提供）。
3、安装完成后，重启 VSCode 使语言服务器完全加载。
二、配置 Solargraph 语言服务器
Solargraph 是 Ruby 的标准语言服务器，负责提供跳转、补全与文档悬停能力。默认配置可能未识别 Rails 框架路径，需手动指定项目上下文。
1、在项目根目录下执行命令：bundle exec solargraph bundle。
2、创建 .solargraph.yml 文件，内容包含 require: ["./config/environment"] 行。
3、在 VSCode 设置中搜索 solargraph.autoStart，确保其值为 true。
三、启用 Rails 特定语法支持
Rails 使用大量动态方法（如 ActiveRecord 查询链、helper 调用），原生 Ruby 扩展无法推断其签名。Rails 扩展通过静态分析补全控制器、视图与路由关联。
1、确认项目中存在 config/routes.rb 文件且格式合法。
2、在 VSCode 设置中启用 rails.enableRouteHighlighting 选项。
3、右键点击任意 link_to 或 form_with 调用，选择 Go to Definition 验证是否跳转至对应 controller 动作。
四、配置调试环境
VSCode 默认不内置 Ruby 调试器，需借助 ruby-debug 与 launch.json 显式声明运行参数，否则断点将被忽略。
1、在终端中执行：gem install ruby-debug-ide debase。
2、在项目根目录创建 .vscode/launch.json，填入包含 type: "Ruby" 和 pathToRDebugIDE 字段的配置块。
3、在 config/environments/development.rb 中添加 config.cache_classes = false 以确保热重载生效。
五、修复 ERB 模板高亮失效
VSCode 对 .html.erb 文件默认采用 HTML 语法引擎，导致 Ruby 代码段无着色或错误标记。需强制绑定 Ruby 语法定义。
1、按下 Cmd+Shift+P 打开命令面板，输入 Change Language Mode 并回车。
2、在弹出框中选择 Ruby (Rails)（非纯 Ruby）。
3、点击右下角语言标识旁的齿轮图标，选择 Configure File Association for '.erb'，将其永久映射至 Ruby (Rails)。
