Sublime Text 默认不自动注册 subl 命令，需手动安装命令行工具：macOS 通过菜单启用，Linux 手动建软链，Windows 安装时勾选“Add to PATH”或手动添加路径；PATH 修改后须重载 shell 配置或重启终端。
subl 命令根本不存在，不是 PATH 配错了
终端报 command not found: subl，90% 的情况不是环境变量写错，而是系统压根没这个可执行文件。Sublime Text 官方安装包（无论 macOS DMG、Windows .exe 还是 Linux tarball）默认都不自动注册 subl 命令行工具——它得你手动“激活”。
验证方法很简单：
macOS/Linux 执行 which subl，Windows 执行 where subl；如果无输出，说明命令还没装上，别急着改 PATH。
- macOS 最稳方式：打开 Sublime Text → 菜单栏 Sublime Text → Install Command Line Tool（会自动建软链并处理空格路径）
- Linux tarball 版：
subl可执行文件通常在解压目录根路径，需手动建软链，如sudo ln -s /opt/sublime_text/subl /usr/local/bin/subl - Windows 官方安装器：安装时必须勾选 Add to PATH（仅 Windows 10/11 新版安装器支持）；若漏选，直接把
C:\Program Files\Sublime Text\整个路径加进系统 PATH，不能只加子目录
PATH 配了但 still not found？shell 没 reload 是硬伤
PATH 改完，旧终端窗口不会自动加载新配置——这是操作系统行为，不是 Sublime 的问题。
- macOS/Linux：确认你改的是当前 shell 的初始化文件。Catalina 及之后默认用 zsh，应改
~/.zshrc，不是~/.bash_profile；改完必须运行source ~/.zshrc，否则新开终端也不生效 - Windows：关掉所有 CMD/PowerShell/Windows Terminal 窗口，再新开一个；用
echo %PATH%检查是否真含 Sublime 路径（搜索关键词Sublime） - WSL 用户特别注意：Windows 的 PATH 不透传到 WSL，需在
~/.zshrc里显式添加 Windows 下 Sublime 的路径，例如export PATH="/mnt/c/Users/xxx/AppData/Local/Sublime Text/Build 4169/:$PATH"
软链接建好了还是不行？路径、权限、空格三连坑
手动建软链是最容易翻车的环节，常见错误全是细节：
- 路径含空格但没加英文双引号：比如
sudo ln -s /Applications/Sublime Text.app/...→ 终端拆成两个参数，报错No such file or directory；正确写法是sudo ln -s "/Applications/Sublime Text.app/Contents/SharedSupport/bin/subl" /usr/local/bin/subl - 权限不够：不加
sudo，提示Permission denied（尤其往/usr/local/bin或/opt/homebrew/bin写） - 目标路径已存在：报
File exists就别硬覆盖，先删旧链：sudo rm /usr/local/bin/subl，再重建 - Apple Silicon Mac 用 Homebrew 安装时，默认软链落在
/opt/homebrew/bin/subl，而非/usr/local/bin/subl；检查echo $PATH是否含/opt/homebrew/bin，不含就补export PATH="/opt/homebrew/bin:$PATH"
subl --version 成功但 subl . 没反应？GUI 上下文缺失
subl --version 能返回结果，说明命令本身可用；但 subl . 无响应或报 Permission denied，大概率是 GUI 启动失败，和 PATH 无关。
- SSH 连远程机器时：本地没桌面环境，
subl .会静默失败；必须加-n强制新开窗口：subl -n . - macOS Sonoma+ 或启用了 Full Disk Access 限制时：终端可能无法把当前工作目录“传递”给 Sublime；尝试用绝对路径：
subl "$(pwd)" - 加了
-w（即--wait）却卡住：这是正常行为——它会阻塞直到你关闭文件，适合 Git 提交流程，但在交互式终端里容易误判为卡死
真正卡点往往不在 PATH 本身，而在软链接是否指向真实存在的二进制、shell 配置是否被当前终端实际加载、以及 GUI 应用能否从终端继承正确的执行上下文。这三个地方任意一个断掉，subl 就只是个能打印版本号却打不开文件的“半成品”。
