Sublime Text 的 subl 命令在 macOS 终端报错需手动配置：Homebrew 安装最可靠，自动创建软链；手动配置须严格路径、加双引号、sudo 权限并确保 PATH 和 shell 配置生效；Package Control 应下载后拖入 Packages 文件夹安装。
装完 Sublime Text，subl 命令在终端里还是报 command not found？不是你下错了，是 macOS 默认根本不会注册这个命令——必须手动配，否则你就只能靠鼠标点开，没法配合 git difftool、脚本或日常快速编辑。
确认安装路径是否正确
Sublime Text 的 subl 可执行文件藏在应用包内部，路径固定但极易写错。常见两种命名：
/Applications/Sublime Text.app/Contents/SharedSupport/bin/subl-
/Applications/Sublime Text 4.app/Contents/SharedSupport/bin/subl（如果你装的是 ST4）
错误示例：/Applications/Sublime Text.app/ 末尾多一个斜杠 → 软链失效；复制时没加英文双引号 → 终端把 Sublime Text.app 拆成两个参数，直接报 ln: Text.app/Contents/SharedSupport/bin/subl: No such file or directory。
用 Homebrew 安装（推荐，自动处理路径）
这是最省事、最不容易出错的方式，尤其适合 Apple Silicon（M1/M2/M3）或 Intel 芯片用户：
- 先确保已装 Homebrew：
brew --version，没装就跑：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" - 执行：
brew install --cask sublime-text - 它会自动把
subl软链到：/opt/homebrew/bin/subl（M 系列）或/usr/local/bin/subl（Intel），无需手动sudo ln -s - 验证：
subl --version应输出类似Build 4169
注意：Homebrew 安装后，subl .、subl -n .、git config --global core.editor "subl --wait" 全部开箱即用。
手动创建软链接（适用于已拖 DMG 安装的用户）
不想引入 Homebrew？可以手动建链，但必须严格按步骤来：
- 先确认实际应用名：
ls /Applications | grep -i sublime，结果可能是Sublime Text.app或Sublime Text 4.app - 执行（以
Sublime Text.app为例）：sudo ln -s "/Applications/Sublime Text.app/Contents/SharedSupport/bin/subl" /usr/local/bin/subl（英文双引号不能少） - 如果
/usr/local/bin不存在，先建目录：sudo mkdir -p /usr/local/bin -
sudo是必须的，漏掉会提示Permission denied
完成后别急着用，还得检查三件事：ls -l /usr/local/bin/subl 看链接是否有效；echo $PATH | grep usr/local/bin 确认路径在 $PATH 里；改过 ~/.zshrc 后必须 source ~/.zshrc，否则新开终端还是找不到。
Package Control 装不上？绕过控制台，直接拖文件
官方控制台安装脚本在较新 macOS（尤其启用了 Full Disk Access 限制时）经常失败：卡住、报 urlopen error、装完重启也没反应。这不是网络问题，是沙盒机制拦截了远程加载。
- 去 packagecontrol.io/installation 页面，右键下载链接 → “另存为”，得到
Package Control.sublime-package - 终端执行：
open ~/Library/Application\ Support/Sublime\ Text\ 3/Packages/ - 把刚下的
Package Control.sublime-package文件直接拖进弹出的窗口（不要解压） - 重启 Sublime Text，按
Command + Shift + P输入Install Package能出来，就成功了
真正容易被忽略的点：装完 Package Control 后，Command + Shift + P 必须能唤出命令面板，且输入 Install Package 有响应——这才是插件系统真正活了的标志，光看菜单栏有没有“Package Control”选项没用。
