Sublime运行Ruby开发环境搭建_Sublime自动化运行Ruby脚本的必备知识【手册】

先说一个容易误解的点：Sublime Text 本身不运行 Ruby，它只是调用你系统里已经安装好的 ruby 命令。所谓的“自动化运行”，本质上就是让 Build System 稳妥地把当前这个 .rb 文件交给正确的 Ruby 解释器去执行。大多数失败的原因不在 Sublime 本身，而是环境没有对齐。

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

这是最常见、也最容易误判的问题。你在终端里能跑 ruby -v，但 Sublime 就是找不到 ruby。原因很直接：GUI 启动的 Sublime 默认不加载 shell 的配置文件（比如 ~/.zshrc），所以它读不到 rbenv、rvm 或 asdf 注入的那些路径。

• 先在 Sublime 的控制台里（View → Show Console）运行这条命令：import os; print(os.environ.get('PATH'))，看看输出里有没有你的 Ruby 路径，比如 /opt/homebrew/bin、/Users/xxx/.rbenv/shims 或 C:\Ruby32-x64\bin。
• macOS/Linux 用户优先考虑用终端启动 Sublime：直接输入 subl .。前提是已经配置好了 subl 命令。这样做的好处是，它会继承你当前 shell 的 PATH 和版本管理器的状态。
• Windows 用户必须把 ruby.exe 所在的目录（比如 C:\Ruby32-x64\bin）加到「系统环境变量」的 PATH 里，只加进「用户变量」是不够的。
• 有个老说法是去 Tools → Build With → Ruby，但那是 Sublime 2 时代的遗留功能，基本已经没用了。

Build System 怎么写才不踩坑

Build System 是 Sublime 调用外部命令的唯一通道，任何一个字段写错，都可能让构建静默失败，或者报错信息无法跳转。关键字段不是装饰品，它们是功能刚需。

• "cmd" 或 "shell_cmd" 必须明确指定 Ruby 可执行文件的完整路径。用 which ruby 查出来的最稳妥，比如 "/Users/xxx/.rbenv/shims/ruby"。裸写 "ruby" 完全依赖 PATH，在 GUI 环境下大概率会出问题。
• "file_regex": "^(*?):([0-9]*):?([0-9]*)" 这个字段必须加上，否则错误信息里的行号你没法双击跳转。
• "selector": "source.ruby" 是触发条件，确保这个 Build System 只对 .rb 文件生效。没有这句话，按 Ctrl+B 可能毫无反应。
• "working_dir": "$file_path" 建议显式设置，否则 require_relative 或 File.read 会因为工作目录不对，给你报 LoadError 或 Errno::ENOENT 错误。
• macOS/Linux 用户可以用 "shell_cmd": "zsh -l -c 'ruby \"$file\"'" 来代替裸 "cmd"，这样对版本管理器更友好。不过要注意引号嵌套和空格转义的问题。

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

这不是插件没装好，也不是 Ruby 本身的问题。根本原因是 Sublime 没把 .rb 当作 Ruby 文件来处理。刚安装或重置后，默认是不关联的，需要手动绑定。

• 点击编辑区右下角显示当前语言名的地方（比如显示 "Plain Text"），选择 Ruby。然后点击右侧弹出的 Open all with current extension as…，确认选中 Ruby。
• 如果文件扩展名是 .ru、.rake 或 .erb，需要单独绑定。右键点击底部语法名，选择 Set Syntax as Default for this Extension，然后输入对应的扩展名。
• 不要跑去改 Preferences → Settings – Syntax Specific，那只是临时覆盖，解决不了文件类型关联的根本问题。
• 原生 Sublime 不提供方法级的自动补全。如果需要 def 之类的下拉提示，得装插件（比如 SublimeCodeIntel）。但语法高亮本身不需要插件。

中文乱码、require 找不到 gem、脚本卡住没输出

这些问题看上去像是 Ruby 的问题，但其实根源在于 Build System 的运行上下文太“干净”了。没有项目的 Gemfile，没有 $LOAD_PATH，没有 UTF-8 的 locale 声明，所以行为跟终端里不一致。

• 中文输出乱码：在 Build System 里加上 "env": {"LANG": "en_US.UTF-8", "LC_ALL": "en_US.UTF-8"}，强制子进程使用 UTF-8 编码。
• require 找不到本地文件或 gem：优先用 bundle exec ruby "$file" 替代裸写 ruby "$file"。同时，在 "shell_cmd" 里显式 cd 到项目根目录，比如："shell_cmd": "cd \"$project_path:.\" && bundle exec ruby \"$file\""。
• 脚本卡住（比如用了 gets 或 irb）：Build System 不支持交互式输入。这类命令应该改用 Terminus 这类插件，在内建终端里运行。
• 想运行 rails server 或 rspec？别硬要塞进 Build System——它不是为长期运行的服务设计的，关了没日志，也没法交互。

经常被忽略的一点是：Build System 生效需要两个独立条件同时满足——文件语法必须是 Ruby（右下角显示），并且 Build System 必须被手动选中（Tools → Build System 里勾选你配置的那个）。缺一不可，但很多人只做了其中一半。