subl 命令找不到的首要原因是可执行文件未安装，而非 PATH 配置错误；macOS 通过菜单安装命令行工具，Windows 检查安装目录，Linux 注意 Snap/Flatpak 版本不自带 subl。
subl 命令找不到？先确认它是否存在，再谈 PATH
很多人执行 subl --version 报 command not found，第一反应是 PATH 没配对——但更大概率是 subl 可执行文件压根没安装。PATH 查找的前提是目标文件存在；不存在，PATH 再长也没用。
实操建议：
- macOS：检查
/Applications/Sublime Text.app/Contents/SharedSupport/bin/subl是否存在；若无，用菜单 Sublime Text → Install Command Line Tool 安装（自动处理空格、升级、路径） - Windows：直接去安装目录（如
C:Program FilesSublime Textsubl.exe）看文件是否在；绿色版或旧安装器常漏掉它 - Linux：tarball 版通常自带
subl二进制，但 Snap/Flatpak 版默认不提供，需换 deb/rpm 或重装 - 所有系统：终端新开一个窗口（不是新标签页），运行
which subl验证是否真被识别
构建系统里写 path 字段，为什么还是找不到 coffee/python/gcc？
因为 Sublime 的构建系统（.sublime-build）启动时，**不 source 你的 shell 配置文件**（~/.zshrc、~/.bash_profile 等）。你在终端里能跑 coffee --version，不代表构建系统知道 coffee 在哪。
实操建议：
- 别依赖
path字段“修复”环境——它只影响子进程的PATH，但前提是父进程（Sublime GUI）本身已加载了正确环境；而 GUI 启动时通常不读 shell 配置 - 最稳做法是：在终端运行
which coffee（macOS/Linux）或where coffee（Windows），拿到绝对路径，然后在构建系统中硬编码到cmd里 - Windows 用户注意：
npm install -g coffeescript安装的是coffee.cmd，不是coffee；构建系统里必须写"cmd": ["coffee.cmd", "-c", "$file"] - macOS Apple Silicon 用户：
/usr/local/bin可能不在默认 PATH 中，Homebrew 默认装在/opt/homebrew/bin；软链接或显式加入path字段时用后者
Packages/User/ 是唯一生效位置，放错就等于没写
构建系统文件不是“保存了就能用”。Sublime Text 只加载 Packages/User/ 目录下的 .sublime-build 文件，其他任何路径（桌面、项目根目录、Packages/MyLang/）全被无视。
实操建议：
- 用菜单 Preferences → Browse Packages… 打开目录，进入
User/子文件夹，新建文件，后缀必须是.sublime-build（例如Python3_Run.sublime-build） - 别双击桌面文件再拖进 Sublime 编辑——这样保存路径仍是桌面，不会自动移到
User/ - 文件内容必须是合法 JSON：
cmd是数组不是字符串；Windows 路径含空格必须整体加引号并用双反斜杠转义，例如"C:\Program Files\Python39\python.exe" - 验证是否生效：重启 Sublime，打开对应类型文件（如
.py），按Ctrl+Shift+P输入 Build With，看菜单里有没有你命名的构建项
selector 不匹配，构建系统根本不会自动激活
selector 字段匹配的是 Sublime 的语法作用域（scope），不是文件扩展名。写成 "selector": "source.python" 才对；写成 "selector": ".py" 或 "selector": "python" 都无效。
实操建议：
- 打开一个目标文件（如
test.py），把光标放在代码里，按Ctrl+Alt+Shift+P（Windows/Linux）或Cmd+Alt+Shift+P（macOS）查看当前 scope - 常见 scope 值：
source.python、source.c、source.cpp、source.shell、source.coffee - 想“万能运行”任意文本文件，可用
"selector": "source | text"，但需配合shell_cmd和脚本判断后缀，不能只靠cmd -
$file变量只在cmd或shell_cmd中生效；如果selector匹配失败，这个变量根本不会被解析
构建系统配置中最容易被忽略的一点：GUI 启动的 Sublime 不继承 shell 的 PATH，这不是 bug，是设计使然。所以不要反复修改 ~/.zshrc 然后期待构建系统突然认出 prettier——它永远看不到，除非你把路径写死，或者改用终端启动 Sublime（subl .）。
