VSCode 可运行 Rails 全栈开发,但需正确配置:先装 Ruby 扩展(如 misaka-10086),再装 Solargraph(castwide)启用 Bundler 支持,最后装 Rails 扩展(bung87);.html.erb 文件需在 settings.json 中映射为 "erb" 类型;调试需安装 ruby-debug-ide 和 debase,配置 launch.json 并禁用 Bootsnap;Ruby 环境路径须通过 ruby.interpreterPath 设置或终端启动 code . 解决。

VSCode 能跑 Rails 全栈开发,但默认配置下几乎什么都不能用——跳转失效、补全乱码、断点不触发、ERB 里 Ruby 代码没高亮,全是环境没对齐的典型症状。
必须装的三个核心扩展:Ruby + Solargraph + Rails
缺一不可,顺序不能错。先装 Ruby(推荐 misaka-10086 或 rebornix 版),它管基础语法和终端集成;再装 Solargraph(castwide),它是 LSP 后端,负责跳转定义、参数提示、文档悬停;最后装 Rails(bung87 或 hridoy),它解析 config/routes.rb 和控制器/视图关联,让 link_to 右键能跳到对应 action。
常见错误现象:
-
Rails扩展装了但右键form_with没反应 → 检查项目根目录是否有合法config/routes.rb,且 VSCode 已识别为 Rails 工作区(右下角应显示 “Rails”) -
Solargraph补全只出 Ruby 基础方法,没有belongs_to或scope→ 说明没走 Bundler 上下文,需确认solargraph.useBundler设为true,且已执行过solargraph bundle
ERB 模板 Ruby 代码不着色?改 files.associations
VSCode 默认把 .html.erb 当 HTML 处理, 里的 Ruby 完全不识别。这不是插件问题,是文件类型映射错了。
在工作区 .vscode/settings.json 中加这一行:
"files.associations": {"*.html.erb": "erb"}
然后重启窗口或重载窗口(Cmd+Shift+P → Developer: Reload Window)。别信“安装 ERB Helper 插件就能解决”——它只补全标签,不改语法引擎。
顺带一提:erb 语言模式依赖 Ruby 扩展提供底层支持,所以 Ruby 必须先启用。
调试断点不生效?ruby-debug-ide + launch.json 缺一不可
VSCode 的 Ruby 调试不是开箱即用的。你得手动装 gem、配启动器、关 Bootsnap 干扰。
实操步骤:
- 终端进项目根目录,运行:
gem install ruby-debug-ide debase - 创建
.vscode/launch.json,内容至少包含一个type: "Ruby"的配置,pathToRDebugIDE指向刚装的 gem(如~/.rbenv/shims/rdebug-ide) - 在
config/environments/development.rb加上:config.cache_classes = false - Rails 7.1+ 用户注意:
bootsnap会缓存常量导致断点跳过,临时禁用方法是在启动前设环境变量:DISABLE_BOOTSNAP=1
验证方式:在 app/controllers/application_controller.rb 第一行打个断点,F5 启动调试,访问任意页面——如果没停住,90% 是 pathToRDebugIDE 路径错了,或终端没加载 rbenv/asdf 的 shim。
容易被忽略的 Ruby 环境路径问题
VSCode 集成终端默认不读 shell 配置(比如 ~/.zshrc),导致 which ruby 返回系统 Ruby,bundle exec 报错找不到 gem。这不是插件问题,是 VSCode 启动方式决定的。
解决方法只有两个:
- 在 VSCode 设置里搜
ruby.interpreterPath,填入which ruby在外部终端输出的完整路径(如~/.rbenv/shims/ruby) - 或者从终端启动 VSCode:
code .,这样它会继承当前 shell 的 PATH 和 rbenv 环境
这个坑最隐蔽:所有功能看起来都正常,唯独 bundle exec rails console 在集成终端里报错,而你在外部终端敲完全一样命令却成功——本质就是两个 Ruby 环境在打架。











