vscode ruby开发需分步安装扩展与gem：先装rebornix.ruby和castwide.solargraph，再装gem solargraph、debase、ruby-debug-ide；rails项目须额外装bung87.rails并运行bundle exec solargraph bundle初始化索引。
VSCode 里 Ruby 扩展不能只装一个，Gem 包管理与语法高亮必须分开处理——装错顺序或漏掉关键 gem，solargraph 补全会失效，ruby-debug-ide 会直接报错退出。
安装 Ruby 基础扩展（不是“Ruby”那个模糊名字）
VSCode 扩展市场搜 Ruby 会出现多个同名扩展，真正起作用的是由 rebornix 或 castwide 发布的版本。前者轻量，后者常和 Solargraph 捆绑更稳。
- 关闭所有 VSCode 窗口，避免插件加载冲突
- 打开扩展面板（
Ctrl+Shift+X），搜rebornix.Ruby，点安装 → “重新加载” - 再搜
castwide.solargraph，安装后不重启，先别急着开 .rb 文件 - 如果用 Rails，额外装
bung87.rails，它能识别routes.rb和link_to跳转
必须手动安装的三个核心 gem
VSCode 插件只是壳，底层能力全靠 gem 提供。跳过这步，Solargraph 启动失败、调试器连不上、Rubocop 格式化报错都是常态。
-
gem install solargraph：语言服务器本体，没它就没有补全和悬停文档 -
gem install debase ruby-debug-ide：调试器依赖，ruby-debug-ide必须 ≥ 1.8.0，老版本不兼容 Ruby 3.2+ -
gem install rubocop：格式化和 lint 支持，装完还要在 VSCode 设置里配"ruby.format": "rubocop"
注意：solargraph 和 ruby-debug-ide 都要装在当前 shell 使用的 Ruby 环境下。用 rbenv 或 RVM 的人，务必先 rbenv shell 3.2.2 再装，否则 VSCode 找不到。
语法高亮失效？检查文件关联和 interpreterPath
新建 test.rb 还是显示为纯文本，大概率不是插件问题，而是 VSCode 没把文件当 Ruby 解析。
- 右下角点击语言模式（显示“Plain Text”或“Ruby”），选“Configure File Association for '.rb'” → 选
Ruby - 打开设置（
Ctrl+,），搜ruby.interpreterPath，填入which ruby输出的绝对路径，比如/Users/you/.rbenv/versions/3.2.2/bin/ruby - 如果用
rbenv，还得在 settings.json 加一行："ruby.interpreter.command": "rbenv exec ruby"，不然插件调用时会找不到 bundle 上下文
调试启动就报错“Cannot find module 'debase'”
这不是 Node.js 报错，是 VSCode Ruby 调试器在找本地 gem 时失败了。常见于多版本 Ruby 共存场景。
- 终端执行
ruby -e "puts $:"，确认输出里包含debase所在的 gems 路径 - 检查
.vscode/launch.json中是否漏了"pathToRDebugIDE"字段（新版fxa90111.ruby-debug强制要求） - 删掉
~/.vscode/extensions/fxa90111.ruby-debug-*下旧版缓存，重装扩展
最易被忽略的一点：solargraph 在 Rails 项目里必须运行 bundle exec solargraph bundle 初始化索引，否则模型方法、控制器动作全标红，但错误信息只在 Output 面板的 Solargraph 日志里闪一下。
