subl命令不存在需先安装命令行工具：macOS在菜单栏选择“Sublime Text → Install Command Line Tool”，Windows重装时勾选“Add to PATH”或手动添加路径至系统环境变量，Linux需手动创建软链接；验证用which subl和subl --version。
subl 命令根本跑不起来？不是 Sublime 没装好，是命令行工具压根没装——这一步跳过，后面全白搭。
subl 命令不存在：先装工具，再验路径
输 subl --version 报 command not found，90% 是因为命令行工具没安装，不是 PATH 配错了。它不随主程序自动部署。
- macOS：打开 Sublime Text → 菜单栏 Sublime Text → Install Command Line Tool（比手动建软链接更稳，自动处理空格和路径变更）
- Windows：重装时勾选 Add to PATH；若已装完，把
C:\Program Files\Sublime Text\加进系统环境变量 PATH，或在C:\Windows\System32下建subl.bat（内容：@start "" "C:\Program Files\Sublime Text\sublime_text.exe" %*） - Linux（deb/rpm 包）：一般自带
subl；tarball 或 Snap/Flatpak 版需手动处理，例如：sudo ln -s /opt/sublime_text/subl /usr/local/bin/subl
验证必须分两步：which subl（macOS/Linux）或 where subl（Windows）有输出，再跑 subl --version 看是否返回构建号（如 Build 4169）。
subl 打不开文件：空格、中文、相对路径三重陷阱
能执行 subl --help ≠ 能打开文件。常见“点了没反应”“弹出空白标签页”，基本是路径被 shell 截断或解析失败。
- 含空格或中文的路径，必须用单引号或双引号包裹：
subl './my project/app.js'✅，subl my project/app.js❌（空格让 shell 当成两个参数） - Windows 下反斜杠
\在 PowerShell 中是转义符，统一换成正斜杠：subl C:/Users/me/file.py✅，subl C:\Users\me\file.py❌ - 脚本里别裸写相对路径，用
subl "$(pwd)/src/index.ts"，防cd后路径失效 - 打开后是未命名新标签页？大概率路径根本不存在，
subl不报错也不提示
subl -n 和 subl -w：一个开窗，一个卡终端，别混
-n 和 -w 解决的是两类完全不同的问题，强行合用反而坏事。
-
subl -n：强制新开独立窗口，避免多个项目挤在一个窗口里互相污染上下文。适合并行开发：subl -n ~/projA ~/projB -
subl -w：阻塞终端，等你关掉文件才返回。Git 提交必须加这个：git config --global core.editor "subl -w"，否则 Git 直接用空消息提交，报Aborting commit due to empty commit message - SSH 连远程机器时，
subl .会静默失败（GUI 无 DISPLAY），得加-n：subl -n . - WSL 用户注意：
-w在某些终端（如 VS Code 内置终端）可能失效，可试subl -n -w强制行为一致
subl file:line 跳转：支持但不稳定，别全信
subl main.py:25 确实能跳到第 25 行，但跨平台兼容性差，尤其带列号（:25:8）时容易被忽略或解析错。
- macOS 和较新 Build（≥4143）支持较好；旧版 Linux 或 Snap 安装版可能直接当普通文件名处理
- 安全写法：先确保文件能正常打开，再追加
:行号测试；列号功能建议只在本地调试用，别写进自动化脚本 - 想精准控制 UI，可用
--command调内置命令，比如subl --command "toggle_side_bar"
最易被忽略的一点：macOS Catalina 及以后默认用 zsh，改了 ~/.bash_profile 没用，得改 ~/.zshrc 并执行 source ~/.zshrc；同样，WSL2 的 Windows PATH 不透传，得在 ~/.zshrc 里显式加 Windows 下 Sublime 的路径。
