subl命令根本不存在，需先安装命令行工具：macos通过菜单栏install command line tool安装，linux需手动建软链接，windows须勾选add to path或手动配置；验证用which subl或where subl及subl --version。
subl 命令根本不存在，得先装命令行工具
很多人一输 subl --version 就报 command not found，不是 PATH 没配对，而是压根没装这个工具。Sublime Text 安装包默认不带 subl，它必须单独启用或手动部署。
macOS 最可靠方式：打开 Sublime Text → 菜单栏 Sublime Text → Install Command Line Tool。执行后，/usr/local/bin/subl 自动创建，路径空格、版本升级都自动适配。
Linux（tarball 版）需手动建软链接：sudo ln -s /opt/sublime_text/subl /usr/local/bin/subl；Snap/Flatpak 版本默认不提供 subl，得换安装源或改用其他方式。
Windows 安装时务必勾选 Add to PATH；若漏选，要么把 C:\Program Files\Sublime Text\ 加进系统环境变量，要么在 C:\Windows\System32 下建 subl.bat（内容为 @start "" "C:\Program Files\Sublime Text\sublime_text.exe" %*）。
验证是否成功：which subl（macOS/Linux）或 where subl（Windows）有输出，再跑 subl --version 能返回版本号，才算真正可用。
PATH 里有 subl，但构建系统还是找不到 python/g++/prettier
Sublime 的构建系统（.sublime-build）不读你的 ~/.zshrc 或 ~/.bash_profile，它启动时只继承系统级环境变量，不会 source 你 shell 里 export 的 PATH。
所以你在终端能跑 prettier --write test.js，但构建时报 command not found，是正常现象。
解决办法只有一个：用绝对路径。
- 先在终端运行
which prettier，得到类似/opt/homebrew/bin/prettier的路径 - Tools → Build System → New Build System，填入：
{
"cmd": ["/opt/homebrew/bin/prettier", "--write", "$file"],
"selector": "source.js, source.jsx"
}
保存为 Prettier.sublime-build，右下角状态栏手动选中它。
subl 打开文件定位失败：冒号、空格、顺序全得对
subl 支持行号和行列定位，但语法容错极低——漏掉冒号、多加空格、混淆列与行顺序都会导致跳转失败，且不报错，只是静默打开错误位置或空白文件。
正确写法：
- 打开文件第 42 行：
subl path/to/file.py:42 - 打开第 42 行第 15 列：
subl path/to/file.py:42:15 - 多个文件同时带定位：
subl main.go:100 utils.go:23:5
相对路径依赖当前工作目录；subl ./src/index.ts:10 在错误目录下执行，会打开空白或报错“no such file”，但不会提示路径问题。
GUI 启动的 subl 不继承 shell PATH，重启 Sublime 是硬要求
即使 subl 命令本身在终端能用，Sublime 的 GUI 进程（比如从 Dock 点开、Spotlight 启动、或被 Git 调用）仍可能找不到 python、dotnet 等工具——因为 macOS/Linux 的 GUI 应用不自动加载 shell 初始化文件。
解决方法只有两个：
- macOS：把 PATH 配置写进
~/.zprofile（不是~/.zshrc），然后完全退出 Sublime（Cmd+Q），再重新启动 - Linux：确保桌面环境（GNOME/KDE）已加载新 PATH，通常需注销重登录，或用
systemctl --user restart gnome-session类命令刷新
别指望改完 ~/.zshrc 后点一下 Sublime 图标就生效——GUI 进程的环境变量在登录那一刻就冻结了，不重启就永远拿不到新 PATH。
