VSCode配置Ruby on Rails框架开发调试环境搭建指南【详细】-VSCode-PHP中文网

vscode调试ruby需正确启动并配置环境：必须在终端执行code .，确保rbenv/shims生效；rails 7+需切classic autoloader并清缓存；仅fxn.vscode-ruby-debug+debug gem组合稳定；solargraph须bundle exec索引且加载rails上下文。

vscode配置ruby on rails框架开发调试环境搭建指南【详细】

VSCode 本身不管理 Ruby 环境，所有“找不到 gem”“断点不进 model”“跳转不到 link_to”的问题，90% 都源于启动方式或 autoload 配置错误——不是插件没装对，而是环境根本没加载进来。

code . 必须在终端里执行，否则 Ruby 环境全丢

双击图标或用 open -a 启动 VSCode，它不会读 ~/.zshrc 或 ~/.rbenv/shims，GEM_HOME、GEM_PATH、PATH 全部失效。结果就是：bundle install 成功，rails server 却报 Could not find gem。

永远在项目根目录终端运行 code .（不是 open -a "Visual Studio Code" .）
打开后立刻在 VSCode 集成终端里执行 echo $SHELL 和 which ruby，结果必须和你在外部终端里敲的一致
别在 .vscode/settings.json 里硬写 "ruby.interpreterPath" 指向 ~/.rbenv/versions/3.2.2/bin/ruby——这会绕过 rbenv shim，bundle exec 行为异常

Rails 7+ 调试前必须切 classic autoloader 并清缓存

Rails 7 默认用 :zeitwerk，但 debug gem 对它的路径监听不稳定，断点常跳到错误文件、卡在 controller 不进 model。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

在 config/environments/development.rb 中加一行：config.autoloader = :classic
改完立刻在终端执行 bin/rails tmp:clear，否则 zeitwerk 缓存还在生效
如果仍不进 app/models，在 launch.json 的 env 字段加 "RUBY_DEBUG_NO_RAILS": "1"，临时禁用 Rails 集成验证是否是 autoload 干扰

调试器只认 fxn.vscode-ruby-debug + debug gem

rebornix.Ruby 插件已停更，misogi.ruby-debug-ide 在 Ruby 3.1+ 上崩溃率高。目前唯一稳定组合是 fxn.vscode-ruby-debug 插件配合 debug gem。

Gemfile 里加：gem "debug", group: :development, require: false，然后 bundle install
删干净所有 binding.pry、byebug、pry-byebug——它们跟 debug 冲突，会导致断点卡死或进程假死
launch.json 中 type 必须是 "ruby"，request 是 "launch"，program 设为 "${workspaceFolder}/bin/rails"，args 填 ["server", "-p", "3000"]

Solargraph 补全失效？它根本没读你的 Gemfile.lock

Solargraph 不解析 Gemfile.lock 就不知道你用了哪些 gems，form_with、belongs_to 这类动态方法就无法补全或跳转。

必须在项目根目录运行 bundle exec solargraph bundle（不是 solargraph bundle）
.vscode/settings.json 中确保有 "solargraph.useBundler": true
在 .solargraph.yml 里显式 require: ["./config/environment"]，让 Solargraph 加载 Rails 初始化上下文
ERB 文件默认当 HTML 解析，得加配置："files.associations": {"*.html.erb": "erb"}