Sublime Text 默认不继承终端的 Ruby 环境,需在 Build System 中显式指定 ruby 可执行文件路径;GUI 下不加载 ~/.zshrc,故 rbenv/rvm shims 不生效,须用绝对路径或登录 shell 加载配置,并正确设置 file_regex 以支持错误跳转。

Sublime Text 本身没有“默认 Ruby 解释器”这个概念——它只认你 Build System 里写的 cmd 或 shell_cmd,不继承终端的 ruby 版本逻辑。 所以所谓“设置默认解释器”,本质是让每次 Ctrl+B 都稳定调用你想要的那个 ruby 可执行文件,而不是靠环境变量碰运气。
为什么终端能用 rbenv/rvm,但 Sublime 找不到 ruby?
GUI 启动的 Sublime 不加载 ~/.zshrc(或 ~/.bash_profile),也就不会执行 rbenv init 或 rvm use 注入的 shims 路径。结果就是:os.environ.get('PATH') 输出里压根没有 /Users/xxx/.rbenv/shims 或 ~/.rvm/bin。
- 验证方式:按
Ctrl+`打开控制台,输入import os; print(os.environ.get('PATH')),确认输出是否含你的 Ruby 路径 - 别指望改
~/.zshrc就能生效——Mac GUI 应用默认只读~/.zprofile;Windows 则必须把 Rubybin目录加进「系统环境变量」PATH,不是用户变量 - rbenv 用户注意:
~在 JSON 中不被解析,写"path": "~/.rbenv/shims"是无效的,必须用绝对路径如/Users/xxx/.rbenv/shims
Build System 怎么写才能锁定 Ruby 版本?
两种可靠路径:要么显式调用 shim(推荐),要么用登录态 shell 加载配置。不要裸写 "cmd": ["ruby", "$file"],GUI 下基本失效。
- rbenv 用户(macOS/Linux):
"shell_cmd": "/Users/xxx/.rbenv/shims/ruby "$file""—— 绝对路径 + 双引号包裹$file防空格 - rvm 用户(macOS/Linux):
"shell_cmd": "bash -l -c 'rvm use default && ruby "$file"'"——-l触发登录态,rvm use default确保版本明确 - Windows 用户:
"cmd": ["C:\Ruby32-x64\bin\ruby.exe", "$file"]—— 反斜杠必须双写,路径不能含空格(C:\Program Files会静默失败) - 如果用 asdf,同理:写死
~/.asdf/shims/ruby的绝对路径,别依赖 shell 初始化
file_regex 配错会导致错误行定位完全失效
Build System 输出报错时,双击 test.rb:5:in `foo': undefined method `bar' 跳不到第 5 行?大概率是 file_regex 没匹配上 Ruby 的实际错误格式。
- Ruby 标准错误格式是:
文件名:行号:列号: 错误信息或文件名:行号: 错误信息 - 最稳的正则:
"file_regex": "^([^:]*?):([0-9]+):(?:[0-9]+)?:?.*"—— 匹配任意非冒号字符作文件名,第一个数字作行号 - 别用网上抄的
"^(*?):([0-9]*):?([0-9]*)",*在正则里不转义会出错,且不捕获文件名 - 漏掉
file_regex字段,构建失败后只能手动翻行号,毫无效率可言
真正容易被忽略的是:Sublime 不会在运行前自动保存文件。你改了代码但没按 Ctrl+S,$file 对应的仍是磁盘旧版本——这个行为和解释器无关,但会让调试变成玄学。


















