VSCode搭配Ruby on Rails开发可获近似IDE体验，关键在正确安装Ruby/Rails环境、必备扩展（Ruby、Solargraph、Rails）、配置终端与调试支持，并优化小细节如禁用Prettier对.rb文件格式化。
VSCode 搭配 Ruby on Rails 做开发很顺手，关键在于装对扩展、配好终端和调试支持，不用重装系统或换编辑器也能获得接近专用 IDE 的体验。
Ruby 和 Rails 环境先跑通
VSCode 本身不运行 Ruby，它只是编辑器。所以第一步必须确保系统级 Ruby + Rails 能正常工作：
- 推荐用 rbenv 或 chruby 管理 Ruby 版本（避免用系统自带 Ruby）
- 运行 ruby -v、rails -v、bundle -v 都有合理输出
- 新建一个测试项目：rails new demo && cd demo && bin/rails server，能成功访问 http://localhost:3000 再继续配置 VSCode
必装的 VSCode 扩展
这些扩展不是可有可无，而是解决编码效率、跳转、语法提示等实际问题的核心：
Conventional Git
下载
Conventional Commits v1.0.0 分支、工作树命名及提交信息规范，适用于 GitHub 与 GitLab 项目，用于创建分支和命名工作树等场景。
- Ruby（rebornix.ruby）：提供基础语法高亮、括号匹配、简单补全
- Ruby Solargraph（castwide.solargraph）：启用智能感知（go to definition / find references）、参数提示、文档悬浮 —— 需在项目根目录运行 solargraph bundle 初始化
- Rails（bung87.rails）：识别 Rails 特有结构（如 controller helper view 自动跳转、routes.rb 补全）
- ESLint 或 Stylelint（如果项目含 JS/CSS）：搭配 Ruby on Rails 扩展可联动检测 assets 目录下的前端代码
- 可选但推荐：GitLens 查看行级提交历史，TODO Tree 快速定位 # TODO 注释
让终端和调试更贴合 Rails 习惯
VSCode 内置终端默认是系统 shell，但 Rails 开发常需快速启动 server/console/dbconsole，可以这样优化：
- 在 .vscode/settings.json 中设置默认终端为 zsh 或 bash（如果你用的是其他 shell）
- 用 Tasks 定义常用命令：比如一键运行 bin/rails server 或 bin/rails console，绑定快捷键 Ctrl+Shift+P → Tasks: Run Task
- 调试支持靠 Ruby Debug 扩展（fxruby.ruby-debug），需安装 gem debug（Rails 7.1+ 默认已含），然后配置 .vscode/launch.json 启动 server 或跑测试
小而实用的配置技巧
几个容易忽略但明显提升体验的细节：
- 关闭自动保存时的格式化冲突：Ruby 扩展和 Prettier 可能打架，建议禁用 Prettier 对 *.rb 文件的格式化
- 在 settings.json 加上："files.exclude": {"**/tmp/**": true, "**/log/**": true}，让侧边栏更清爽
- 用 Remote - SSH 或 Dev Containers 连远程服务器或 Docker 环境时，确保 solargraph 和 debug gem 在远程环境也已安装
基本上就这些。不复杂但容易忽略的是：Ruby 环境是否干净、Solargraph 是否重新索引、以及调试前有没有在 Gemfile 里确认 gem "debug" 存在且未被 group 限制。配好之后，写 controller、查 model 关联、跑测试，都挺顺。
