Sublime Text 不运行或调试 Ruby，仅调用系统 ruby 命令；“配置成功”指 Ctrl+B 输出 ruby -v 且双击错误行可跳转。GUI 启动不加载 shell 配置，导致 PATH 缺失；macOS/Linux 应用 -l 登录 shell，Windows 需将 Ruby bin 加入系统 PATH；Build System 必须正确设置 shell_cmd 和 file_regex，否则静默失败或无法跳转；.rb 文件需手动绑定 Ruby 语法。
Sublime Text 本身不运行 Ruby，也不调试 Ruby；它只调用你系统里已装好的 ruby 命令，再把输出展示出来。所谓“配置成功”，就是让 Ctrl+B 能打出 ruby -v 的结果，且双击错误行能跳转到对应位置——其余全是锦上添花，不是必须。
为什么终端能跑 ruby -v，但 Sublime 按 Ctrl+B 报 command not found: ruby
GUI 启动的 Sublime（比如双击图标、从 Dock 或开始菜单打开）不加载你的 shell 配置文件（~/.zshrc、~/.bash_profile 或 Windows 的「系统环境变量」），所以根本看不到 rbenv/rvm/Homebrew 注入的 PATH。
- 验证方式：按
Ctrl+`打开 Sublime 控制台，输入import os; print(os.environ.get('PATH'))，检查输出里有没有你的 Ruby 路径（如/opt/homebrew/bin、/Users/xxx/.rbenv/shims或C:Ruby32-x64in） - macOS/Linux 用户更稳的临时解法：在终端执行
subl .（前提是已配好subl命令），它会继承当前 shell 的完整环境 - Windows 用户必须把 Ruby 的
bin目录（例如C:Ruby32-x64in）加进「系统环境变量」PATH，不能只加用户变量；改完要彻底关闭并重启 Sublime
Build System 怎么写才不静默失败
别用 Tools → Build With → Ruby 默认选项，那是 Sublime 2 遗留项，路径硬编码且早已失效。关键是要让 Sublime 真正拿到 ruby 命令，而不是依赖残缺的 PATH。
- macOS/Linux（zsh 用户，Catalina+ 默认）：
"shell_cmd": "zsh -l -c 'ruby "$file"'"——-l表示登录态 shell，会自动 source~/.zshrc，从而识别 rbenv/rvm - macOS/Linux（bash 用户）：
"shell_cmd": "bash -l -c 'ruby "$file"'"—— 同理，但确认你默认 shell 确实是 bash - Windows：
"cmd": ["C:\Ruby32-x64\bin\ruby.exe", "$file"]—— 反斜杠必须双写，路径不能含空格（如C:Program Files会静默失败） - 用 rbenv 且想保持版本灵活：
"shell_cmd": "/Users/xxx/.rbenv/shims/ruby "$file""—— 必须写绝对路径，~不会被 JSON 解析器展开 - 别加
"path"字段试图“补 PATH”：它只影响子进程启动时的环境，解决不了 shell 初始化缺失这个根源问题
.rb 文件打开还是 Plain Text，没有高亮和缩进
这不是插件没装或语法包失效，是 Sublime 根本没把文件当 Ruby 处理。它默认对 .rb 扩展名有绑定，但首次打开时可能仍显示为 Plain Text。
- 手动切换：打开任意
.rb文件 → 点右下角语言名（如 “Plain Text”）→ 选Ruby - 永久绑定：选完
Ruby后，点右侧出现的Open all with current extension as…→ 确认选中Ruby，这样所有.rb文件下次都会自动用 Ruby 语法 - 如果用了非标扩展名（如
.ru或.rake），也要在同样位置手动绑定一次 - Sublime Text 4 自带 Ruby 支持，无需额外装 Package Control 里的旧版 Ruby 包
file_regex 配错会导致错误定位失效
Build System 输出报错时，双击错误行跳不到对应位置，大概率是 file_regex 不匹配 Ruby 实际输出格式。
- Ruby 标准错误格式是：
test.rb:5:in `foo': undefined method `bar' (NoMethodError) - 推荐用：
"file_regex": "^([^:]*):([0-9]+):?([0-9]*)"—— 它能匹配行号前的文件名和可选列号，兼容大多数情况 - 别抄网上过时的正则，比如
"^.*?:(\d+):.*$"会漏掉文件名，导致跳转失败 -
file_regex必须配，否则构建失败后只能靠肉眼找行号
最常被忽略的是：Build System 是单次命令执行器，不是终端。它不支持交互式命令（如 pry）、长期服务（如 rails server），也不处理 STDIN 输入——想调试复杂逻辑，得靠 puts 或改用真正支持调试的 IDE。
