vscode是 ruby on Rails 开发者轻量高效的选择，关键在于装对扩展（Ruby、Rails、ESLint+Prettier、gitLens）、配置终端环境对齐、用 ruby-debug 调试、通过设置优化 Rails 跳转。
VSCode 是 Ruby on Rails 开发者轻量高效的选择，关键在于装对扩展、配好环境、避开常见陷阱。不是所有插件都必要，也不是默认设置就适合 Rails 项目。
必备扩展：少而精
只装真正提升效率的几个核心扩展，避免拖慢编辑器：
- Ruby（rebornix.ruby）：语法高亮、基础跳转、简单补全，保持轻量；注意关闭它自带的 linter 和 debugger，交给专用 工具
- Rails（bung87.rails）：识别 Rails 特有结构（如 controller/action 跳转、view 到对应 controller、routes.rb 导航），对日常开发帮助明显
- ESLint + Prettier（仅当项目含 js/TS）：Rails 7+ 默认用 esbuild 或 importmap，JS 代码仍需格式统一
- GitLens（非必须但强烈推荐）：快速看某行是谁改的、何时改的，查 bug 或交接时省大量时间
终端与运行环境对齐
VSCode 内置终端默认可能不加载你的 shell 配置（如 ~/.zshrc），导致 bundle、rails 命令找不到或版本错乱：
- 在 VSCode 设置里搜 terminal integrated default profile，选你日常用的 shell（如 zsh）
- 确保勾选 terminal.integrated.inheritEnv（默认开启，但有时被关掉）
- 打开新终端后，运行 which rails 和 ruby -v，确认路径和版本与你在系统终端中一致
调试 Rails 应用（无需 Ruby extension 自带 debugger）
用 ruby-debug（官方维护，替代已废弃的 ruby-debug-ide）更稳定：
- 在 Gemfile 的 :development, :test 组添加：gem “ruby-debug”, require: false
- 运行 bundle install，再执行 bin/rails server –debug
- VSCode 中按 Ctrl+Shift+D → 点左上角齿轮图标 → 选择 Ruby 模板 → 保存配置
- 设断点后按 F5 启动调试，支持变量查看、步进、条件断点
让文件跳转更“懂 Rails”
Rails 约定优于配置，但 VSCode 默认不理解这些约定。手动加一点提示就能大幅改善：
- 在项目根目录创建 .vscode/settings.json，加入：
“ruby.intellisense”: “ruby-solargraph”（如果用了 solargraph）
或更轻量的：
“files.associations”: {“*.rb”: “ruby”} - 对常用跳转（如 view → controller），确保 Rails 扩展已启用，并重启 VSCode
- 遇到跳转失效？先检查文件名是否符合 Rails 命名（如 users_controller.rb，不是 user_controller.rb）
基本上就这些。不用 堆插件，不碰复杂配置，把 Ruby、Rails、终端、调试四块理顺，VSCode 就能稳稳跑 Rails 项目。
