subl命令必须先存在再被path找到，不存在则根本不会进入path查找；macos需通过菜单安装命令行工具，windows需确认subl.exe是否存在并正确配置path，linux需手动建软链接，且所有系统均须重启终端验证。
subl 命令不是“配出来”的，而是必须先存在、再被系统 PATH 找到；配错环境变量本身不会导致 subl 失效，但 PATH 没包含它的位置，或者 GUI 启动时根本没加载 shell 配置，就会静默失败。
subl 可执行文件是否存在，比 PATH 配置更优先
很多人卡在 command not found，其实根本没走到 PATH 查找这步——subl 文件压根不存在。
- macOS 官网 DMG 安装包自带
/Applications/Sublime Text.app/Contents/SharedSupport/bin/subl，但便携版、第三方打包版通常不带；菜单栏 Sublime Text → Install Command Line Tool 是最稳的安装方式（自动处理路径空格和版本升级） - Windows 官方安装器默认释放
subl.exe到安装目录根路径（如C:\Program Files\Sublime Text\subl.exe），但绿色解压版、旧版安装器或自定义路径安装可能没有它；手动检查该路径下是否存在subl.exe是第一步 - Linux tarball 版一般自带
subl二进制，但 Snap/Flatpak 版本默认不提供，需换源或重装
PATH 要加对位置，且必须重启终端才生效
即使 subl 文件存在，PATH 没指向它，或者终端进程没 reload 新配置，subl --version 依然会失败。
- macOS/Linux：不能只改
~/.zshrc就完事——GUI 启动的终端（如 iTerm 标签页）可能不触发重载；必须新开一个终端窗口（非新标签页），再运行which subl和subl --version - Windows：PATH 添加后，所有已打开的 CMD/PowerShell/Windows Terminal 必须全部关闭再重开；用
echo %PATH%检查关键词Sublime是否真实出现 - Apple Silicon 用户注意：
/usr/local/bin可能不在默认 PATH 中，Homebrew 默认路径是/opt/homebrew/bin，建议软链接到那里，并确保~/.zshrc包含export PATH="/opt/homebrew/bin:$PATH"
GUI 启动的 Sublime 不继承 shell 的 PATH，构建系统尤其容易踩坑
你在终端里能跑 prettier --write，但 Sublime 构建系统报 command not found，不是配置漏了，是机制使然——GUI 应用启动时不 source ~/.zshrc 或 ~/.bash_profile。
- 构建系统（
.sublime-build）只继承系统级环境变量，不会读取你 shell 里export的 PATH - 解决办法只有写绝对路径：先在终端运行
which prettier，得到类似/opt/homebrew/bin/prettier，然后在构建配置里直接填这个完整路径 - 不要试图在构建系统里用
shell_cmd或env注入 PATH——Sublime 的构建系统对环境变量支持极弱，且跨平台行为不一致
subl 参数对路径和格式极其敏感，错一个字符就静默失效
subl 支持行号跳转和多文件打开，但语法容错为零，且不报错，只会打开空白文件或错误位置。
- 正确格式：
subl path/to/file.py:42（第 42 行）、subl path/to/file.py:42:15（第 42 行第 15 列） - 冒号不能省略，列号不能前置，空格不能多加；相对路径依赖当前工作目录，
subl ./src/index.ts:10在错误目录下执行会静默失败 - 多个文件定位要严格按顺序：
subl main.go:100 utils.go:23:5，中间不能换行或加逗号
最容易被忽略的是：GUI 启动的 Sublime 和终端启动的 Sublime，PATH 来源完全不同；而构建系统连 GUI 启动时的 PATH 都不继承——这意味着，哪怕你把 subl 配得再完美，构建工具链仍得靠绝对路径硬编码。
