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，卡死和无法终止是必然结果——该切回终端的时候就得切。
