Sublime Text 配置 Ruby 环境本质是三件事：调用系统 ruby 命令、正确识别 .rb 文件语法、定位错误行；终端能运行但 Ctrl+B 报错因 GUI 不加载 shell 配置（如 ~/.zshrc），导致 PATH 缺失，需用 bash -l -c 或写死路径配置 Build System，并手动绑定非标准扩展名语法。
很多开发者对“配置Sublime Text的Ruby环境”这件事，可能存在一些误解。其实，Sublime Text本身并不管理Ruby运行时，也不会自动识别.rb文件。所谓的“配置环境”，核心目标非常明确：让Sublime能调用到你系统里的ruby命令、让文件正确高亮为Ruby语法、让构建输出能准确定位错误行。除此之外的插件或设置，都属于锦上添花，并非必须。
为什么终端能跑 ruby -v，但 Sublime 按 Ctrl+B 报 /bin/sh: ruby: command not found
这个问题堪称经典。根本原因在于：当你双击图标启动Sublime Text这类GUI应用时，它并不会加载你的shell配置文件（比如~/.zshrc、~/.bash_profile）。这意味着，通过rbenv init或rvm use注入到PATH环境变量里的Ruby路径，Sublime Text完全感知不到。
- macOS用户可以打开Sublime的控制台（
View → Show Console），输入import os; print(os.environ.get('PATH'))并回车。检查输出的路径字符串里，是否包含了/opt/homebrew/bin（Apple Silicon芯片）或/Users/xxx/.rbenv/shims（注意，这里必须使用绝对路径，不能用~缩写）。 - Windows用户则需要确认
ruby.exe所在的目录（例如C:\Ruby32-x64\bin）已经添加到了“系统环境变量”的PATH中，而不仅仅是“用户变量”。 - 这里有个常见的误区：别指望在Build System的
path字段里添加路径就能解决问题。这个字段只影响子进程的环境变量，无法弥补shell登录态缺失带来的根本性问题。
Build System 怎么配才不会卡死或静默失败
Build System本质上是一个单次执行器，它最适合运行ruby script.rb这类短命脚本。如果你用它来配置rails server或pry这类需要长期运行或交互的命令，结果必然是进程卡死、无法终止，甚至端口被一直占用。
- macOS/Linux 推荐配置（兼容 rbenv/rvm）：
{ "shell_cmd": "bash -l -c \"ruby '$file'\"", "file_regex": "^(*?):([0-9]*):?([0-9]*)", "selector": "source.ruby", "encoding": "utf-8" }关键在于bash -l -c，它会启动一个登录态的shell，从而加载~/.zshrc等配置文件。如果你的系统默认shell是zsh（macOS Catalina及以上版本），可以将bash替换为zsh。 - Windows 必须写死路径：
{ "cmd": ["C:\\Ruby32-x64\\bin\\ruby.exe", "$file"], "file_regex": "^(*?):([0-9]*):?([0-9]*)", "selector": "source.ruby" }注意Windows路径需要使用双反斜杠进行转义，并且路径中最好不要包含空格，否则可能导致静默失败。 - 还有一个细节：如果你没有保存文件就直接按Ctrl+B，Sublime执行的其实是磁盘上的旧版本。安装
Sa veOnBuild插件可以自动保存当前文件后再执行构建命令。
.erb、.ru、.rake 文件语法高亮失效怎么办
Sublime Text对于非标准扩展名的文件识别比较“懒”，经常会把.erb、.ru这类文件当作纯文本处理。这通常不是插件没装，而是没有手动绑定语法。
- 打开目标文件，然后通过菜单
View → Syntax，选择Ruby on Rails → HTML (Rails)（对应.erb文件）或直接选择Ruby（对应.ru、.rake文件）。 - 更一劳永逸的方法是：右键点击编辑区底部的语法名称（如“Plain Text”），选择
Set Syntax as Default for this Extension，在弹出的输入框中输入erb或ru并确认。 - 对于
.slim或.haml这类模板文件，则需要额外安装对应的语法高亮插件（如Slim或Haml），安装后记得重启Sublime Text生效。
最后，分享一个最容易被忽略的“坑”：Sublime Text构建命令的默认工作目录是项目根目录，而非当前文件所在目录。这就解释了为什么require_relative '../lib/foo'在终端里运行正常，在Sublime的构建中却会报LoadError。解决方案不是去修改相对路径，而是使用bundle exec ruby来执行（并确保项目根目录存在Gemfile），或者在脚本开头显式地添加加载路径：$LOAD_PATH << File.dirname(__FILE__)。
