Sublime如何配置Ruby开发环境 Sublime运行Ruby脚本设置【攻略】

Sublime Text不运行Ruby，仅调用系统ruby命令；.rb文件无高亮因未绑定Ruby语法，需右下角手动设置并选“Open all with current extension as…”；报“ruby: command not found”是因GUI未加载shell环境变量，macOS需在~/.zprofile配置PATH，Windows需将ruby路径加入系统环境变量PATH。

先明确一个核心概念：Sublime Text 本身并不“运行” Ruby。它本质上是一个高级文本编辑器，当你按下运行键时，它所做的只是去调用你操作系统里已经安装好的那个 ruby 命令。所以，绝大多数配置失败的问题，根源往往不在 Sublime 本身，而在于它没能正确读取到你 Shell 里的环境变量（比如大家熟悉的 PATH），或者，编辑器压根就没把 .rb 文件识别为 Ruby 代码。

为什么 .rb 文件打开是纯文本、没有高亮

遇到这种情况先别急着找插件。这通常是因为 Sublime Text 默认没有将 .rb 后缀与 Ruby 语法进行关联，尤其是在新安装或重置设置之后。

• 最直接的解决方法是：看一眼编辑器右下角，那里显示着当前文件的语法类型（比如 “Plain Text”）。点击它，然后在弹出的列表里选择 Ruby。
• 关键一步来了：选择完 Ruby 后，右下角通常会弹出一个提示，问你是否要将所有同后缀文件都按此语法打开。务必点击那个 Open all with current extension as… 并确认。这一步才是永久绑定。
• 如果你常用的文件扩展名比较特殊，比如 .ru（Rackup文件）、.rake（Rake任务）或 .erb（嵌入式Ruby），则需要为它们单独设置绑定：在编辑区底部右键点击语法名称，选择 Set Syntax as Default for this Extension，然后输入对应的扩展名即可。
• 有个常见的误区是去修改 Preferences → Settings – Syntax Specific。那里的设置只是临时覆盖，并不解决文件类型的全局关联问题。

按 Ctrl+B 报 “ruby: command not found” 怎么办

这个问题非常典型：你在终端里输入 ruby -v 明明能正常显示版本，但一到 Sublime Text 里运行就报错。这几乎可以断定，是 Sublime 这个图形界面程序启动时，没有加载你 Shell（比如 zsh 或 bash）的配置文件，导致它根本找不到 ruby 命令的路径。

• 首先，可以做个快速诊断：在 Sublime 里打开控制台（View → Show Console），输入一行 Python 命令：import os; print(os.environ.get('PATH'))。看看打印出来的路径里，是否包含你 Ruby 的安装目录，比如 macOS 上的 /opt/homebrew/bin（Apple Silicon芯片）、/usr/local/bin（Intel芯片）或者版本管理工具如 rbenv 的路径 /Users/你的用户名/.rbenv/shims。
• 对于 macOS 用户，解决方案通常是修改 ~/.zprofile 文件（注意，不是 .zshrc），在里面添加类似 export PATH="/opt/homebrew/bin:$PATH" 的语句，然后完全重启 Sublime Text。
• Windows 用户则需要确保 Ruby 的安装目录（例如 C:\Ruby32-x64\bin）已经添加到了“系统环境变量”的 PATH 中，而不仅仅是“用户变量”。
• 另外，别被菜单里那个 Tools → Build With → Ruby 选项迷惑了，那是 Sublime Text 2 时代遗留下来的硬编码路径，在现在的环境下基本已经失效。

Build System 怎么写才可靠

需要理解，Sublime 的 Build System 并非 IDE 那种“一键运行”按钮。它最适合执行那些“短平快”的脚本命令（比如 ruby script.rb），而对于像 rails server 或进入 pry 交互环境这类需要长期运行或交互的命令，则显得力不从心。

• 一个在 macOS/Linux 上兼容性较好的 Build System 配置如下（它能正确处理 rbenv 或 rvm 管理的 Ruby 版本）：

  {
    "shell_cmd": "zsh -l -c \"ruby '$file'\"",
    "file_regex": "^(*?):([0-9]*):?([0-9]*)",
    "selector": "source.ruby"
  }

  这里的 zsh -l -c 是关键，它表示启动一个“登录Shell”，这样就能加载 ~/.zshrc 等配置文件，从而找到正确的 Ruby 环境。
• 在 Windows 上，则往往需要写死绝对路径：

  {
    "cmd": ["C:\\Ruby32-x64\\bin\\ruby.exe", "$file"],
    "file_regex": "^(*?):([0-9]*):?([0-9]*)",
    "selector": "source.ruby"
  }

  注意 Windows 路径中的反斜杠需要转义，并且路径中最好不要包含空格。
• 试图在配置里用 "path": "/opt/homebrew/bin" 这样的字段来补充 PATH 通常是徒劳的，因为它只影响 Build System 启动的子进程，解决不了 Sublime 自身启动时环境变量缺失的根本问题。
• 还有一个小细节：如果你没有保存文件就直接按 Ctrl+B，Sublime 执行的是磁盘上旧版本的文件。可以安装 Sa veOnBuild 这类插件，让它能在运行前自动保存。

想跑 rails server 或 rspec 怎么办

这正是 Build System 的设计边界。它本就不适合处理需要长期占用进程或等待交互的命令。强行配置会导致 Sublime 卡死、端口被占用无法释放，或者进程无法正常终止。

• 对于 Rails 服务器这类开发任务，最踏实的方法还是老老实实用终端：cd myapp && rails server。让专业的工具做专业的事，Sublime 就专心负责代码编辑。
• 如果确实希望集成终端体验，可以安装 Terminus 插件（通过 Package Control 安装）。之后通过 Ctrl+Shift+P 调出命令面板，输入 Terminus: Open Default Shell，就能在 Sublime 内嵌的终端里运行 rails server 或执行特定的测试命令如 rspec spec/models/user_spec.rb:24。
• 别尝试用 SublimeREPL 这类插件来运行 rails console，因为它不支持完整的 TTY 交互，通常会卡在 irb 提示符那里没有任何反应。
• 对于执行单文件或单行 rspec 测试这种相对简单的任务，倒是可以配置一个自定义的 Build System，例如："shell_cmd": "zsh -l -c \"rspec '$file':$line_number\""，但需要配合正确的 file_regex 来捕获和定位错误行号。

说到底，配置 Sublime 进行 Ruby 开发，最常被忽略的两个前置步骤恰恰是最关键的：确保 Shell 环境变量被正确加载，以及确保文件类型被正确绑定。很多人花了大量时间折腾复杂的 Build System 配置，却没意识到编辑器连 ruby 命令在哪都找不到，或者根本没把当前文件当作 Ruby 代码来处理。