Sublime Text 的 subl 命令需手动配置才能在 macOS 终端使用：确认应用路径（如 Sublime Text.app 或 Sublime Text 4.app），推荐用 Homebrew 安装自动注册，或手动创建软链接至 /usr/local/bin/subl；验证需检查链接存在、PATH 包含对应目录、shell 配置（zshrc）正确并 source 生效；常用命令包括 subl .、subl -n . 等。
subl 命令在 macOS 上默认不可用，必须手动配置才能从终端启动 Sublime Text —— 这是绝大多数人安装后第一件该做的事，否则你只能靠鼠标点开，失去开发效率。
确认安装路径是否正确
Sublime Text 的命令行工具 subl 实际藏在应用包内部，路径固定但易出错：/Applications/Sublime Text.app/Contents/SharedSupport/bin/subl
如果你下载的是 Sublime Text 4（比如 4169 版），名称可能是 Sublime Text 4.app，路径就得改成：/Applications/Sublime Text 4.app/Contents/SharedSupport/bin/subl
常见错误：复制路径时漏掉空格转义，或把 Text.app 错写成 Text.app/（末尾斜杠会导致链接失败）。
创建 subl 全局命令的两种可靠方式
推荐优先使用 Homebrew 安装（自动处理路径和权限）：
brew install --cask sublime-text
它会自动把
subl 注册进 /opt/homebrew/bin/（Apple Silicon）或 /usr/local/bin/（Intel），无需手动软链。若已手动安装 .dmg 版本，则执行：
sudo mkdir -p /usr/local/bin
sudo ln -s "/Applications/Sublime Text.app/Contents/SharedSupport/bin/subl" /usr/local/bin/subl
注意：路径含空格，必须用英文双引号包裹；
sudo 是必须的，否则权限不足。
验证和排错：为什么 subl 还是报 command not found
执行 subl --version 报错？检查以下三点：
- ls -l /usr/local/bin/subl 是否存在且指向有效路径
- echo $PATH 输出中是否包含 /usr/local/bin 或 /opt/homebrew/bin
- 如果用的是 zsh（macOS Catalina 及以后默认），确认 ~/.zshrc 里有：
export PATH="/usr/local/bin:$PATH"
或（M1/M2 芯片）：
export PATH="/opt/homebrew/bin:$PATH"
改完记得
source ~/.zshrc，否则不生效。
常用命令与实用场景
配好 subl 后，这些操作能立刻提升效率：
- subl .：在当前目录打开整个项目（等效于“用 Sublime 打开这个文件夹”）
- subl -n .：强制新建窗口，避免误覆盖已有项目
- subl README.md：快速编辑文档，比 Finder 双击快 3 秒以上
- git difftool --tool=subl：配合 Git 做文件对比（需先配置 diff 工具）
注意：subl 不是后台服务，关闭窗口后进程即退出；多次调用不会累积多个实例，这点比 VS Code 更轻量。
路径大小写、空格转义、shell 配置文件类型（zsh vs bash）、芯片架构差异（Intel vs Apple Silicon）——这四点没对齐，subl 就大概率失效。别跳过验证步骤，哪怕只多敲一行 ls -l。
