Sublime Text需手动配置Ruby构建系统才能运行.rb文件;创建JSON格式的Ruby.sublime-build文件,指定cmd、path等字段,并注意PATH环境变量与ruby路径匹配。
Sublime Text 本身不自带 Ruby 运行环境,必须手动配置构建系统(Build System)才能执行 .rb 文件;否则点击 Ctrl+B 会报错 Unable to find target build system 或直接无响应。
如何创建 Ruby 构建系统
Sublime Text 执行 Ruby 脚本依赖「构建系统」——本质是一个 JSON 配置文件,告诉 Sublime 用什么命令、在什么路径下运行代码。
- 菜单栏选择 Tools → Build System → New Build System…
- 清空默认内容,粘贴以下配置(适配大多数 macOS/Linux 用户):
{
"cmd": ["ruby", "$file"],
"file_regex": "^(...*?):([0-9]*):?([0-9]*)",
"selector": "source.ruby",
"encoding": "utf-8",
"path": "/usr/local/bin:/opt/homebrew/bin"
}
-
path字段很重要:它补充了 Sublime 的环境变量,确保能定位到你安装的ruby可执行文件。如果你用rbenv或rvm,需替换成对应 shims 路径,例如~/.rbenv/shims(注意:Sublime 不解析~,要写绝对路径如/Users/yourname/.rbenv/shims) - 保存为
Ruby.sublime-build,建议放在默认弹出路径(即Packages/User/目录下)
Windows 下 ruby 命令找不到怎么办
Windows 用户常见问题是:明明 cmd 中能运行 ruby --version,但在 Sublime 里仍提示 'ruby' is not recognized。