必须用rbenv或RVM管理Ruby版本，VSCode不自带版本管理；推荐rbenv（macOS/Linux）或msys2+rbenv（Windows）；仅保留ruby-rubocop、rebornix.ruby、wingrunr21.vscode-ruby三个扩展；调试需用ruby-debug gem与rdebug-ide；PATH问题需确保VSCode终端加载rbenv init。
Ruby版本管理必须用rbenv或RVM，不能只靠系统Ruby
VSCode本身不管理Ruby版本，它只是调用你终端里能跑起来的ruby和bundle。如果你用的是macOS自带Ruby或Linux系统Ruby，大概率会遇到permission denied、gem install fails，或者bundle exec行为不一致——因为系统Ruby被锁死了写权限，且没配好GEM_HOME。
实操建议：
- macOS / Linux：装
rbenv（轻量）或RVM（功能全），然后用rbenv install 3.2.2、rbenv local 3.2.2设项目级版本 - Windows：用
msys2+rbenv，别用RubyInstaller附带的Shell，VSCode集成终端认不全它的环境变量 - 确认生效：在VSCode集成终端里运行
which ruby，输出路径应含~/.rbenv/或~/.rvm/，不是/usr/bin/ruby
VSCode扩展只留ruby-rubocop、rebornix.ruby、wingrunr21.vscode-ruby三个
VSCode里搜“ruby”出来二十多个扩展，但多数已弃更或互相冲突。比如旧版rebornix.ruby（红宝石图标那个）自带语言服务，新版wingrunr21.vscode-ruby（蓝宝石图标）才支持Ruby 3+的RBS和类型推导；而ruby-rubocop负责实时检查，缺了它就等于没语法高亮+错误提示。
实操建议：
- 卸载所有其他Ruby相关扩展，尤其
rails、ruby-solargraph（Solargraph已停更）、ruby-test（功能被rspec插件替代） - 在
settings.json里显式启用语言服务器："ruby.intellisense": "rubyLocate"（不是solargraph） - 如果用Rails，额外装
shawncarter.rails-run-specs，它能直接点行号跑单个it块，比手动敲rspec spec/models/user_spec.rb:24快得多
调试时Debugger for Ruby必须配合ruby-debug gem，不是byebug
VSCode默认调试配置用的是byebug，但它不兼容Ruby 3.1+，一启动就报undefined method `debugger'。真正能用的是ruby-debug（注意不是debug，那是Rails 7.1+内置的，VSCode不认）。
实操建议：
- 在Gemfile里加：
gem 'ruby-debug', require: false，然后bundle install - 调试配置
.vscode/launch.json中configuration字段必须设"type": "Ruby"，且"pathToRDebugIDE"指向bundle exec rdebug-ide（不是rdebug） - 断点只在
require之后的文件里生效——比如app/controllers/users_controller.rb可以，但config/application.rb不行，因为rdebug-ide还没加载完Rails环境
Bundle exec问题本质是PATH和shell初始化不一致
你在终端里bundle exec rails s能跑，但VSCode里按F5就报command not found: rails，这不是插件问题，是VSCode集成终端没读取你的~/.zshrc或~/.bash_profile里的rbenv init段，导致bundle命令根本没进PATH。
实操建议：
- Mac用户：在
~/.zshenv（不是zshrc）里放export PATH="$HOME/.rbenv/bin:$PATH"，再加eval "$(rbenv init - zsh)" - Linux用户：确保
~/.profile里有rbenv init，并确认VSCode是用login shell启动终端（设置里开"terminal.integrated.shellArgs.linux": ["-l"]） - 验证方法：VSCode终端里运行
echo $PATH，看有没有~/.rbenv/shims；再跑which bundle，必须返回~/.rbenv/shims/bundle
最常被忽略的一点：rbenv的shims机制依赖shell函数拦截命令，而VSCode终端有时会跳过shell初始化脚本——这时候哪怕rbenv装得再对，bundle也变不回可执行文件。别硬调，先查which bundle输出。
