subl 命令不存在需先启动 Sublime Text GUI 触发自动软链接；若未生成，macOS 手动执行 sudo ln -s "/Applications/Sublime Text.app/Contents/SharedSupport/bin/subl" /usr/local/bin/subl；Windows 无原生 subl.exe，可建 subl.bat 模拟；zsh 用户须配置 ~/.zshrc 而非 ~/.bash_profile。

subl 命令不存在？先确认 Sublime Text 是否自带 CLI 工具

macOS 版 Sublime Text 会随安装自动把 subl 命令软链接到 /usr/local/bin/subl，但这个动作**只在首次启动 GUI 应用时触发**。如果你一直没点开过 Sublime Text 图形界面，subl 就不会生成，直接运行会报 command not found: subl。

• 打开一次 Sublime Text（双击图标或 Spotlight 搜索启动）
• 再在终

  

  端执行 which subl，应该返回 /usr/local/bin/subl
• 如果仍无输出，说明软链接没建成功，需手动创建（见下一条）

手动创建 subl 软链接（macOS）

Sublime Text 的实际可执行文件路径通常是 /Applications/Sublime Text.app/Contents/SharedSupport/bin/subl。只要它存在，就能手动挂到 PATH 下：

sudo ln -s "/Applications/Sublime Text.app/Contents/SharedSupport/bin/subl" /usr/local/bin/subl

• 注意路径中含空格，必须用英文双引号包裹
• /usr/local/bin 通常已在默认 PATH 中；若你用 zsh（macOS Catalina+ 默认），检查 echo $PATH 是否含该路径
• 如果提示 ln: /usr/local/bin/subl: File exists，先 rm /usr/local/bin/subl 再重试

Windows 上用 subl 命令？别折腾，改用 shell 命令行参数

Windows 版 Sublime Text **不提供 subl.exe 或类似命令行工具**。所谓“添加环境变量”是常见误解——你只能把 Sublime 的安装目录（如 C:\Program Files\Sublime Text）加进 PATH，然后靠系统识别 .sublime_text 关联或手动调用：

• 查真实路径：where sublime_text 或去安装目录找 sublime_text.exe
• 临时使用："C:\Program Files\Sublime Text\sublime_text.exe" myfile.py
• 想类 Unix 风格？自己建个 subl.bat 放在 PATH 目录里，内容为：

  @echo off
  start "" "C:\Program Files\Sublime Text\sublime_text.exe" %*

zsh / bash 启动后 subl 不生效？检查 shell 配置文件加载顺序

macOS 新终端默认用 zsh，但很多人还在 ~/.bash_profile 里加 PATH。这类配置**zsh 不读**，导致 subl 找不到。

• 确认当前 shell：echo $SHELL
• zsh 用户应编辑 ~/.zshrc，追加：export PATH="/usr/local/bin:$PATH"
• 改完后执行 source ~/.zshrc，再试 subl --help
• 如果用了 Oh My Zsh 等框架，确保没在插件里覆盖 PATH