Sublime Text 支持 Ruby 开发需手动完成三件事：绑定.rb文件语法实现高亮缩进、配置Build System使Ctrl+B能调用系统ruby、设置file_regex确保错误行双击可跳转；其他插件均为补充。
Sublime Text 本身不自动识别 Ruby 文件、不加载你的 shell 环境、也不自带 Ruby 运行能力——所谓“支持 Ruby 特性”，就是手动把这三件事拧紧：让 .rb 文件高亮缩进、让 Ctrl+B 能调到你装的 ruby、让错误能双击跳转。其他插件都是锦上添花，不是前提。
为什么 .rb 文件打开还是 Plain Text？必须手动绑定语法
这不是插件没装好，是 Sublime 默认不把 .rb 当 Ruby 处理。首次打开时右下角显示 “Plain Text”，就说明语法没绑定。
- 点右下角语言名（如
Plain Text）→ 选Ruby - 再点右侧出现的
Open all with current extension as…→ 确认，之后所有.rb文件都会自动高亮、缩进、匹配括号 - 如果用
.ru、.rake或.erb，也要同样操作：View → Syntax → Open all with current extension as…，单独绑定 -
.erb推荐设为HTML (Rails)，不是原生HTML；.slim或.haml需额外装对应插件并重启 Sublime 才生效
Ctrl+B 报 command not found: ruby？验证并修复 PATH 可见性
终端里 ruby -v 正常，但 Sublime 报错，说明 GUI 启动进程根本没读你的 ~/.zshrc 或系统 PATH。别猜，直接看它实际用的路径：
- 按
Ctrl+`打开控制台，输入：import os; print(os.environ.get('PATH')) - 检查输出里有没有 Ruby 路径：macOS Apple Silicon 是
/opt/homebrew/bin或/Users/xxx/.rbenv/shims；Windows 是类似C:Ruby32-x64in - 如果没有，Mac 用户改
~/.zprofile（不是~/.zshrc），加export PATH="/opt/homebrew/bin:$PATH"；Windows 用户确认该路径已加入「系统环境变量」PATH（不是用户变量） - 改完必须完全退出 Sublime 再重开，否则不生效
Build System 怎么写才真正可用？别裸写 "ruby $file"
裸写 "shell_cmd": "ruby $file" 在 GUI 下基本必挂。关键是要让 shell 初始化逻辑跑起来，或路径写死：
- macOS/Linux（zsh 用户）：
"shell_cmd": "zsh -l -c 'ruby "$file"'"——-l触发登录态，自动 source~/.zshrc，rbenv/rvm都能识别 - macOS/Linux（bash 用户）：
"shell_cmd": "bash -l -c 'ruby "$file"'" - Windows：
"cmd": ["C:\Ruby32-x64\bin\ruby.exe", "$file"]—— 反斜杠必须双写，路径不能含空格（C:Program Files会静默失败） - 用
rbenv且想保持版本灵活："shell_cmd": "/Users/xxx/.rbenv/shims/ruby "$file""—— 写绝对路径，~不会被解析 - 配置文件保存为
Ruby.sublime-build，放在Packages/User/目录下
错误行双击跳不进去？file_regex 必须匹配 Ruby 实际输出
Ruby 错误标准格式是 test.rb:5:in `foo': undefined method `bar' (NoMethodError)。如果 file_regex 不匹配，双击就无效，只能手动翻行号。
- 最稳的正则：
"file_regex": "^([^:]*?):([0-9]+):(?:[0-9]+)?:?.*" - 别漏掉这个字段，否则构建失败后定位全靠肉眼搜
:数字: - 注意：JSON 中正则里的反斜杠要转义，比如
\，但上面这个写法已适配大多数情况 - 如果用了
rubocop或rspec等工具做 lint/test，它们的输出格式不同，需要单独配file_regex，不能复用 Ruby 构建系统的那个
最容易被忽略的是：Sublime 的 GUI 进程和终端进程是两套环境，PATH 不互通；file_regex 一旦配错，错误定位就彻底失效；而语法绑定只做一次，后续所有同扩展名文件都依赖这次设置——这三个点卡住，Ruby 开发体验就断在第一关。
