需依次完成Ruby/Rails运行环境安装、VSCode Ruby插件配置、Rails专属插件启用、Solargraph智能补全集成及调试工作流配置，共五步。
如果您希望在本地开发 Ruby on Rails 应用，但尚未配置好 VSCode 的开发环境，则可能是由于 Ruby 运行时、Rails 框架及编辑器支持未协同就绪。以下是完成环境搭建并提升编码效率的具体操作步骤：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装 Ruby 和 Rails 运行环境
VSCode 本身不提供 Ruby 解释器或 Rails 命令，需先在系统中部署 Ruby 版本管理器与 Rails 框架，确保终端可执行 rails new、bundle install 等命令。
1、打开终端，运行 brew install rbenv ruby-build 安装版本管理工具。
2、执行 rbenv install 3.2.2 下载指定 Ruby 版本。
3、运行 rbenv global 3.2.2 设为全局默认版本。
4、输入 gem install rails 安装 Rails 框架。
二、配置 VSCode 核心 Ruby 支持插件
Ruby 扩展提供语法高亮、跳转定义、调试支持等基础能力，是后续所有高级功能的前提，必须优先启用并正确关联本地 Ruby 路径。
1、在 VSCode 扩展市场中搜索 Ruby，选择作者为 rebornix 的官方扩展并安装。
2、打开 VSCode 设置（Cmd+,），搜索 ruby.intellisense，将其值设为 ruby。
3、在设置中查找 ruby.useLanguageServer，勾选启用。
4、点击左下角齿轮图标 → Command Palette → 输入 Ruby: Select Ruby Interpreter，从列表中选择 ~/.rbenv/versions/3.2.2/bin/ruby。
三、启用 Rails 专属语法与导航插件
Rails 插件弥补了标准 Ruby 扩展对 Rails 特有结构（如 routes.rb、app/models、config/environments）的识别盲区，实现控制器到视图、模型到迁移的双向跳转。
1、安装扩展 Rails Runner（作者：bung87）。
2、安装扩展 Rails Extensions（作者：shanebdavis）。
3、重启 VSCode，打开一个 Rails 项目根目录，确认状态栏右下角显示 Rails: Enabled。
4、在 app/controllers/application_controller.rb 中按住 Cmd 键并点击 ApplicationController，验证是否可跳转至其父类定义。
四、集成高效代码补全与重构工具
Solargraph 提供基于语言服务器协议（LSP）的智能补全，能解析 gems、routes 和自定义方法签名，显著减少手动输入与拼写错误。
1、终端中执行 gem install solargraph 安装服务端。
2、在 VSCode 扩展中安装 Solargraph（作者：castwide）。
3、打开项目文件夹后，在命令面板中运行 Solargraph: Restart Server。
4、在 config/routes.rb 中输入 get，观察是否自动提示 get 'path', to: 'controller#action' 模板。
五、配置调试与终端一体化工作流
通过内置终端与调试器联动，可在不切换窗口的情况下启动 Rails 服务器、运行测试并查看断点响应，避免上下文丢失。
1、安装扩展 Ruby Debug（作者：wingrunr21）。
2、在项目根目录创建 .vscode/launch.json，粘贴官方推荐的 Rails 调试配置模板。
3、在 app/controllers/posts_controller.rb 第一行设置断点，按 Ctrl+Shift+D 切换到调试视图。
4、点击绿色三角形启动调试，访问 http://localhost:3000/posts 触发断点停驻。
