高效 Rails 开发需配置五大环节：一、安装 Ruby、Rails、Solargraph 和 Debugger 扩展并重启；二、执行 solargraph bundle、配置 .solargraph.yml 并启用 autoStart；三、分组终端并运行 dev、db:migrate、rspec 与日志监控；四、绑定 cmd+r cmd+g 与 cmd+r cmd+r 快捷键；五、安装 RSpec 相关扩展并配置 testExplorer 与测试命令。

如果您正在使用 VSCode 进行 Ruby on Rails 开发，但尚未配置关键扩展与自动化工具，则可能面临代码补全不准确、调试流程繁琐、终端切换频繁等问题。以下是构建高效开发工作流的具体操作步骤：

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

一、安装核心扩展

Ruby on Rails 开发依赖语言支持、语法高亮、智能提示与调试能力，需通过扩展补足 VSCode 原生缺失的功能。

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

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

3、安装完成后，重启 VSCode 使 Solargraph 服务自动初始化。

二、配置 Solargraph 语言服务器

Solargraph 提供代码跳转、参数提示、文档内联显示等 LSP 功能，需确保其能正确识别 Rails 项目结构和 gem 依赖。

1、在项目根目录下执行命令：bundle exec solargraph bundle。

2、创建 .solargraph.yml 文件，内容包含：include: - "**/*.rb" 与 require: - railties - actionpack。

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

三、设置多终端快捷工作区

Rails 开发常需并行运行开发服务器、数据库迁移、测试套件及日志监控，内置终端分组可减少窗口切换成本。

1、按下 Cmd+Shift+P 打开命令面板，输入并选择 Terminal: Create New Terminal。

2、右键终端标签页，选择 Split Terminal，重复操作建立四个标签页。

3、依次在各标签页中执行：bin/dev、bin/rails db:migrate、bin/rspec --fail-fast、tail -f log/development.log。

四、启用 Rails 特定快捷键绑定

VSCode 默认未映射 Rails 常用命令，可通过键盘快捷方式快速触发生成器、路由查看与日志过滤等高频操作。

1、按下 Cmd+Shift+P，输入 Preferences: Open Keyboard Shortcuts (JSON)。

2、在右侧用户快捷键 JSON 中添加条目：{"key": "cmd+r cmd+g", "command": "workbench.action.terminal.sendSequence", "args": {"text": "bin/rails g\015"}}。

3、再添加一条：{"key": "cmd+r cmd+r", "command": "workbench.action.terminal.sendSequence", "args": {"text": "bin/rails routes | grep -E 'collection|member'\015"}}。

五、配置 RSpec 测试集成

将 RSpec 测试结果直接嵌入编辑器侧边栏，避免手动读取终端输出，提升 TDD 效率。

1、安装扩展 RSpec Snippets 与 Test Explorer UI。

2、在项目根目录创建 .vscode/settings.json，写入："testExplorer.grouping": ["file", "suite"] 与 "ruby.testSimpleCommand": "bundle exec rspec --format json --out /tmp/rspec.json"。

3、点击左侧活动栏测试图标，点击刷新按钮，测试套件将自动加载并支持单击运行。