Sublime Text在macOS安装后默认无subl命令,需手动建软链或用Homebrew安装;Intel走/usr/local/bin/subl,Apple Silicon走/opt/homebrew/bin/subl;验证需检查链接、PATH及source配置。

Sublime Text 在 macOS 上装完不能直接用 subl?对,这是默认行为
macOS 下双击安装 Sublime Text 后,subl 命令在终端里根本不存在——这不是你装错了,是官方压根没帮你注册进系统路径。不配这个命令,你就只能手动打开 Finder → Applications → 点开它,完全没法配合 git、脚本或日常快速编辑。
- 必须手动创建符号链接,或者用 Homebrew 安装来绕过这步
- 路径里含空格(比如
Sublime Text.app),不加英文双引号包裹就会失败 -
/usr/local/bin/subl是 Intel 芯片常用位置;M1/M2 芯片更推荐走/opt/homebrew/bin/subl(尤其你用 Homebrew 安装时) - 执行
sudo ln -s时漏掉sudo会提示 “Permission denied”,不是路径写错了,是权限不够
怎么确认 subl 真的能用了?别只信 “没报错”
运行完软链命令,很多人输个 subl --version 看见输出就以为搞定了,其实还差三步验证:
- 先查链接是否存在且有效:
ls -l /usr/local/bin/subl或ls -l /opt/homebrew/bin/subl,输出里得有明确指向/Applications/.../subl的箭头 - 再看
$PATH是否包含该目录:echo $PATH | grep -E "(usr/local/bin|opt/homebrew/bin)",没有就得补export PATH="..."到~/.zshrc - 改完
~/.zshrc必须source ~/.zshrc,否则新开终端还是老样子
Homebrew 安装比拖 DMG 更省事,但要注意芯片架构
如果你还没装 Sublime,直接用 Homebrew 是最稳的选择,它自动处理路径、权限和 shell 配置,不用手敲一堆命令。
- Intel Mac:
brew install --cask sublime-text→subl自动落到/usr/local/bin/ - Apple Silicon(M1/M2/M3):
brew install --cask sublime-text→ 默认走/opt/homebrew/bin/,无需额外操作 - 已手动安装了 DMG 版?别卸载重装,直接删掉旧软链再按当前芯片类型重建即可
- Homebrew 安装后,
subl .打开当前项目、subl README.md编辑单文件、git difftool --tool=subl对比改动,全都能立刻用
常见错误:路径写错、空格没转义、壳没重载
这些不是“小问题”,而是导致 subl 始终 command not found 的真实原因:
- 把
/Applications/Sublime Text.app错写成/Applications/Sublime Text.app/(末尾斜杠)→ 软链失效 - 复制路径时没加引号,终端把
Sublime Text.app拆成两个参数 → 报错ln: Text.app/Contents/SharedSupport/bin/subl: No such file or directory - 用的是 zsh(macOS Catalina 起默认),却把
export PATH=...写进了~/.bash_profile→ 完全不生效 - 改完
~/.zshrc没source,或者开了新终端但忘了关旧终端 → 还是在旧环境里测试











