subl 命令不存在是因未安装命令行工具：macos需菜单安装，linux tarball版需手动软链，windows需勾选path或配环境变量；验证用which/where，再试--version。
subl 命令根本不存在？先装命令行工具
输 subl --version 报 command not found，不是 PATH 配错了，而是 Sublime Text 根本没安装命令行工具——它从不随主程序自动部署。
- macOS：打开 Sublime Text → 菜单栏 Sublime Text → Install Command Line Tool，自动把
subl软链接到/usr/local/bin/subl，比手动建链更稳（处理空格、路径变更、权限） - Linux（tarball 版）：运行
sudo ln -s /opt/sublime_text/subl /usr/local/bin/subl；Snap/Flatpak 版默认不提供subl，得换 deb 包或用 alias 临时补救 - 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 ≠ 能正常打开文件。常见“没反应”“终端卡住”“只开空白页”，多因 GUI 初始化失败或参数误用。
- macOS：别在 SSH 终端里直接跑
subl .，GUI 应用需要桌面会话；改用open -a "Sublime Text" .或确保终端是从 Dock/Launchpad 启动的 - Linux（Wayland）：GNOME 40+ 等环境可能拦截 GUI 启动，切回 X11，或强制加
subl --new-window - Windows：避免用 Git Bash 直接调
subl，容易挂后台；推荐 Windows Terminal 或 PowerShell - 路径含空格或中文：必须用单引号包裹，如
subl 'my project/file.js'；Windows 反斜杠\在 PowerShell 里是转义符，统一用正斜杠/
如果打开后是空白标签页，大概率是路径根本不存在——subl 不报错也不提示，只会新建未命名文件。
subl -w 和 subl -n 别混用，它们解决完全不同的问题
-w（wait）和 -n（new window）常被当成“提速开关”，其实语义完全不同，乱搭反而让脚本卡死。
-
subl -w file.txt：阻塞终端，等你关闭该文件标签后才返回控制权，适合git commit这类需编辑完成才继续的场景 -
subl -n .：强制新建独立窗口，避免复用已有窗口导致项目上下文混乱（比如同时开两个不同 Git 仓库） - 在 tmux 或某些 IDE 内置终端中，
-w可能失效；稳妥做法是subl -n -w file.txt，既隔离窗口又保证阻塞行为
注意：-w 对目录无效（subl -w . 会直接忽略 -w），只对具体文件起作用。
构建系统里调不到 prettier/eslint？别指望 shell 配置自动生效
你在终端能跑 prettier --write test.js，但 Sublime 构建系统报 command not found，很正常——Sublime 的构建系统不读你的 .zshrc 或 .bash_profile，只继承系统级环境变量。
- 唯一可靠解法：用绝对路径。先在终端跑
which prettier（如输出/opt/homebrew/bin/prettier） - 新建构建系统（Tools → Build System → New Build System），填入：
{ "cmd": ["/opt/homebrew/bin/prettier", "--write", "$file"], "selector": "source.js, source.jsx" } - Windows 用户注意：
cmd数组里每个元素必须是独立字符串，路径用正斜杠，别写成"C:\Users\prettier.cmd"——反斜杠会被解析失败
最易被忽略的点：构建系统里的 $file 是当前文件的完整路径，但如果你在符号链接目录里编辑，$file 返回的是真实路径，不是链接路径——这点会影响 lint 规则匹配逻辑。
