subl命令默认不可用，必须先安装命令行工具：mac通过菜单安装，linux需手动建软链接，windows勾选add to path或手动配置；验证用which subl和subl --version。
subl 命令默认不可用，必须手动安装并验证路径，否则所有用法都无从谈起。
subl 命令不存在？先确认是否已安装命令行工具
很多人输 subl --help 直接报 command not found，不是 PATH 配错了，而是根本没装这个工具——它不随 Sublime Text 自动安装。
- macOS：打开 Sublime Text → 菜单栏 Sublime Text → Install Command Line Tool，执行后
/usr/local/bin/subl就有了（比手动建软链接更可靠，且自动处理空格和路径变更） - Linux：官方 tarball 版通常自带
subl可执行文件，但需手动创建软链接，例如：sudo ln -s /opt/sublime_text/subl /usr/local/bin/subl；Snap/Flatpak 安装的版本默认不提供subl - Windows：安装时勾选 “Add to PATH” 是最简方式；若漏选，可手动把
C:\Program Files\Sublime Text\加入系统环境变量 PATH，或在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 不代表能正常打开文件。常见“没反应”“终端卡住”“权限拒绝”多因 GUI 初始化失败或参数误用。
- SSH 连远程机器时执行
subl .会静默失败：Sublime 尝试调用本地桌面环境，但 SSH 会话无 DISPLAY 或 Wayland 协议支持；应加-n强制新开窗口：subl -n . - 终端卡住不动：默认
subl file.py是异步启动，立即返回；但加了-w（即--wait）会阻塞，直到文件关闭才退出命令——这在 Git 提交、脚本中是必需的，但在交互式终端里容易误以为“卡死” - macOS Catalina 及以后默认用 zsh，改了
~/.bash_profile没用，得改~/.zshrc并执行source ~/.zshrc - WSL 用户注意：Windows 的 PATH 不透传到 WSL，需在
~/.zshrc中显式添加 Windows 下 Sublime 的路径，如export PATH="/mnt/c/Users/xxx/AppData/Local/Sublime Text/Build 4143/:$PATH"
subl 如何精准跳转到某行某列？支持 : 行号语法但有兼容限制
subl main.py:25 这种写法确实能跳转到第 25 行，但并非所有平台和 Sublime 版本都稳定支持，尤其在带列号（如 main.py:25:8）时容易被忽略或解析失败。
- 基础用法有效：
subl script.js:42→ 打开并定位到第 42 行首 - 列号支持有限：
subl style.css:15:4在 Build 4143+ 版本中可用，旧版可能只认行号，列部分被丢弃 - 路径含空格必须加引号：
subl "my project/src/index.html:100"，否则 shell 会截断 - 该功能依赖 Sublime 的命令行解析器，不适用于通过
--command调用的场景（如subl --command "goto_line"需另写插件逻辑）
subl 怎么和 Git 或 Shell 脚本集成？-w 和 --command 是关键
让 subl 真正嵌入工作流，核心是控制进程生命周期和触发编辑器内部动作。
- Git 提交必须配
-w：git config --global core.editor "subl -w"；不加-w会导致 Git 认为编辑器瞬间退出，提交信息为空而中止 -
--command可调用内置命令，但参数格式严格：subl --command "set_setting {\"word_wrap\": true}" file.txt，JSON 部分需转义双引号 - 临时修改设置再打开文件，适合一次性操作：
subl -n -w --command "set_setting {\"draw_centered\": true}" README.md - 别名建议用函数而非简单 alias：在
~/.zshrc中定义st() { subl -n "$@"; }，比alias st='subl -n'更能正确处理带空格路径
最容易被忽略的是：GUI 权限、shell 配置文件加载时机、以及 -w 在不同终端（如 tmux pane、VS Code 内置终端）中的实际行为差异——这些不报错，但会让命令“看似有效实则失效”。
