subl命令在zsh中不可用，是因为macos catalina+默认使用zsh且不读取~/.bash_profile，需确认subl二进制存在、创建软链接至/usr/local/bin或/opt/homebrew/bin、在~/.zshrc中添加对应path并执行source ~/.zshrc，最后新开终端验证which subl和subl --version。
subl 命令在 zsh 里用不了，不是因为你写错了，而是 Sublime 没把 subl 放进 shell 能读到的环境里 —— macOS Catalina 及以后默认用 zsh，它不认 ~/.bash_profile，也不自动继承 GUI 启动时的 PATH。
确认 subl 可执行文件真实存在
别急着改配置，先看东西有没有：
- 打开 Finder，进入
/Applications/Sublime Text.app/Contents/SharedSupport/bin/，确认里面真有subl（不是sublime_text） - 终端里运行：
ls -l /Applications/Sublime\ Text.app/Contents/SharedSupport/bin/subl，有输出才说明文件存在 - 如果报 “No such file”，说明你装的是旧版、便携版或第三方打包版 —— 官网 DMG 安装包才自带这个二进制，重装官网版最省事
创建软链接并确保 /usr/local/bin 在 PATH 中
macOS 上最稳的方式是软链接到 /usr/local/bin，但得保证这个路径被 zsh 加载了：
- 运行：
sudo ln -s /Applications/Sublime\ Text.app/Contents/SharedSupport/bin/subl /usr/local/bin/subl - 检查 PATH 是否含该目录：
echo $PATH | grep "/usr/local/bin"，没输出就得加 - 编辑
~/.zshrc，追加一行：export PATH="/usr/local/bin:$PATH" - 立即生效：
source ~/.zshrc - 注意：不要用
~/.zprofile或~/.zshenv替代，GUI 应用（如 iTerm 启动的窗口）只认~/.zshrc的导出逻辑
Apple Silicon（M1/M2/M3）用户额外注意路径差异
Homebrew 默认装在 /opt/homebrew，有些工具链会优先查这里；若 /usr/local/bin 不在 PATH 或权限受限，可换路径：
- 先确认 Homebrew bin 是否已存在：
ls /opt/homebrew/bin/，看有没有其他命令（如brew） - 若有，建链到那里：
sudo ln -s /Applications/Sublime\ Text.app/Contents/SharedSupport/bin/subl /opt/homebrew/bin/subl - 然后确保
~/.zshrc包含：export PATH="/opt/homebrew/bin:$PATH" - 再
source ~/.zshrc，否则which subl还是找不到
验证和常见失败点
做完上面三步，别直接关终端 —— zsh 的环境变量不会热更新：
- 新开一个终端窗口（不是新标签页），运行：
which subl，应输出/usr/local/bin/subl或/opt/homebrew/bin/subl - 再跑：
subl --version，能打印版本号才算真正通了 - 如果
which subl有结果但subl --version报错或静默退出，大概率是杀毒软件或 MDM 策略拦截了执行 —— 尝试用完整路径直接运行：/usr/local/bin/subl --version - Sublime 自己启动的构建系统（Build System）仍可能找不到
python或prettier，因为它们不读~/.zshrc—— 那是另一个问题，得在.sublime-build里写绝对路径
真正卡住人的往往不是链接没建对，而是 source ~/.zshrc 后没开新终端，或者误以为 GUI 启动的终端已经 reload 了 PATH。zsh 的加载时机很具体，不重启 shell 进程，改了也白改。
