Sublime Text 中 ruby -c 语法检查不自动触发,因默认 Build System 的 "cmd" 缺少 -c 参数,需手动设为 ["ruby", "-c", "$file"],并配置 file_regex、path 及 SublimeOnSaveBuild 插件的 ruby_path 和文件监听。

Sublime Text 里 ruby -c 检查不自动触发?先确认 Build System 是否真在调用 ruby
语法检查本质就是运行 ruby -c $file,但很多人配完构建系统后 Ctrl+B 仍只执行 ruby $file,根本没走语法检查。问题出在 Build System 配置里:"cmd" 字段写的是 ["ruby", "$file"],而不是 ["ruby", "-c", "$file"]。别指望默认构建会做语法检查——它只负责“运行”,不是“检查”。
要让保存即检查,得另起一套配置,或配合插件。单独靠 Build System 实现“实时”,必须手动改 cmd,且注意以下几点:
-
"cmd"必须显式包含-c参数,例如:["ruby", "-c", "$file"] - 错误输出格式要能被 Sublime 解析,
file_regex推荐用:"^([^:]+):([0-9]+):.*$"(匹配test.rb:5: syntax error这类格式) - 如果用了 rbenv/rvm,
path必须指向 shims 目录(如/Users/xxx/.rbenv/shims),不能用~,否则ruby -c找不到解释器
SublimeOnSaveBuild 插件为什么保存后没反应?路径和触发条件卡死了
这个插件本意是“一保存就跑 ruby -c”,但它不会自动绑定 Ruby 文件,也不会自动读你系统 PATH。常见失效原因有三个:
- 没手动指定
ruby_path:插件默认找ruby命令,但 GUI 启动的 Sublime 看不到你的 shell PATH,所以得在插件设置里填绝对路径,比如/opt/homebrew/bin/ruby或C:\Ruby32-x64\bin\ruby.exe - 没开启对
.rb文件的监听:默认配置可能只监听source.python,需在SublimeOnSaveBuild.sublime-settings中加:"source.ruby": {"cmd": ["ruby", "-c", "$file"]} - 保存时文件无修改?插件默认跳过未变更文件,若只是格式调整没改内容,它就不触发——这不是 bug,是设计行为
rubocop 检查报错 “command not found” 怎么办?别信 PATH,直接写死路径
装了 SublimeLinter-rubocop 却提示找不到 rubocop,不是没装,而是 Sublime 根本没继承你终端里的 PATH。验证方式仍是打开控制台输入:import os; print(os.environ.get('PATH')),看输出里有没有 /opt/homebrew/bin 或 /Users/xxx/.gem/ruby/3.2.0/bin 这类路径。
解决方法只有一个:在插件设置中强制指定 executable 路径:
{
"linters": {
"rubocop": {
"executable": "/opt/homebrew/bin/rubocop"
}
}
}
注意:rubocop 和 ruby 可能不在同一目录;rbenv 用户要确认是否已运行 rbenv rehash,否则 ~/.rbenv/shims/rubocop 可能不存在。
实时检查和运行脚本共存时,容易混淆 cmd 和 selector
一个项目里既要按 Ctrl+B 运行脚本,又要保存时语法检查,就得配两套 Build System,且 selector 不能冲突。比如:
- 运行用的 Build System:
"selector": "source.ruby","cmd": ["ruby", "$file"] - 语法检查用的 Build System:
"selector": "source.ruby"也行,但得改名(如叫Ruby Syntax Check),并通过 Tools → Build System 手动切换,否则 Ctrl+B 总是触发同一个 - 更稳妥的做法是把语法检查绑定到保存事件(用 SublimeOnSaveBuild),运行脚本保留 Ctrl+B,默认行为,避免误操作
真正容易被忽略的是:Sublime 的 selector 匹配依赖文件语法高亮是否正确。如果 .rb 文件没被识别为 source.ruby(比如你手动设成了 Plain Text),那所有基于 selector 的构建、linter、补全都失效——先按 Ctrl+Shift+P 输入 Set Syntax: Ruby 确认一下。


















