Sublime Text 为 Ruby 项目配置独立环境需手动对齐三件事:构建命令调用项目专属 ruby + bundle exec、语法高亮绑定非标准扩展名(如.ru/.rake)、SublimeLinter-rubocop 强制读取项目级 .rubocop.yml;Windows 需硬编码 ruby.exe 路径并确保 bundle 在 PATH 中,macOS/Linux 推荐用 zsh -l -c 加载登录态环境以支持 rbenv/rvm 和 .ruby-version。

Sublime Text 本身不管理 Ruby 环境,所谓“为 Ruby 项目配置独立环境”,实际是让 Sublime 的构建、语法、插件行为能按项目需求隔离——比如用 rbenv 切换版本、用 Bundler 加载 gem、避免全局 rubocop 规则污染项目检查。这不能靠一键设置完成,得手动对齐三件事:构建命令的 Ruby 解释器路径、项目级语法/插件作用域、以及 Bundler 的上下文。
怎么让 Ctrl+B 走项目专属的 ruby + bundle exec
默认 Build System 跑 ruby $file 会跳过 Gemfile,导致 require 'rspec' 报错。必须显式走 bundle exec,且确保它调用的是项目绑定的 Ruby 版本(如 .ruby-version 指定的)。
- macOS/Linux:用登录态 shell 启动,自动加载 rbenv/rvm 和当前目录下的
.ruby-version:{ "shell_cmd": "zsh -l -c 'cd $file_path && bundle exec ruby "$file"'", "file_regex": "^([^:]*?):([0-9]+):(?:[0-9]+)?:?.*", "selector": "source.ruby", "encoding": "utf-8" } - Windows:不支持
zsh -l -c,只能硬编码 ruby.exe 路径,但bundle exec仍可用(前提是bundle命令在 PATH 中):{ "cmd": ["C:\Ruby32-x64\bin\ruby.exe", "-S", "bundle", "exec", "ruby", "$file"], "file_regex": "^([^:]*?):([0-9]+):(?:[0-9]+)?:?.*", "selector": "source.ruby" } - 关键点:
cd $file_path或-S bundle是为了确保bundle exec在项目根目录下执行,否则可能找不到Gemfile;$file_path不会被 Windows 的cmd解析,所以 Windows 用户必须把项目根目录加进系统 PATH,或改用 Terminus 插件跑终端命令
如何让 RuboCop / SublimeLinter 只读项目 .rubocop.yml
全局安装的 rubocop 默认不读项目根目录的 .rubocop.yml,SublimeLinter-rubocop 会直接报错“no config file found”。这不是插件 bug,是 rubocop 自身行为。
- 在项目根目录运行
bundle exec rubocop --auto-gen-config生成.rubocop_todo.yml,再把它加入.rubocop.yml的inherit_from - SublimeLinter 设置中(
Preferences → Package Settings → SublimeLinter → Settings),强制指定 rubocop 执行路径和工作目录:"rubocop": { "executable": ["bundle", "exec", "rubocop"], "args": ["--config", ".rubocop.yml"] } - 注意:
executable不能写成["bundle exec rubocop"]—— SublimeLinter 会把整个字符串当一个命令名,找不到可执行文件;必须拆成数组
为什么项目里 .rb 文件语法高亮正常,.ru 或 .rake 却还是 Plain Text
Sublime 默认只绑定 .rb 到 source.ruby 语法,其他扩展名不会自动继承。即使你装了 Ruby 插件,也不会替你做这个映射。
- 打开一个
script.ru文件 → 右下角点击当前语言名(如 “Plain Text”)→ 选 “Ruby” → 点击弹出菜单里的 “Open all with current extension as…” → 输入ru回车 - 同理处理
.rake、.gemspec等;每种扩展名都要单独绑定一次 - 绑定后,Sublime 会把规则写入
Packages/User/Preferences.sublime-settings的extensions字段,无需重启,但若误删该字段,所有自定义绑定就失效
最易被忽略的一点:Sublime 没有项目级环境变量概念。.env 文件、BUNDLE_PATH、甚至 RUBYOPT 都不会被 Build System 或 Linter 自动加载。如果项目依赖这些,要么在 shell_cmd 里手动 export,要么改用 Terminus 插件开终端并 source 它们——别指望 Sublime 自己解析 .env。


















