subl命令需手动安装：macOS通过菜单安装命令行工具，Linux需手动创建软链接，Windows安装时勾选Add to PATH或手动配置；SSH下需加-n参数，Git提交需-w参数，-n与-a互斥，Console中不可执行shell命令。
subl 命令根本不存在，得先装
输 subl 报 command not found，不是 PATH 没配对，是压根没装这个工具。Sublime Text 安装包默认不带命令行支持。
- macOS：菜单栏 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 版本默认不提供 - 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 --help ≠ 能正常打开文件
很多“卡住”“弹空窗口”“没反应”，本质是 Sublime 启动时拿不到有效的桌面会话。
- SSH 连上去直接跑
subl .？失败概率极高——它需要DISPLAY或 Wayland 协议，而 SSH 默认不转发。加-n强制新开窗口：subl -n . - macOS 上用 Terminal 通过 ssh 登录后启动，
subl会静默失败；改用open -a "Sublime Text"或从 Dock 启动终端再试 - WSL 用户注意：
subl不会自动继承 Windows 的 PATH，得在~/.zshrc里显式加：export PATH="/mnt/c/Users/xxx/AppData/Local/Sublime Text/Build 4143/:$PATH" - Git 提交时用
git commit触发编辑器？必须加-w（即--wait），否则 Git 会立刻继续执行，导致提交信息丢失
subl 参数别乱加，-n、-w、-a 用错就反效果
--background 看起来省事，但它会让 Sublime Text 启动后不聚焦到窗口，编辑完保存也容易被忽略——尤其当你顺手敲了 :wq 却发现没退出 Vim 模式时。
-
subl file.txt：最安全，默认行为，焦点进编辑器 -
subl -n：强制新开一个独立窗口（避免复用已有窗口导致项目混乱） -
subl -w：等文件关闭后再返回终端（--wait的简写，脚本里必备） -
subl -a folder/：追加到当前窗口的侧边栏（不是新建窗口），适合临时补几个文件
注意：-n 和 -a 互斥，同时用会以 -n 为准；-w 在 macOS 上对文件夹无效，只对单个文件生效。
Console 控制台不是终端，别输 shell 命令
Ctrl + `（macOS 是 Cmd + `）打开的是嵌入式 Python 解释器，不是 bash/zsh，也不是浏览器 DevTools。输 ls 或 pwd 会直接报 NameError，这不是 bug，是设计如此。
它能调用全部公开 Sublime API：
-
sublime.active_window().active_view().file_name()查当前文件 -
sublime_plugin.reload_plugin("Git")重载插件 -
sublime.run_command("refresh_folder_list")刷新侧边栏
插件里的 print() 默认不输出——必须先去菜单 Tools → Developer → Log Console Messages 勾选启用，否则日志全被屏蔽。
真正容易被忽略的，是 GUI 启动上下文和 shell 环境变量的隔离——哪怕 subl 命令能跑，它也不一定继承你终端里定义的 alias、PATH 或 .env 配置。调试时优先确认启动方式（是从 Dock 启动的终端？还是 tmux 里起的？），而不是反复检查命令拼写。
