subl命令默认不可用，需手动配置：Windows需建subl.bat并加路径到PATH，macOS/Linux需建软链接至/usr/local/bin并确保其在PATH中，验证用subl --help。
subl 命令不是默认可用的，必须手动配置系统 PATH 才能从终端直接调用；没配好就执行 subl，只会报 command not found 或 'subl' is not recognized as an internal or external command。
Windows 下如何让 subl 在 CMD/PowerShell 中生效
Sublime Text 安装时默认不注册 subl 命令，需手动创建批处理文件并加入系统环境变量。
- 找到 Sublime Text 主程序路径，通常是
C:\Program Files\Sublime Text\sublime_text.exe（v4）或C:\Program Files\Sublime Text 3\sublime_text.exe（v3） - 在该目录下新建文本文件，重命名为
subl.bat，内容为：@"%~dp0sublime_text.exe" %*
- 将该目录（例如
C:\Program Files\Sublime Text）添加到系统环境变量PATH中（需重启终端或重新登录） - 验证：打开新 PowerShell 窗口，运行
subl --help，应输出帮助信息
注意：不要用软链接（mklink），Windows CMD 对软链接支持不稳定；也不建议把 subl.bat 放到 %USERPROFILE%\AppData\Local\Microsoft\WindowsApps 这类路径，容易被系统覆盖或权限拦截。
macOS/Linux 下 subl 的正确安装方式
官方推荐用 shell 脚本封装二进制，但必须确保脚本有可执行权限且路径在 $PATH 中。
- 先确认 Sublime Text 应用位置：
/Applications/Sublime Text.app/Contents/SharedSupport/bin/subl（v4）或/Applications/Sublime Text 3.app/Contents/SharedSupport/bin/subl（v3） - 运行命令建立软链接：
sudo ln -sf "/Applications/Sublime Text.app/Contents/SharedSupport/bin/subl" /usr/local/bin/subl
- 如果
/usr/local/bin不在$PATH中（如某些 macOS Monterey+ 系统），需在~/.zshrc或~/.bash_profile中追加：export PATH="/usr/local/bin:$PATH"
，然后source ~/.zshrc - 验证：
subl --version应输出类似Sublime Text Build 4169
常见错误：直接复制 subl 文件到 /usr/bin 会导致权限拒绝（macOS SIP 保护）；用 alias subl="open -a 'Sublime Text'" 只能打开应用，无法传参（如跳转行号、打开指定文件）。
subl 常用参数与真实开发场景
subl 不只是“打开编辑器”，它是连接终端工作流的关键入口，参数组合直接影响效率。
-
subl .：在当前目录启动项目，自动加载侧边栏；若已在 Sublime 中打开其他窗口，会复用已有进程（避免多开） -
subl file.js:12：打开file.js并跳转到第 12 行（注意冒号分隔，不是-n 12） -
subl -n：强制新建窗口（不复用），适合对比两个独立项目 -
subl -w：wait 模式，常用于 Git commit 编辑器（git config --global core.editor "subl -w"），提交时会阻塞终端直到关闭文件 -
subl --command "expand_selection {"：直接执行内部命令（需知道确切命令名），比写插件更快捷
⚠️ 容易忽略的点：subl 默认不继承当前 shell 的 $PATH（尤其在 GUI 启动时），导致插件中调用的 CLI 工具（如 node、python）找不到；解决方法是在 Sublime 的 Preferences → Settings 中显式设置：
"path": "/usr/local/bin:/opt/homebrew/bin"
