需配置VSCode扩展、Solargraph服务器、Ruby解释器路径、Rails代码片段及集成终端别名。具体包括：安装Ruby/Rails/Solargraph/Debugger扩展；运行solargraph bundle；设置ruby.interpreterPath；创建rails.json代码片段；配置.vscode/settings.json终端预设。

如果您希望在 VSCode 中高效开发 Ruby on Rails 应用，需对编辑器进行针对性配置，以支持语法高亮、智能跳转、调试、代码格式化及终端集成等功能。以下是实现该目标的具体步骤：

本文运行环境：MacBook Pro，macOS Sequoia。

一、安装核心扩展

VSCode 本身不原生支持 Rails 开发，需通过扩展补全语言服务、调试器和框架感知能力。这些扩展共同构成 Rails 开发的基础支撑层。

1、打开 VSCode，点击左侧活动栏的扩展图标（或按 Cmd+Shift+X）。

2、在搜索框中依次输入并安装以下扩展：Ruby（by rebornix）、Rails（by hridoy）、Solargraph（by castwide）、Ruby Solargraph（by castwide）、Debugger for Ruby（by misogi）。

3、安装完成后，重启 VSCode 使扩展完全加载。

二、配置 Solargraph 语言服务器

Solargraph 提供代码补全、跳转定义、文档悬停等 LSP 功能，是 Rails 项目语义分析的核心组件。它需正确识别 Gemfile 和项目结构才能正常工作。

1、确保项目根目录下存在 Gemfile 且已执行 bundle install。

2、在项目根目录下运行命令：solargraph bundle，生成 .solargraph.yml 并索引本地 gems。

3、在 VSCode 设置中搜索 solargraph.autoStart，将其设为 true。

三、设置 Ruby 解释器路径

VSCode 需明确知道当前项目使用的 Ruby 版本及其 bin 路径，否则调试与终端命令可能调用系统默认 Ruby，导致 gem 加载失败或版本冲突。

1、在终端中进入 Rails 项目目录，执行 which ruby 获取当前 Ruby 可执行文件路径（如 ~/.rbenv/shims/ruby 或 ~/.asdf/shims/ruby）。

2、在 VSCode 中按下 Cmd+, 打开设置，搜索 ruby.interpreterPath。

3、将上一步获取的路径完整粘贴至该设置项中。

四、启用 Rails 专属代码片段与语法支持

Rails 框架具有大量约定式结构（如 controller/action、model/association、view/partial），专用代码片段可显著提升模板与逻辑编写速度。

1、打开命令面板（Cmd+Shift+P），输入并选择 Preferences: Configure User Snippets。

2、选择 New Snippets file for 'rails'，命名为 rails.json。

3、在打开的 JSON 文件中添加如下内容（以生成标准 controller action 为例）："def action": {"prefix": "defa","body": ["def ${1:action}"," ${0}","end"]}。

五、配置集成终端与 Rails 命令别名

频繁切换终端窗口执行 rails s、rails c、bin/rails db:migrate 等命令会打断编码流。通过 VSCode 内置终端预设别名，可一键触发常用任务。

1、在项目根目录创建文件 /.vscode/settings.json（若不存在则新建）。

2、写入以下内容：{"terminal.integrated.profiles.osx": {"Rails Dev": {"path": "zsh","args": ["-c", "cd ${workspaceFolder} && bin/rails server"]}}}。

3、重新打开集成终端，从下拉菜单选择 Rails Dev 即可直接启动 Rails 服务器。