Sublime Text 默认无法运行 Ruby 是因 GUI 启动不加载 shell 环境变量；需通过控制台验证 PATH、配置登录态 shell 的 Build System（如 zsh -l -c）、手动绑定 Ruby 语法、修正 file_regex 正则，并避免用 Build System 运行长期进程。
Sublime Text 本身不带 Ruby 解释器，按 Ctrl+B 能不能跑起来，只取决于它能不能在自己的进程环境里找到 ruby 命令——而 GUI 启动的 Sublime 默认不加载你的 ~/.zshrc 或系统 PATH，所以终端能跑 ruby -v，Sublime 却报 command not found: ruby 是最常见现象。
怎么验证 Sublime 真正看到的 PATH
别猜，直接看它实际用的路径：
- 在 Sublime 里按
Ctrl+`打开控制台 - 输入
import os; print(os.environ.get('PATH')) - 检查输出里有没有
ruby所在目录，比如/opt/homebrew/bin（macOS Homebrew）、/Users/xxx/.rbenv/shims（rbenv）、或C:Ruby32-x64in（Windows）
如果没出现，说明 Sublime 根本没继承 shell 环境——这时候改 Build System 前，先得解决环境可见性问题。
Build System 怎么写才不依赖终端启动方式
裸写 "shell_cmd": "ruby $file" 在 GUI 下基本必挂；关键是要让 shell 初始化逻辑生效：
- macOS / Linux（用 zsh）：
"shell_cmd": "zsh -l -c 'ruby "$file"'"——-l表示登录态 shell，会加载~/.zshrc，从而识别 rbenv/rvm - macOS / Linux（用 bash）：
"shell_cmd": "bash -l -c 'ruby "$file"'" - Windows：
"cmd": ["C:\Ruby32-x64\bin\ruby.exe", "$file"]—— 必须双反斜杠，路径不能含空格，否则静默失败 - 用 rbenv 且想保持版本灵活：写
"shell_cmd": "/Users/xxx/.rbenv/shims/ruby "$file""，注意用绝对路径，~不会被解析
为什么 .rb 文件打开还是 Plain Text
这不是插件或配置失效，是 Sublime 没把文件当 Ruby 处理。它默认只对 .rb 扩展名做语法绑定，但首次打开时可能仍显示为 Plain Text：
- 手动切换：打开任意
.rb文件 → 点右下角语言名（如Plain Text）→ 选Ruby - 永久绑定：切换后，点击右侧出现的
Open all with current extension as…，这样所有.rb文件下次都会自动用 Ruby 语法 - 别指望插件自动修复——原生 Sublime 就靠这个手动绑定，没装插件也能高亮
file_regex 配错会导致错误行定位失效
Build System 输出报错时，双击错误行跳不到对应位置，大概率是 file_regex 不匹配实际输出格式：
- 标准 Ruby 错误格式是
test.rb:5:in `foo': undefined method `bar' (NoMethodError) - 推荐用：
"file_regex": "^([^:]*):([0-9]+):?([0-9]*):?.*$"（兼容有无列号、有无冒号后空格） - 别抄旧教程里的
"^.*:(\d+):?(\d+):?.*$"，它无法捕获文件名，双击就跳错文件 - Windows 用户注意：路径含盘符时（如
C:.rb），正则要允许:出现在文件名里，上面那个更稳
真正容易被忽略的是：Build System 只适合运行短命脚本，ruby server.rb 这类长期进程会卡住构建面板、无法终止——需要交互或守护进程，请直接用终端，别硬塞进 Build System。
