Windows上subl命令无效主因是subl.exe缺失或PATH未正确配置并刷新；macOS/Linux则多因shell初始化文件（如~/.zshrc）未修改或重载。需先确认subl.exe存在，再将完整安装路径加入PATH，最后重启终端验证。
Windows 上 subl 命令无效，90% 是因为 subl.exe 根本不存在，或 PATH 没写对、没刷新。macOS/Linux 则几乎全是 shell 初始化文件没改对——不是 Sublime 的问题，是系统 PATH 加载机制的差异。
确认 subl.exe 是否真实存在（Windows）
官方安装包解压后根目录下才有 subl.exe；绿色版、便携版、第三方打包版通常不带它。别在没这个文件的前提下配 PATH。
- 打开安装目录（默认是
C:\Program Files\Sublime Text或C:\Program Files\Sublime Text 4），手动找有没有subl.exe - 如果只有
sublime_text.exe，说明你装的是精简版或旧版安装器，得重装官网正版 - 安装时勾选 Add to PATH 仅对 Windows 10/11 新版安装器生效；旧版或手动解压不会触发
正确添加路径到系统 PATH（Windows）
必须把 subl.exe 所在的**完整目录路径**加入 PATH，不是它的父目录，更不能加子目录（比如 ...\Sublime Text\subl.exe 就该加 C:\Program Files\Sublime Text）。
- 右键“此电脑”→“属性”→“高级系统设置”→“环境变量”→“系统变量”里找到
Path→ 点“编辑”→“新建” - 填入路径，例如：
C:\Program Files\Sublime Text（注意：不要带subl.exe，也不要加引号） - 如果装在非默认路径（如
D:\Tools\Sublime Text 4），就填那个完整路径，不能只填D:\Tools
macOS/Linux 必须改 shell 初始化文件
GUI 应用（包括 Sublime 自身）不读 /etc/environment，也不自动加载新 PATH；只靠 shell 启动时读取的初始化文件生效。
- zsh 用户（macOS Catalina 及之后默认）：编辑
~/.zshrc，加一行：export PATH="/Applications/Sublime Text.app/Contents/SharedSupport/bin:$PATH" - bash 用户：改
~/.bash_profile或~/.bashrc，内容同上，但路径改为对应安装位置（如 Linux 下可能是/opt/sublime_text/） - 改完必须运行
source ~/.zshrc（或对应文件），或完全退出终端再重开；只新开标签页不够 - GNOME/KDE 桌面用户：可能需要注销重登录，才能让 GUI 应用识别新 PATH
验证和常见拦截点
PATH 配好 ≠ 立刻生效；很多失败其实卡在最后一步——你以为配好了，其实终端根本没加载新值。
- 关掉所有 CMD/PowerShell/Terminal 窗口，**全新打开一个**，再执行
subl --help - Windows Terminal / ConEmu / Windows Subsystem for Linux（WSL）需重启整个程序，不只是新建 tab
- 某些杀毒软件（尤其企业版）或组策略会静默拦截 PATH 修改，此时即使路径正确也报“not recognized”
- macOS Sonoma+ 或启用了全盘访问限制的系统，
subl .可能因沙盒权限被拒，这不是 PATH 问题，要单独授予权限
最常被忽略的是：PATH 写对了、subl.exe 也存在，但终端没重启——系统不会主动通知你“旧窗口已失效”，它就静静等着你关掉再开。
