Sublime Text无法直接调用终端可用命令，根源在于其不加载shell配置文件（如.zshrc），必须显式指定绝对路径和环境变量；构建系统需用cmd数组而非shell_cmd，且env字段为覆盖式设置。
Sublime Text 不能直接调用你终端里能跑的命令，除非你显式告诉它路径和环境——这是所有“command not found”问题的根源。
subl 命令本身没装，就别谈调用其他工具
很多人一上来就想让 Sublime 调用 prettier 或 python，却卡在 subl --version 都报错。这不是配置问题，是基础没搭好。
- macOS：菜单栏
Sublime Text → Install Command Line Tool，不是手动建软链接（后者容易因空格、路径变更失效） - Linux：确认安装包是否含
subl可执行文件；若用 tarball，运行sudo ln -s /opt/sublime_text/subl /usr/local/bin/subl - Windows：安装时勾选
Add to PATH；漏选了就去系统环境变量里加C:\Program Files\Sublime Text\，别只加subl.exe所在子目录 - 验证必须两步：
which subl（或where subl）有输出，且subl --version能返回版本号
构建系统里写 python 就会失败
Sublime 启动时不读你的 .zshrc 或 .bash_profile，所以即使终端里 which python 返回 /opt/homebrew/bin/python3，构建系统里写 "cmd": ["python", "$file"] 依然大概率报错。
- 必须用绝对路径：
"cmd": ["/opt/homebrew/bin/python3", "$file"] - macOS M1/M2 用户常见路径：
/opt/homebrew/bin/python3（Homebrew）、/usr/bin/python3（系统自带，但 macOS 12.3+ 已移除）、/Library/Frameworks/Python.framework/Versions/3.11/bin/python3（官方安装包） - Windows 路径要用正斜杠：
"cmd": ["C:/Users/me/AppData/Local/Programs/Python/Python311/python.exe", "$file"]，不能用反斜杠或写成字符串拼接 -
cmd数组每个元素必须是独立字符串，不能写成"cmd": ["C:/.../python.exe $file"]—— 这会被当做一个命令名，找不到
为什么改了 PATH，构建系统还是不认环境变量
因为 Sublime 不继承 shell 的运行时环境。你 source ~/.zshrc 后终端里一切正常，但图标点击启动的 Sublime 完全不知道这回事。
- 临时绕过：从终端启动 Sublime，比如
subl .，此时它会继承当前 shell 环境（适合调试） - 长期方案：在
.sublime-build中显式指定env字段，例如："env": {"PATH": "/opt/homebrew/bin:/usr/bin:/bin"} - 注意：
env是覆盖，不是追加；如果漏掉/usr/bin，连sh都可能找不到 - 某些工具（如
node）依赖额外环境变量（NODE_OPTIONS、HOME），也要一并塞进env里
格式化工具（如 prettier）的典型配置陷阱
用构建系统调用格式化工具，最容易踩的是路径、参数顺序和文件保存时机。
- 确保
$file是完整路径，且文件已保存（未保存的 buffer 没有磁盘路径，$file为空） -
prettier的--write参数必须放在文件路径前，否则会报Unknown option（如["/opt/homebrew/bin/prettier", "--write", "$file"]） - JavaScript 文件建议加
"selector": "source.js, source.jsx, source.ts, source.tsx"，避免误触发 - 想看输出结果？加
"panel": "output.exec"，否则默认静默执行，出错也不提示 - 不想覆盖原文件？改用
--write为--print-width 80 --single-quote等只输出不写入的选项，再配合"target": "exec"查看效果
最常被忽略的一点：Sublime 的构建系统不支持 shell 特性（管道、重定向、分号连接多条命令）。想实现 cat $file | prettier --stdin 这类操作，得包装成 shell 脚本再调用，或者换用 shell_cmd（但跨平台兼容性更差）。
