Sublime调用rake报command not found，根本原因是GUI启动不加载shell环境变量，导致~/.rbenv/shims等路径不可见；需用zsh -l -c或写死路径解决，并配置file_regex匹配Ruby错误格式。
Sublime 调用 rake 命令总报 command not found
不是 Rake 没装，是 Sublime GUI 启动时根本没加载你的 shell 环境，rake 在 ~/.rbenv/shims 或 ~/.rvm/bin 里，但 Sublime 的 PATH 里压根没有这些路径。
验证方法：按 Ctrl+` 打开控制台，运行 import os; print(os.environ.get('PATH'))，看输出是否含 /Users/xxx/.rbenv/shims（macOS/Linux）或 C:Ruby32-x64in（Windows）。
- macOS/Linux 推荐用登录 shell 加载环境：
"shell_cmd": "zsh -l -c 'rake $args'"（-l是关键，会自动 source~/.zshrc） - Windows 必须写死路径：
"cmd": ["C:\Ruby32-x64\bin\rake.bat", "$args"]（注意双反斜杠，且用.bat而非.exe） - 别信
path字段能“补 PATH”——它只影响子进程启动时的环境变量，不解决 shell 初始化缺失问题
Rakefile 里的任务在 Sublime 里没法传参或选任务
默认构建系统只支持单命令执行，rake db:migrate 这种带冒号的任务名会被当语法错误；更麻烦的是，你没法像终端里那样交互式选任务或传参数。
解决方案是用 variants + $args 实现灵活调用：
- 在
Rake.sublime-build里定义多个变体："name": "db:migrate"、"name": "test:all"，每个对应固定命令 - 主构建保留通用入口：
"cmd": ["rake", "$args"]，然后按Ctrl+Shift+B（macOS 是Cmd+Shift+B）呼出菜单选「Run with args」，输入db:rollback STEP=1 -
$args不会自动加引号，含空格参数要手动加，比如"test:spec SPEC=spec/models/user_spec.rb"
Rake 输出错误行点不了，跳不到对应文件
Rake 自身不输出标准 Ruby 错误格式，它跑的是 Ruby 代码，但错误堆栈常被截断或混在日志里。双击构建面板里的报错没反应，基本是 file_regex 没匹配上实际输出。
Rake 默认错误格式和 Ruby 不同，例如：rake aborted! NoMethodError: undefined method `foo' for #<Object:0x00007f8b1c0a1234>，没有 filename.rb:line 结构。
- 如果任务里用了
require './lib/my_task'并出错，错误会以 Ruby 原始格式抛出，此时用 Ruby 标准正则："file_regex": "^([^:]*):([0-9]+):?([0-9]*)" - 如果错误来自 Rake 自身（如任务未定义），就别指望跳转——Rake 不输出文件位置，
file_regex只能匹配到rake aborted!这类前缀，建议关掉该字段或留空 - 想精准跳转，得在 Rakefile 里主动触发 Ruby 错误，比如加一行
raise "debug" if ENV['DEBUG']，再配合rake mytask DEBUG=true
Rails 项目里 rake assets:precompile 总卡住或权限失败
这不是 Sublime 的问题，是 Rake 任务本身依赖 Bundler 环境、Node.js 和当前工作目录。Sublime 默认工作目录是文件所在路径，但 Rails 项目要求必须在项目根目录下运行 rake，否则 bundle exec rake 会找不到 Gemfile。
- 强制设置工作目录：
"working_dir": "$project_path"（前提是已用Project → Open Project加载了 Rails 项目） - 显式走 Bundler：
"shell_cmd": "zsh -l -c 'cd $project_path && bundle exec rake $args'"（避免全局 rake 和项目 gem 冲突） - Node.js 权限问题常见于 macOS：如果
rake assets:precompile报EACCES，说明 Node 模块权限不对，Sublime 无法绕过——得先在终端里cd $project_path && yarn install或npm install一次
最易被忽略的是：Rake 任务的成败高度依赖当前 shell 的完整环境（rbenv 版本、Bundler lock、Node path），GUI 启动的 Sublime 天然缺失这些，所以哪怕配置全对，某些任务仍会静默失败——这时别调 Sublime，直接终端里复现再排查。
