sublime text 本身不带 ruby 解释器,所谓“一键运行”只是调用系统已安装的 ruby 命令;能否运行取决于 sublime 能否在其环境里找到 ruby,而 gui 启动时通常无法继承终端的 path 或 rbenv/rvm 环境变量,需通过终端启动 subl 或在 build system 中显式指定 ruby 路径、使用登录态 shell(如 zsh -l -c)或写死绝对路径,并注意配置 file_regex、encoding 和 working_dir 等关键字段。

Sublime Text 本身不带 Ruby 解释器,所谓“一键运行”只是调用你系统里已安装的 ruby 命令;能不能跑起来,核心取决于 Sublime 能不能在自己的环境里找到它——而 GUI 启动的 Sublime 通常根本看不到你终端里的 PATH。
为什么终端能 ruby -v,但 Sublime 按 Ctrl+B 就报 command not found: ruby
Mac/Linux 用户:Sublime 双击启动时不会加载 ~/.zshrc 或 ~/.bash_profile,也就读不到 rbenv/rvm 注入的 PATH。Windows 用户:Ruby 安装时没勾选「Add Ruby executables to your PATH」,或只加到了「用户变量」而非「系统变量」。
- 验证方式:在 Sublime 里按
Ctrl+`打开控制台,输入import os; print(os.environ.get('PATH')),看输出里有没有你的 Ruby 路径(比如/opt/homebrew/bin或C:Ruby32-x64in) - Mac/Linux 快速修复:改用终端启动 Sublime,执行
subl(确保已配置 shell 别名),它会继承当前 shell 环境 - Windows 必须手动把 Ruby 的
bin目录(如C:Ruby32-x64in)加进「系统环境变量」PATH,然后重启 Sublime
怎么写一个靠谱的 Ruby.sublime-build 文件
别用裸 "shell_cmd": "ruby $file"——它依赖 PATH,而 GUI 下 PATH 是残缺的。优先用显式路径或登录态 shell 加载。
- macOS/Linux(推荐,兼容 rbenv/rvm):
{ "shell_cmd": "zsh -l -c "ruby '$file'"", "file_regex": "^(*?):([0-9]*):?([0-9]*)", "selector": "source.ruby", "encoding": "utf-8" }其中zsh -l -c表示启动登录态 shell,能自动 source 你的~/.zshrc - Windows(必须写死路径):
{ "cmd": ["C:\Ruby32-x64\bin\ruby.exe", "$file"], "file_regex": "^(*?):([0-9]*):?([0-9]*)", "selector": "source.ruby", "encoding": "utf-8" }注意双反斜杠转义,且路径不能含空格(如C:Program Files会静默失败) - 所有平台都建议加上
"file_regex",否则错误行号点不了,"selector": "source.ruby"确保只对.rb文件生效
文件改了但运行的还是旧代码?
Sublime 默认不会在构建前自动保存当前文件。你 Ctrl+B 时,它执行的是磁盘上最后一次保存的内容,不是编辑区里正在改的代码。
- 最简单解法:装
SaveOnBuild插件(通过 Package Control 安装),启用后每次构建都会先保存 - 手动习惯:养成写完按
Ctrl+S再Ctrl+B的节奏,尤其调试时 - 别信 “自动保存并构建” 类设置——Sublime 原生没这功能,插件是唯一可靠方案
中文乱码、require 找不到本地文件、bundle exec 不生效
Sublime 构建环境是干净的,没有你的项目目录上下文,也不继承终端里的 GEM_HOME、$LOAD_PATH 或当前工作目录。
- 中文输出乱码(Windows 最常见):Ruby 默认 UTF-8,Sublime 输出窗口按 GBK 解码。临时加
-EUTF-8:GBK参数:"cmd": ["ruby", "-EUTF-8:GBK", "$file"] -
require './lib/foo'报错:因为 Sublime 默认以项目根目录为工作目录,不是文件所在目录。改用require_relative或绝对路径,或在 build 里加cd:"shell_cmd": "cd '$file_path' && ruby '$file'" - 想用 Bundler?别只写
ruby $file,改用:"shell_cmd": "cd '$project_path' && bundle exec ruby '$file'",前提是项目有Gemfile
最常被忽略的一点:Build System 是为单次短命脚本设计的,不是终端替代品。别试图用它跑 rails server 或 pry,卡死和无法终止是必然结果——该切回终端的时候就得切。











