subl命令报“command not found”根本原因是未注册到系统PATH：macOS/Linux需手动建软链接（如sudo ln -s /Applications/Sublime\ Text.app/Contents/SharedSupport/bin/subl /usr/local/bin/subl），Windows需安装时勾选“Add to PATH”或手动添加路径，配置后须重启终端并运行subl --version验证。
subl 命令为什么打不开或提示 command not found
根本原因是 subl 没被加进系统 PATH。安装时若没勾选 “Add to PATH”（Windows）或没手动建软链接（macOS/Linux），终端就找不到这个命令。
macOS/Linux 用户必须手动创建符号链接，例如：
sudo ln -s /opt/sublime_text/sublime_text /usr/local/bin/subl
Windows 用户推荐用安装向导时勾选 “Add to PATH”，否则需手动把 Sublime 安装目录（如 C:\Program Files\Sublime Text）加到系统环境变量 PATH 中。
- 验证是否成功：新开终端，运行
subl --version，能输出版本号才算到位 - 常见失败点：改完 PATH 后没重启终端，或用了旧的 shell 会话（比如 tmux 或 zsh 未重载配置）
- macOS 上从 Dock 或 Spotlight 启动的 Sublime，其子进程继承不到 shell 的 PATH，导致插件里调用
subl失败——必须用subl .从终端启动编辑器才能保证环境一致
subl 打开文件/文件夹的常用参数组合
subl 不是双击式工具，它靠参数控制行为，不同参数直接影响工作流效率。
-
subl：只打开 Sublime 主程序，不加载任何文件 -
subl .：打开当前目录为项目，在侧边栏显示全部内容 -
subl filename.py：打开指定文件，自动识别语法高亮 -
subl -n .：强制新建窗口（避免文件被塞进已有窗口的 tab 里） -
subl file1.txt file2.txt：一次打开多个文件，按顺序排列 tab -
subl --wait file.txt：阻塞终端，等你关闭该文件后才返回命令行（适合脚本中调用，比如 git commit-msg 编辑器）
注意：--wait 在 Windows 上无效；-n 和 --wait 可同时使用，但顺序无关。
subl 在脚本和 Git 中的实际用法
真正体现 subl 价值的地方，是脱离 GUI、嵌入自动化流程。
- 设为 Git 默认编辑器：
git config --global core.editor "subl --wait"，这样git commit就会弹出 Sublime 窗口写 message - Shell 别名提速：
alias edit='subl -n'，之后直接edit src/就新窗口开目录 - 配合 find 使用：
find . -name "*.py" -exec subl {} +，批量打开所有 Python 文件（注意大数量时可能触发系统参数限制） - 在 Makefile 或 npm script 中写：
"open:editor": "subl ."，团队统一开发入口
关键细节：Git 要求编辑器必须支持 --wait，否则 commit 会立刻失败；而 subl 的 --wait 是 macOS/Linux 专属，Windows 用户得换用 subl -w（部分旧版支持，新版已弃用），稳妥起见建议 Windows 用户改用 VS Code 或记事本++ 做 Git editor。
subl 启动慢或卡在“正在加载项目”怎么办
这不是 subl 命令本身的问题，而是 Sublime 启动时加载了太多插件或大项目数据。
- 首次运行
subl .时如果目录下有.git、node_modules或几十万个小文件，Project Indexing 会卡住——可临时加--no-index参数跳过索引：subl --no-index . - 插件冲突常表现为命令执行后界面无响应，此时用
subl -w --safe-mode启动（-w是 wait 的简写，--safe-mode禁用所有插件），确认是否插件引起 - macOS 上从终端启动却仍卡住，大概率是 shell 初始化脚本（如
~/.zshrc）里有阻塞命令（比如挂载远程磁盘、curl 请求），导致 Sublime 等不到完整环境变量
最易被忽略的一点：subl 启动后默认复用已有窗口，但如果那个窗口正卡在某个插件的阻塞调用上（比如 Terminus 未响应），新 subl 命令也会被拖住——此时只能杀掉主进程再试。
