vscode不管理ruby环境，必须通过终端执行code .启动以继承rbenv/rvm上下文；否则gem_home等变量丢失导致“could not find gem”；debug断点进不了app/models主因是rails 7+ zeitwerk autoload干扰，需设config.autoloader = :classic并执行bin/rails tmp:clear，同时launch.json中type为ruby、request为launch、program为${workspacefolder}/bin/rails、args为["server", "-p", "3000"]，且gemfile中仅用gem "debug"。
VSCode本身不管理Ruby环境，所有Gem加载和断点行为都取决于你终端启动时的上下文——直接双击图标打开VSCode，bundle exec会失效、debug gem找不到、断点进不了app/models，全是这个原因。
为什么bundle install成功但VSCode里rails server报“Could not find gem”
根本不是Gemfile写错了，而是VSCode没继承rbenv/rvm的shell环境。双击图标启动时，GEM_HOME、GEM_PATH、PATH全为空，它调用的是系统Ruby（比如/usr/bin/ruby），而你的gem全装在~/.rbenv/versions/3.2.2/lib/ruby/gems/3.2.0里。
- 必须在已激活rbenv/rvm的终端中执行
code .（不是open -a "Visual Studio Code" .） - 进VSCode集成终端，运行
which ruby，输出应含.rbenv/或.rvm/；再跑bundle exec ruby -e "puts 'ok'"验证是否能走对gemset - 别在
.vscode/settings.json里硬写"ruby.interpreterPath"——这会让VSCode绕过shim，bundle exec行为彻底错乱
debug gem断点进不了app/models？先关掉zeitwerk
Rails 7+默认用zeitwerk autoload，但它对调试器不友好：缓存不刷新、路径识别延迟、断点跳转错乱。你加了binding.break却停在空白行，大概率是它在捣鬼。
- 在
config/environments/development.rb里强制切回经典模式：config.autoloader = :classic - 改完立刻在终端执行
bin/rails tmp:clear——zeitwerk缓存不清理，重启VSCode也没用 - 如果仍不生效，在
launch.json的env字段加"RUBY_DEBUG_NO_RAILS": "1"临时禁用Rails集成，能进模型说明就是autoload干扰
launch.json怎么配才让rdbg真正跑起来
旧式ruby-debug-ide在Ruby 3.1+上已崩溃，debug gem才是唯一可靠选择。但VSCode配置稍有偏差，就会卡在“Starting debugger…”不动。
-
Gemfile里加gem "debug", group: :development, require: false，然后bundle install -
launch.json里type必须是ruby，request必须是launch（不是attach），program设为${workspaceFolder}/bin/rails，args填["server", "-p", "3000"] - 删掉所有
ruby-debug-ide、debase、byebug相关字段——它们和debug冲突，会导致进程挂起或断点灰掉 - 验证
debug是否可用：bundle exec ruby -e "require 'debug'; binding.break"，能停住就说明gem和环境都没问题
最常被忽略的其实是tmp:clear和code .这两步——前者清缓存，后者保环境，缺一不可。很多人反复重装插件、改launch.json，却漏掉这两个动作，结果调半天还是进不了断点。
