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 扩展

这些扩展不是可有可无，而是解决编码效率、跳转、语法提示等实际问题的核心：

• 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 关联、跑测试，都挺顺。