subl命令报command not found是因为官方DMG安装包不自动注册命令行工具，需手动建软链接并配置PATH；Intel Mac用/usr/local/bin/subl，Apple Silicon用/opt/homebrew/bin/subl，建链后须source ~/.zshrc验证。
subl 命令为什么在终端里直接报 command not found
不是你装错了，是 Sublime Text 官方 DMG 安装包压根不注册命令行工具。它只负责把应用放进 /Applications，subl 这个可执行文件藏在应用包内部，系统根本不知道它的存在。
常见错误现象：subl --version 报错、git difftool --tool=subl 失败、脚本里调用 subl . 无响应。
- 路径写错：比如把
/Applications/Sublime Text.app写成/Applications/Sublime Text.app/（末尾多斜杠）→ 软链指向失效 - 空格没处理：路径含空格但没加英文双引号，终端拆成两个参数 →
ln: Text.app/Contents/SharedSupport/bin/subl: No such file or directory - 权限漏掉
sudo：执行ln -s时不加sudo→Permission denied
Homebrew 安装比拖 DMG 更省事，但得看芯片类型
如果你还没装，直接用 Homebrew 是最稳的选择。它自动处理路径、权限、shell 配置，不用手敲一堆命令。
Intel Mac：brew install --cask sublime-text → subl 自动落到 /usr/local/bin/subl
Apple Silicon（M1/M2/M3）：brew install --cask sublime-text → 默认走 /opt/homebrew/bin/subl，无需额外操作
验证方式：which subl 应返回对应路径；subl --version 应输出版本号（如 Sublime Text Build 4169）
手动建软链接时，路径和 shell 配置必须同时到位
已用 DMG 安装？别卸载重装，删旧链重建即可。但光建链接不够，PATH 和 shell 配置缺一不可。
先确认实际应用名：ls /Applications | grep -i sublime，可能是 Sublime Text.app 或 Sublime Text 4.app
再建软链（注意双引号包裹含空格路径）：
sudo ln -s "/Applications/Sublime Text.app/Contents/SharedSupport/bin/subl" /usr/local/bin/subl
然后检查并补 PATH：
- Intel：
echo $PATH | grep usr/local/bin，没输出就加export PATH="/usr/local/bin:$PATH"到~/.zshrc - Apple Silicon：
echo $PATH | grep opt/homebrew/bin，没输出就加export PATH="/opt/homebrew/bin:$PATH"到~/.zshrc - 改完必须执行：
source ~/.zshrc，否则新开终端还是老样子
Package Control 安装失败，大概率是控制台脚本过期或目录权限不对
命令面板里搜不到 Install Package？说明 Package Control 没装上。官网提供的控制台脚本经常因域名变更或证书更新而失效（比如 sublime.wbond.net 已停用）。
推荐手动安装（绕过网络和脚本限制）：
- 访问
https://packagecontrol.io/installation#st3，下载Package Control.sublime-package - 按
Command + Shift + P→ 输入Browse Packages→ 回车打开 Packages 目录 - 在访达中按
Command + Shift + .显示隐藏文件，导航到：~/Library/Application Support/Sublime Text 3/Installed Packages/ - 把下载好的
Package Control.sublime-package文件拖进去，不要解压，重启 Sublime Text
重启后按 Command + Shift + P，输入 Install Package 能出现选项，才算真正生效。
