subl命令无法识别需手动创建软链接至/usr/local/bin/subl并确保该路径在$path中；sublime text 4的二进制路径为/applications/sublime text.app/contents/sharedsupport/bin/subl，链接后可用subl --help验证。
subl 命令无法识别：PATH 配置必须指向正确二进制路径
Mac 上默认安装的 Sublime Text 4，subl 命令软链接通常不在系统 PATH 中。直接运行 subl . 报错 command not found: subl 是最常见起点。
正确做法是手动创建符号链接：
- 确认 Sublime 安装位置：
/Applications/Sublime Text.app/Contents/SharedSupport/bin/subl - 执行：
sudo ln -sf "/Applications/Sublime Text.app/Contents/SharedSupport/bin/subl" /usr/local/bin/subl - 验证：
subl --help应输出帮助信息；若仍失败，检查/usr/local/bin是否在$PATH中（echo $PATH）
注意：不要用 Homebrew 的 brew install --cask sublime-text 自动配置，它不自动建 subl 链接；也不建议链接到 /usr/bin（macOS SIP 会拦截）。
在终端中精准打开文件并定位到指定行/列
subl 支持行号和行列定位，但语法容易写错——漏掉冒号、多加空格、混淆列与行顺序都会导致跳转失败。
- 打开文件第 42 行：
subl path/to/file.py:42 - 打开第 42 行第 15 列：
subl path/to/file.py:42:15 - 多个文件同时带定位：
subl main.go:100 utils.go:23:5 - 相对路径需确保当前工作目录正确，否则路径解析失败（不会报错，但打开空白或错误文件）
该功能依赖 Sublime 内部的 load_file 命令行为，不支持正则匹配或模糊行号（如 :~42 无效）。
通过命令行传递参数控制窗口行为：--new-window 与 --add
默认情况下，subl . 会在已有窗口中新增标签页；但协作或调试时，常需隔离工作区。
-
subl --new-window .：强制新建独立窗口（不复用已有实例） -
subl --add .：将当前目录添加为新文件夹到**当前窗口**的侧边栏（Sublime Text 4.4+ 才支持） -
subl --project my-project.sublime-project：直接加载项目文件（比先开软件再 File → Open Project 更快） - 混用时注意顺序：
subl --new-window --project p.sublime-project有效；但--project放前面可能被忽略
Windows 用户注意：subl.exe 对 --add 支持不稳定，建议优先用 --new-window 避免意外合并窗口。
subl --wait 在脚本中阻塞执行的典型误用与修复
--wait 常用于 shell 脚本中“编辑后继续”，比如修改配置再重启服务。但实际中极易卡住或提前返回。
- 正确用法：
subl --wait config.json && systemctl restart app - 常见陷阱：未加
--wait就直接&&后续命令，导致编辑还没保存就执行了重启 - 更隐蔽的问题：如果 Sublime 已关闭或崩溃，
--wait会永远挂起；建议加超时保护：timeout 300 subl --wait config.json - Linux 下若 Sublime 以 sandbox 方式启动（Flatpak），
--wait可能完全失效——此时应改用原生 deb/rpm 包
这个参数的底层机制是进程间通信等待 Sublime 发送“文件已关闭”信号，任何 UI 层中断（如强制 Quit、kill -9）都会让终端卡死，务必在自动化流程中设兜底。
