sublime怎么运行Ruby脚本_Sublime配置Ruby环境教程【指南】

ctrl+b 无反应需先确认 ruby 是否在系统 path 中；若终端执行 ruby –version 报错，则 sublime 同样找不到 ruby，mac 用户使用 rbenv/rvm 时尤需注意其未全局注入 path，应通过 tools → build system → new build system 手动指定 ruby 路径并配置正确 shell_cmd。

sublime text 里点 Ctrl+B 没反应？先确认 Ruby 是否在系统 PATH 里

Sublime 默认用 build_system 调 ruby 命令，如果终端里输 ruby --version 报 command not found，那 Sublime 肯定也找不到。Mac 上用 rbenv/rvm 管理 Ruby 的人最容易踩这个坑——它们默认不把 Ruby 加进全局 PATH，只在 shell 启动时注入。

• 在终端执行 which ruby，记下完整路径（比如 /Users/xxx/.rbenv/shims/ruby 或 /opt/homebrew/bin/ruby）
• Sublime 不读 shell 的 .zshrc，得手动告诉它用哪个 Ruby：菜单 Tools → Build System → New Build System…，填入：

{   "shell_cmd": "/Users/xxx/.rbenv/shims/ruby "${file}"",   "file_regex": "^(...*?):([0-9]*):?([0-9]*)",   "selector": "source.ruby" }

注意替换 /Users/xxx/.rbenv/shims/ruby 成你自己的路径；${file} 是当前文件路径，别漏了引号，否则含空格的路径会崩。

运行时报 LoadError: cannot load such file？Ruby 加载路径没对上

Sublime 的构建环境是干净的，不继承你当前终端的 GEM_HOME、GEM_PATH 或 require_relative 的上下文。哪怕脚本在终端能跑，换到 Sublime 就可能找不到本地 lib/ 或 gem。

• 检查报错行是不是 require './xxx' 或 require_relative —— 这类路径是相对于当前工作目录的，而 Sublime 默认以项目根目录为工作目录，不是文件所在目录
• 临时解决：改用绝对路径或显式设置 $LOAD_PATH，比如开头加 $LOAD_PATH
• 长期建议：别依赖相对 require，用 bundle exec ruby 配合 Gemfile，构建命令改成："shell_cmd": "cd "${project_path:.}" && bundle exec ruby "${file}""

中文输出乱码或报 Encoding::CompatibilityError

Windows 用户最常遇到，Ruby 脚本里有中文字符串，Sublime 构建结果窗口显示 或直接崩溃。这不是 Ruby 版本问题，是 Sublime 的 build output 编码和 Ruby 解释器默认编码不一致。

• Sublime 的构建输出默认按系统 locale 解码（Windows 上常是 GBK），但 Ruby 2.4+ 默认用 UTF-8
• 简单粗暴解法：在 Ruby 脚本第一行加 # encoding: utf-8，并确保文件本身存为 UTF-8（无 BOM）
• 更稳方案：强制 Ruby 输出用系统编码，比如 Windows 上加 puts '你好'.encode(Encoding.find('locale'))，但治标不治本
• 终极建议：换用 Terminus 插件替代原生 build，它复用真实终端，编码天然一致

想调试断点、看变量值？Sublime 本身不支持 Ruby debugger

Sublime 是编辑器，不是 IDE。它没有 Ruby 的交互式调试器（byebug/pry-byebug）集成能力，binding.pry 或 byebug 在构建中会卡住、没输入响应，因为 build system 是单向管道，不提供 TTY。

• 别在 build_system 里跑带 binding.pry 的脚本——它会挂住，还得杀进程
• 真要调试，就回到终端：cd 到文件目录，手动跑 ruby xxx.rb 或 bundle exec pry -r ./xxx.rb
• 如果非要图形化调试，用 VS Code + ruby-rdbg 扩展，比折腾 Sublime 省心得多

Ruby 脚本运行的本质是「让系统找到 ruby 可执行文件，并传入正确的路径、编码、环境变量」。Sublime 只负责触发这一步，其余全靠你铺好路。路径、编码、加载上下文，三者错一个，就卡在看似莫名其妙的地方。