subl命令根本不存在，需先手动安装命令行工具：macos通过菜单栏install command line tool安装，linux需手动建软链接，windows须勾选add to path或手动配置环境变量；验证用which subl或where subl及subl --version。
subl 命令根本没配好，先别急着加参数
直接输 subl -n 报 command not found？不是参数写错了，是 subl 根本没装进系统路径。它不随 Sublime Text 自动安装，必须手动触发或配置。
macOS 最可靠方式：打开 Sublime Text → 菜单栏 Sublime Text → Install Command Line Tool；Linux（tarball 版）需手动建软链接，比如 sudo ln -s /opt/sublime_text/subl /usr/local/bin/subl；Windows 安装时务必勾选 Add to PATH，漏选就得手动把 C:Program FilesSublime Text 加进系统环境变量。
验证是否真可用：
- macOS/Linux：运行 which subl，有输出再跑 subl --version
- Windows：运行 where subl，再试 subl --help
常用参数组合怎么选，关键看使用场景
参数不是越多越好，乱加反而导致行为不可控。重点盯住三个高频需求：
-
subl -n：强制新开窗口，适合同时处理多个互不干扰的项目（比如一边改前端，一边看后端日志） -
subl -w或subl --wait：终端阻塞等待文件关闭，Git 提交信息、脚本中编辑临时配置时必须加，否则命令直接返回，后续逻辑就断了 -
subl file.py:42：冒号后直接跟行号，跳转精准，调试时比鼠标滚半天快得多；支持:line:col，比如subl index.html:15:8
注意：-n 和 -a（追加到当前窗口侧边栏）互斥，同时用以 -n 为准；-w 在 macOS 上对文件夹无效，只对单个文件生效。
Windows 路径空格和引号，漏掉就报错
Windows 用户最容易栽在这儿：路径含空格却不加引号，比如 subl.exe C:Program Filesprojectmain.py，shell 会把 Program 当成命令、Filesprojectmain.py 当成参数，直接报错或打开错位置。
必须写成：subl.exe "C:Program Filesprojectmain.py"
其他易错点：
- Git Bash 中直接跑 subl 常卡后台，换用 Windows Terminal 或 PowerShell
- 构建系统里写路径别用反斜杠，"C:\Users\prettier.cmd" 会解析失败，得用正斜杠："C:/Users/prettier.cmd"
想设为 Git 默认编辑器，-n -w 组合不能少
执行 git config --global core.editor "subl -n -w" 后，git commit 才能真正等你编辑完再继续提交流程。
只写 subl：窗口弹出来，但终端立刻返回，Git 直接用空提交信息走完流程
只写 subl -w：如果已有 Sublime 窗口在运行，新文件可能被塞进旧窗口，导致上下文混乱，甚至覆盖未保存内容
所以 -n -w 是生产环境最稳妥的组合——既隔离项目，又保证阻塞行为可预测
另外，--background 看似省事，实则危险：窗口不聚焦、保存后也不自动退出终端，容易误以为“编辑完了”，结果 :wq 按了 Vim 模式键却没反应。
