subl命令根本不存在，是因为sublime text安装后不自动注册该工具；macos需在应用内执行shell commands: install subl，linux需手动建软链接，windows须勾选add to path或手动配置，验证须新开终端运行which subl或where subl及subl --version。
subl 命令根本不存在，不是 PATH 配错了
绝大多数“找不到 subl”的问题，根源不是环境变量写错，而是系统压根没这个可执行文件。它不随 Sublime Text 安装自动注册，必须手动触发安装或创建链接。
- macOS：必须在 Sublime Text 内按
Cmd+Shift+P→ 输入Shell Commands: Install subl→ 回车。这是最稳妥方式，会自动处理空格、路径变更和权限问题 - Linux（tarball/deb/rpm 版）：
subl可执行文件通常存在于安装目录（如/opt/sublime_text/subl），需手动建软链接：sudo ln -s /opt/sublime_text/subl /usr/local/bin/subl - Linux（Snap/Flatpak 版）：默认不提供
subl，换用 deb 包，或临时 alias：alias subl='subl %F' - Windows：安装时务必勾选
Add to PATH；若漏选，要么把C:\Program Files\Sublime Text\加进系统 PATH，要么在C:\Windows\System32下建subl.bat（内容为@start "" "C:\Program Files\Sublime Text\sublime_text.exe" %*）
验证 subl 是否真就位，别信“已配置”
改完 PATH 或建完链接后，旧终端进程不会自动 reload，必须新开一个终端窗口再验证——这是 Windows/macOS/Linux 共同的行为逻辑，不是 Sublime 的 bug。
- macOS/Linux：运行
which subl，有输出才说明 shell 能找到它 - Windows：运行
where subl，返回路径才算成功 - 再跑
subl --version，能输出版本号（如Sublime Text Build 4143）才算真正可用 - 如果
which subl无输出，但/Applications/Sublime Text.app/Contents/SharedSupport/bin/subl存在，说明只是链接没建对或/usr/local/bin不在$PATH里
macOS Apple Silicon 用户容易踩的坑
M1/M2 Mac 上，/usr/local/bin 可能不在默认 $PATH 中，尤其用 Homebrew 安装过其他工具后，/opt/homebrew/bin 才是主路径。
- 不要硬改
/usr/local/bin，直接链到 Homebrew 的 bin 目录：sudo ln -sf "/Applications/Sublime Text.app/Contents/SharedSupport/bin/subl" /opt/homebrew/bin/subl - Zsh 是 macOS 默认 shell，改完
~/.zshrc后必须执行source ~/.zshrc，只改.bash_profile没用 - 确认 Sublime 安装路径是否含空格或中文——路径为
/Applications/Sublime Text.app是标准写法；若装在桌面或文档里，链接命令中必须加反斜杠转义空格，如/Users/me/Desktop/Sublime\ Text.app/...
Windows 上 subl.exe 找不到，重装比调试更快
便携版、绿色解压版、第三方打包版 Sublime Text 几乎都不带 subl.exe。它只存在于官方安装包释放的根目录下（如 C:\Program Files\Sublime Text\subl.exe）。
- 打开安装目录，手动找有没有
subl.exe；没有就别折腾 PATH，直接卸载，去官网下最新.exe安装器重装 - 自定义安装路径（如
D:\Tools\Sublime Text）时，必须把该**完整路径**加入系统 PATH，不能只加bin或SharedSupport\bin - PATH 修改后，所有 CMD/PowerShell/Windows Terminal 窗口都得关掉重开——旧进程不会读新 PATH
- 如果仍不行，临时用绝对路径调用：
"D:\Tools\Sublime Text\subl.exe" .（注意引号，路径含空格必须包裹）
