subl 命令不存在需先确认路径并创建软链接：其真实路径为/Applications/Sublime Text.app/Contents/SharedSupport/bin/subl，须用sudo ln -s正确链接至/usr/local/bin，再确保该路径在$PATH中且重启终端验证。
subl 命令不存在？先确认 Sublime 自带的可执行文件位置
Mac 上的 subl 不是系统自带，而是 Sublime Text 安装包里预编译好的命令行工具，路径固定在：/Applications/Sublime Text.app/Contents/SharedSupport/bin/subl。如果你用的是 Sublime Text 4 或重命名过的 App（比如 Sublime Text Beta.app），路径中的 App 名必须完全匹配——少个空格、多“4”或漏“Beta”都会导致链接失败。
- 先验证它是否存在：运行
ls -l /Applications/Sublime\ Text.app/Contents/SharedSupport/bin/subl - 如果提示
No such file or directory，请打开 Finder →Applications文件夹，右键点击 Sublime 图标 → “显示包内容”，逐级展开确认真实路径 - Apple Silicon（M1/M2/M3）用户注意：部分自定义安装可能把 App 放在
/opt/homebrew/Caskroom/下，但这种情况极少见；优先查/Applications/
软链接到 /usr/local/bin 是最稳妥的配置方式
macOS 不允许直接修改系统 PATH 来包含 App 内部路径，所以不能靠改 shell 配置文件“绕过”——必须让 subl 成为终端能直接执行的命令。标准做法是创建符号链接，指向系统默认可执行目录 /usr/local/bin（该路径已在绝大多数 Mac 的 $PATH 中）。
- 执行命令前先确保目标目录存在：
sudo mkdir -p /usr/local/bin - 创建链接（注意反斜杠转义空格）：
sudo ln -s /Applications/Sublime\ Text.app/Contents/SharedSupport/bin/subl /usr/local/bin/subl - 如果用 Homebrew 安装的 Sublime（
brew install --cask sublime-text），Homebrew 会自动完成这一步，无需手动操作 - 别用
alias替代软链接——alias subl="..."在脚本、Git commit 编辑器、或subl --wait场景下会失效
subl --help 报错？检查 PATH 和链接状态
配置后终端仍提示 command not found，90% 是以下三个原因中的一个：
-
subl链接没生效：运行ls -l /usr/local/bin/subl，输出应类似subl -> /Applications/Sublime Text.app/.../subl；若显示No such file，说明源路径错了或 App 被移动过 -
/usr/local/bin不在当前 shell 的$PATH中：运行echo $PATH | grep local，没输出就需补上——Zsh 用户执行echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc - 终端没重启：改了环境变量或新建了链接，必须新开一个终端窗口（不是新标签页），否则旧进程不读新配置
验证成功的标志是：subl --help 输出帮助文本，或 subl --version 显示类似 Sublime Text Build 4169。
常用命令和容易被忽略的参数场景
subl 看似简单，但几个参数在实际开发中非常关键，尤其配合 Git、脚本或多人协作时：
-
subl .：在当前目录启动项目——但若已有 Sublime 窗口打开，默认会在该窗口新增标签页；加-n强制新开窗口：subl -n . -
subl --wait filename.txt：终端会卡住，直到你关闭这个文件才返回；这是 Git 配置core.editor的必需参数，否则 commit 会直接失败 -
subl file1.py file2.js：一次打开多个文件，顺序即标签页顺序 - 路径含中文或空格？没问题，
subl ~/Desktop/我的项目/可直接工作，shell 会自动处理
真正容易被忽略的点是：软链接一旦建立，后续 Sublime 升级不会影响它——因为链接指向的是 App Bundle 内部的 subl，而每次更新都会覆盖该文件。只要你不重命名或移走整个 App，这个配置就能一直用下去。
