subl --help 报 command not found 是因命令未安装；需先用 which subl（macOS/Linux）或 where subl（Windows）验证存在，再运行 subl --version 确认可用。
subl --help 会报错？先确认命令是否存在
输 subl --help 报 command not found，不是参数记错了，而是 subl 命令压根没装好。Sublime Text 安装包默认不带这个命令行工具，必须单独启用或部署。
验证方式很简单：
- macOS/Linux：运行
which subl，有输出（比如/usr/local/bin/subl）才算存在 - Windows：运行
where subl，能列出路径才说明可用 - 再跑一次
subl --version，能打印版本号（如Sublime Text Build 4162），才能继续看参数
subl --help 不显示帮助？试试 subl -h 或直接查文档
subl --help 在某些旧版或非官方构建中可能静默退出或无响应，这不是你终端的问题，是二进制本身不支持完整 help 输出。可靠做法是：
- 优先用
subl -h（短选项更稳定，多数版本都支持） - 若仍无输出，打开 Sublime Text → 菜单栏 Help → Documentation，搜索 “command line” 直达官方参数说明页
- 关键参数其实就几个，记不住时直接试：
subl -n .、subl -w file.js、subl file.py:42，比翻 help 更快
哪些参数实际有用？别被文档吓住
官方文档列了十来个参数，但日常真用得上的就四个，其余要么已废弃，要么只在特定场景生效：
-
-n：强制新开窗口，避免复用已有项目窗口导致混乱（尤其多项目并行时） -
-w（等价于--wait）：终端阻塞，等文件关闭才返回，写脚本改.gitignore或临时编辑配置时必备 -
-a：把文件/文件夹追加到当前窗口侧边栏，不是新开标签页，适合补几个零散文件 -
file:line或file:line:column：行号定位，但冒号不能少、空格不能多、顺序不能反（file.py:42:15对，file.py 42错）
像 --background 这种参数，表面是“后台启动”，实际会导致窗口不聚焦、保存后也无感知，容易误操作，建议跳过。
Windows 用户特别注意路径和空格
在 Windows 上，subl 实际调用的是 subl.exe，但很多用户卡在这几步：
- 路径含空格（如
C:\Program Files\Sublime Text）时，必须用双引号包裹整个路径，否则subl C:\Program Files\test.py会被拆成三个参数，subl只收到C:\Program - 终端类型影响行为：Git Bash 下
subl常卡住或无反应，换 Windows Terminal 或 PowerShell 更稳 - 如果
subl --version能跑但subl test.py打不开，先检查文件路径是否真实存在——Sublime 不提示“no such file”，只会开空白窗口或静默失败
最易被忽略的一点：所有行号定位（:42）和多文件打开（file1.js file2.css）都依赖当前终端的工作目录。cd 错了，subl src/index.ts:10 就会打不开或跳错位置，且不报错。
