需手动创建软链接并配置PATH：Intel Mac执行sudo ln -s "/Applications/Sublime Text.app/Contents/SharedSupport/bin/subl" /usr/local/bin/subl，M1/M2+Homebrew用户用/opt/homebrew/bin/subl，并在~/.zshrc中添加对应PATH后source生效。
subl 命令报 command not found 怎么办
这是 macOS 上 Sublime Text 安装后最常遇到的问题——subl 命令根本不存在，不是你打错了，是系统压根没“认识”它。Sublime 不像 VS Code 那样自带 code 命令注册，它的命令行工具 subl 被藏在应用包内部，必须手动暴露给终端。
- 先确认 Sublime 确实装在
/Applications/Sublime Text.app（或Sublime Text 4.app）——路径错一个空格或大小写都会失败 - 别往
/usr/bin或/bin里硬塞，macOS 自 El Capitan 起启用 SIP（Rootless），这些目录默认不可写，强行sudo cp会报Operation not permitted - 正确做法是创建符号链接到
/usr/local/bin（Intel Mac）或/opt/homebrew/bin（Apple Silicon + Homebrew 用户），这两个路径天然在$PATH中且可写
怎么安全创建 subl 软链接
用 ln -s 创建软链接是最轻量、最可逆的方案，比改 $PATH 或加 alias 更可靠，尤其适合多 Shell（zsh/bash）、多用户环境。
- Intel Mac：运行
sudo ln -s "/Applications/Sublime Text.app/Contents/SharedSupport/bin/subl" /usr/local/bin/subl - M1/M2 Mac（且已用 Homebrew）：优先用
sudo ln -s "/Applications/Sublime Text.app/Contents/SharedSupport/bin/subl" /opt/homebrew/bin/subl - 路径中含空格必须用英文双引号包裹，漏掉会导致链接指向错误；末尾不能带斜杠，比如
Sublime Text.app/是错的 - 如果提示
Permission denied，不是权限不够，而是目标目录不存在——先执行sudo mkdir -p /usr/local/bin
为什么 subl --version 还是不生效
软链接建好了，但终端仍找不到 subl，大概率是 shell 没“看见”新路径。macOS Catalina 及之后默认用 zsh，~/.zshrc 必须显式加载才能生效。
- 检查
$PATH是否包含目标目录：echo $PATH | grep -E "(usr/local/bin|opt/homebrew/bin)" - 如果没输出，编辑
~/.zshrc，加上export PATH="/usr/local/bin:$PATH"（或对应 Homebrew 路径） - 保存后必须运行
source ~/.zshrc，否则新开终端也不会认——这点极容易被跳过 - 验证链接是否有效：
ls -l /usr/local/bin/subl应显示指向正确的subl文件，且目标路径能ls出来
subl 常用参数和 Git 集成场景
配好只是开始，subl 的真正价值在于嵌入工作流。它不是简单打开文件，而是支持项目级操作和阻塞式调用，特别适合脚本和 Git 工具链。
-
subl .：以当前目录为项目根打开，注意不是所有文件都能直接编辑，比如.git目录默认被忽略 -
subl -n .：强制新建窗口，避免误覆盖已有项目——多人协作时尤其有用 -
subl --wait filename.txt：阻塞终端直到文件关闭，可用于git commit编辑器配置 - Git diff 配置：
git config --global diff.tool subl+git config --global difftool.subl.cmd 'subl --wait "$LOCAL" "$REMOTE"'
最容易被忽略的是：软链接路径和 shell 配置必须严格匹配你的硬件架构与包管理习惯。M1 用户硬套 Intel 教程，或 Homebrew 用户还往 /usr/local/bin 写，十有八九卡在第二步。
