vs code 是轻量高效的 ruby on Rails 开发编辑器,关键在于搭配 Solargraph 或 Ruby lsp 实现补全、跳转、调试,辅以 Rails Runner、go To Spec 等插件提升效率,并通过终端标签、格式化、调试配置完成全流程开发。

VS Code 是 Ruby on Rails 开发中轻量又高效的编辑器选择,配合合适的插件和配置,体验不输专用 ide。关键在于补全、跳转、调试和终端集成要顺手。
Ruby 语言支持核心插件
基础语法高亮、格式化和智能提示离不开这几个插件:
- Ruby(rebornix.ruby):提供基础语法支持、括号匹配、简单代码片段,但已停止维护;建议搭配 Ruby Solargraph 使用
- Solargraph(castwide.solargraph):目前最稳定的 Ruby 语言服务器,支持跳转定义(Ctrl+Click)、查看类型、自动补全、文档提示;需项目根目录运行
solargraph bundle或bundle exec solargraph bundle初始化 - Ruby LSP(matt-bowler.ruby-lsp):较新、更现代的替代方案,基于 ruby-lsp gem,对 Rails 方法推导更准,支持重命名、重构等;需在项目中
bundle add ruby-lsp --group development并启用插件
Rails 专项增强插件
让 VS Code 理解 Rails 约定,提升开发效率:
- Rails Runner(bung87.rails-runner):右键快速运行
rails runner脚本,适合调试模型逻辑 - Rails Go To Spec(michael-moore.rails-go-to-spec):在控制器/模型上按
Cmd+Shift+P→ “Go to spec” 快速跳转对应测试文件(需 RSpec 结构规范) - ERB Helper(nokomarov.erb-helper):在 .erb 文件中提供 html 标签闭合、缩进、
快捷包裹等功能 - ESLint + RuboCop 集成:通过 Ruby Solargraph 或 Ruby LSP 可直接对接
rubocop,开启保存时自动修复(需项目含 .rubocop.yml)
实用配置与技巧
几项关键设置能让日常操作更顺滑:
- 在
settings.json中启用“保存时格式化”:"editor.formatOnSave": true,并指定 Ruby 格式化工具为 Solargraph 或 ruby-lsp - 把 Rails 服务器日志输出到 VS Code 内置终端:用
rails s -p 3001启动,再开一个终端执行tail -f log/development.log,便于实时观察请求和 sql - 用 Terminal Tabs(VS Code 内置)分标签管理:server / console / db:migrate / test —— 按
Cmd+Shift+5快速切换 - 自定义快捷键:例如绑定
Cmd+R Cmd+T到命令rails:test:run(需插件 Rails Run Specs),一键运行当前测试文件
调试 Rails 应用(无需 RubyMine)
VS Code 原生支持 Ruby 调试,只需几步:
- 安装插件 Ruby(orionsoft.ruby-debug)或 Ruby Debug(wingrunr21.vscode-ruby)
- 在 Gemfile 中添加
gem 'ruby-debug', group: :development(Ruby 3.1+ 推荐debuggem) - 运行
bundle install,然后在 launch.json 中配置调试环境:选择 “Rails Server” 模板,指定program为bin/rails,args为["server"] - 在 controller 或 model 中打上断点(红点),按
F5启动调试,支持变量查看、步进、控制台求值
基本上就这些。不需要堆砌插件,选好语言服务 + Rails 辅助 + 一两个调试工具,再配上顺手的终端习惯,VS Code 就能稳稳撑起 Rails 全流程开发。