subl命令默认不可用，需先部署命令行工具：macOS通过菜单安装、Linux手动建软链接、Windows勾选Add to PATH或建bat文件；验证需新开终端运行which/where subl及subl --version。
subl 命令本身不随 Sublime Text 安装自动可用，必须先完成命令行工具部署，否则所有后续操作都无效。
subl 命令根本不存在？先确认是否已安装命令行工具
输入 subl --version 报 command not found，不是 PATH 配错了，而是 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，需换 deb/rpm 包或手动提取 - 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 不代表能正常打开文件。常见“没反应”“终端卡住”“只开空窗口”，多因当前 shell 无权调起 GUI 应用。
- macOS：确保终端是本地启动（Dock 或 Launchpad），而非通过 SSH 连入后执行；SSH 场景建议改用
open -a "Sublime Text" - Linux（Wayland）：GNOME 40+ 等桌面环境可能拦截 GUI 启动，可临时切回 X11，或强制加
subl --new-window - Windows：避免用 Git Bash 直接跑
subl，它常卡后台；改用 Windows Terminal、CMD 或 PowerShell - 小技巧：加
--wait参数让命令阻塞，适合脚本中等待编辑完成，例如subl --wait .gitignore
subl 常用参数怎么选？别误用 --background
--background 表面省事，实际容易导致编辑后忘记保存或窗口失焦，尤其当你顺手敲了 :wq 却发现还在 Vim 模式时。
-
subl .：打开当前目录为项目（最常用） -
subl -n .：强制新开独立窗口（避免混入已有工作区） -
subl file:123：直接跳转到第 123 行（支持行号定位） -
subl file1.txt file2.txt：同时打开多个文件（可用于 diff 比较） - 路径含空格或中文：必须用单引号包裹，如
subl 'my project/file.js'
最容易被忽略的是：即使 subl 命令能运行，构建系统（.sublime-build）也**不会继承你的 shell 环境变量**，所以终端里能跑的 prettier、python，构建时仍会报 command not found——这时必须用绝对路径写进构建配置。
