subl命令根本不存在，需先安装命令行工具：macOS通过菜单栏Install Command Line Tool自动创建软链接，Linux需手动建软链接，Windows须勾选Add to PATH或手动配置；验证用which subl或where subl及subl --version。
subl 命令根本不存在，得先装命令行工具
输 subl --version 就报 command not found？不是 PATH 没配对，而是 Sublime Text 安装包压根没自带 subl 这个可执行文件——它必须手动启用或部署。
macOS 最可靠方式：打开 Sublime Text → 菜单栏 Sublime Text → Install Command Line Tool。执行后，/usr/local/bin/subl 自动创建，路径含空格、升级换版本都不用再管。
Linux（tarball 版）需手动建软链接：sudo ln -s /opt/sublime_text/subl /usr/local/bin/subl；Snap/Flatpak 版本默认不提供 subl，得换源或改用其他安装方式。
Windows 安装时务必勾选 Add to PATH；若漏选，要么把 C:\Program Files\Sublime Text\ 加进系统环境变量，要么在 C:\Windows\System32 下建 subl.bat（内容为 @start "" "C:\Program Files\Sublime Text\sublime_text.exe" %*）。
验证是否成功：which subl（macOS/Linux）或 where subl（Windows）有输出，再跑 subl --version 能返回版本号，才算真正可用。
subl 启动失败或卡住，大概率是 GUI 上下文不对
能运行 subl --help 不代表能正常打开窗口——SSH 连服务器后直接敲 subl .，终端会卡住或静默失败，因为本地 GUI 会话不可达。
常见“没反应”场景：
- 在远程 SSH 终端里调用
subl：无效，应改用scp拉取或直接用vim - macOS 上通过
tmux或某些终端复用会话启动：GUI 权限可能被拦截，新开一个纯净终端窗口再试 - Windows WSL 中执行
subl：WSL 默认无 GUI 支持，需额外配置 X Server 或改用 Windows 原生终端
绕过窗口复用逻辑，强制新开独立窗口：subl --new-window .，适合调试多项目或避免和已有工作区混淆。
subl 打开文件但定位错行，语法容错极低
subl path/to/file.py:42 看似简单，但漏掉冒号、多加空格、行列顺序颠倒，都会导致跳转失败——且不报错，只是静默打开空白文件或错误位置。
正确写法必须严格满足：
- 行号定位：
subl path/to/file.py:42（冒号前不能有空格，后不能有多余字符） - 行列双定位：
subl path/to/file.py:42:15（列号必须在第二个冒号后，不能写成:15:42） - 多个文件带定位：
subl main.go:100 utils.go:23:5（每个路径+定位独立，不支持逗号分隔） - 相对路径依赖当前工作目录：
subl ./src/index.ts:10在错误目录下执行，会打开空白或报 “no such file”，但不会提示
subl 被 Git 或脚本调用时阻塞失败，-w 参数必须显式加
设 export EDITOR='subl' 后，Git commit 弹出空白窗口就卡住，是因为 Git 需要编辑器「阻塞等待」并返回编辑结果，而默认 subl 是异步启动的。
必须用 -w（wait）参数：
- 临时生效：
git config --global core.editor "subl -w" - 全局设置：
export EDITOR='subl -w'（写入~/.zshrc并source） - 注意：
-w只对单文件有效；若 Git 需要编辑多个文件（如 rebase todo list），建议改用subl -n -w新窗口模式，避免干扰主工作区
容易忽略的一点：如果构建系统（.sublime-build）里调用了 subl，也得加 -w，否则 shell 脚本会卡在那不动。
