subl命令根本不存在，需先安装命令行工具：macOS通过菜单栏Install Command Line Tool安装，Windows安装时勾选Add to PATH，Linux需手动建软链接；验证用which subl或where subl及subl --version。
subl 命令根本不存在？先装命令行工具，不是配 PATH 的问题
输 subl --version 报 command not found，90% 情况下不是 PATH 没写对，而是压根没安装这个命令行工具。它不随 Sublime Text 自动部署，必须显式触发。
- macOS 用户：打开 Sublime Text → 菜单栏 Sublime Text → Install Command Line Tool，它会自动创建
/usr/local/bin/subl软链，并处理路径空格、应用重命名等边界情况 - Windows 用户：安装时务必勾选 Add to PATH；若已安装却没勾选，手动把
C:\Program Files\Sublime Text\加入系统环境变量（不是bin或SharedSupport\bin） - Linux（deb/rpm 安装）：通常自带；但 tarball 或 Snap/Flatpak 版本默认不提供
subl，得手动建链或换源
验证是否成功：运行 which subl（macOS/Linux）或 where subl（Windows），有输出再跑 subl --version 看能否返回 Build 号。
macOS 手动建软链失败的三个典型原因
即使你执行了 sudo ln -s，也常因细节翻车。最常见的是：
-
/Applications/Sublime Text.app/末尾多了一个斜杠 →ln会认为目标路径不存在，链接失效 - 路径含空格但没加英文双引号 → 终端把
Sublime Text.app拆成两个参数，报错ln: Text.app/Contents/SharedSupport/bin/subl: No such file or directory -
/usr/local/bin目录本身不存在 → 必须先sudo mkdir -p /usr/local/bin，否则ln会静默失败
正确写法（以 ST4 为例）：sudo ln -s "/Applications/Sublime Text 4.app/Contents/SharedSupport/bin/subl" /usr/local/bin/subl
Homebrew 安装为什么更推荐？
它绕开了所有路径判断和权限陷阱，尤其适合 Apple Silicon（M 系列芯片）用户：
- 执行
brew install --cask sublime-text后，subl自动落到/opt/homebrew/bin/subl（M 系列）或/usr/local/bin/subl（Intel） - 无需
sudo，不碰系统目录，升级/卸载干净 - 后续命令如
git config --global core.editor "subl --wait"、subl -n .全部开箱即用
注意：Homebrew 本身需先安装，命令是 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
subl 能用了，但打开文件卡住或没反应？检查 -w 和 GUI 上下文
能跑 subl --help 不代表能正常编辑。终端“卡住”或窗口不弹出，往往是因为：
- 用了
-w但没配-n→ 复用已有窗口时，GUI 初始化可能被阻塞在后台，导致终端挂起 - 在 tmux、某些 IDE 内置终端或 SSH 会话中运行 → 缺少 DISPLAY 或 GUI session 权限，
subl无法唤起图形界面 - 路径含中文或特殊字符但没加引号 →
subl my project/file.js会被拆成多个参数，报错或打开空白文件
稳妥组合是：subl -n -w "path/to/file.js"，尤其用于 git commit 等需要同步等待的场景。
