sublime不能只配一个ruby构建系统,因rbenv/rvm管理多版本时,其默认构建系统无法自动感知项目级版本(如.rb-version),仅认path首个ruby或硬编码路径;需macos/linux用rbenv shell $(cat .ruby-version...)动态切换,windows则须为各版本单独建.sublime-build文件。

为什么不能只配一个 Ruby 构建系统
rbenv 或 rvm 管理多个 Ruby 版本时,Sublime 默认构建系统无法自动感知当前项目使用的版本——它只认 PATH 里的第一个 ruby,或者你硬编码的某条路径。你在终端里 rbenv local 3.1.4 后 ruby -v 正确,但 Sublime Ctrl+B 仍跑 3.2.2,就是因为构建系统没走 rbenv 的 shims 逻辑,也没触发 shell 登录态加载。
macOS/Linux:用 shell_cmd + rbenv shell 动态切换
别写死路径,也别依赖全局 ruby;让每次构建都按当前目录的 .ruby-version 文件生效:
-
"shell_cmd": "rbenv shell $(cat .ruby-version 2>/dev/null || echo 'system'); ruby "$file""—— 这行命令会先读取项目根目录下的.ruby-version,找不到就回退到 system 版本 - 必须确保
rbenv已加入~/.zprofile(GUI 应用只读这个),且rbenv init输出已正确注入 - 如果项目没
.ruby-version,rbenv shell会 fallback 到rbenv global,行为可预期 - 注意:
shell_cmd不支持$file以外的变量展开,路径含空格需靠 shell 自己处理,不用额外转义
Windows:为每个版本建独立的 .sublime-build 文件
Windows 没有 rbenv/shims 机制,只能显式区分路径。不要试图用批处理动态查版本,容易出错且 Sublime 不支持异步解析:
- 新建两个文件:
Ruby-3.1.sublime-build和Ruby-3.2.sublime-build,都放在Packages/User/ - 内容分别指定不同路径:
"cmd": ["C:\Ruby31-x64\bin\ruby.exe", "$file"]和"cmd": ["C:\Ruby32-x64\bin\ruby.exe", "$file"] - 反斜杠必须双写,路径不能含空格;若 Ruby 安装在
C:Program Files,重装到C:Ruby31-x64更稳妥 - 切换版本只需菜单栏
Tools → Build System手动选对应项,不会自动识别项目配置
容易被忽略的关键点
构建系统本身不读 Gemfile 或 .ruby-version,它只是执行命令的外壳。真正决定 Ruby 版本的是命令执行时的环境——所以 macOS/Linux 必须靠 rbenv shell 或 zsh -l -c 触发初始化,Windows 则必须靠人工维护多份配置。另外,file_regex 要统一用 "^([^:]*):([0-9]+):?,否则不同版本 Ruby 报错格式微调(比如 3.2 加了列号)会导致双击跳转失效。











