subl命令无效需先确认subl.exe是否存在：Windows默认安装路径为C:\Program Files\Sublime Text\subl.exe，便携版通常不包含；PATH修改后须重启终端，macOS/Linux需配置shell初始化文件，Build System应硬编码解释器绝对路径。
subl 命令无效？先确认 subl.exe 是否存在
Windows 上敲 subl 报“不是内部或外部命令”，大概率不是 PATH 配错了，而是根本没这个文件。官方安装包解压后根目录下才有 subl.exe（如 C:\Program Files\Sublime Text\subl.exe），便携版、绿色版、第三方打包版通常不带它。
验证方法：打开 Sublime 安装目录，手动找一下有没有 subl.exe；没有就别配 PATH，直接重装官网正版。
- 默认安装路径是
C:\Program Files\Sublime Text或C:\Program Files\Sublime Text 3 - 安装时勾选 “Add to PATH” 可自动写入——但仅对 Windows 10/11 新版安装器有效
- 若装在非默认路径（如
D:\Tools\Sublime Text），必须把该完整路径加进系统 PATH，不能只加子目录（比如D:\Tools\Sublime Text\subl.exe是错的）
PATH 改了，cmd 还不认 subl？重启终端是硬要求
改完环境变量后，旧的 CMD/PowerShell 窗口不会自动加载新 PATH，这是 Windows 的行为逻辑，不是 Sublime 的 bug。
- 别反复点“确定”“应用”，直接关掉所有终端窗口，再新开一个，再试
subl --help - 用
echo %PATH%检查是否真写进去了（搜索关键词Sublime） - 如果用的是 Windows Terminal 或 ConEmu，也要重启整个终端程序，不只是标签页
- 某些杀毒软件或企业策略会拦截 PATH 修改，此时
subl即使路径正确也会被静默拒绝
macOS/Linux 下 subl 不生效？别漏掉 shell 初始化文件
macOS 和 Linux 不像 Windows 那样有全局 GUI 级 PATH，subl 命令靠 shell 启动时读取的配置文件加载。只改 /etc/environment 或图形界面 PATH 是无效的。
- zsh 用户（macOS Catalina 及之后默认）：编辑
~/.zshrc，加一行export PATH="/Applications/Sublime Text.app/Contents/SharedSupport/bin:$PATH" - bash 用户：改
~/.bash_profile或~/.bashrc - Linux 桌面环境（GNOME/KDE）可能需要额外运行
source ~/.zshrc或注销重登录，才让 GUI 应用识别新 PATH
Sublime 自身不继承终端环境变量，Build System 必须硬编码路径
双击图标启动 Sublime，它不加载 ~/.zshrc；Windows 改了环境变量但没杀掉所有 subl.exe 进程，旧进程还在用老 PATH。所以 Build System 里写 javac 或 python 很容易失败。
- 验证方式：终端执行
which javac或which python3，记下输出路径（如/usr/lib/jvm/jdk-17.0.1/bin/javac） - Build System 的
shell_cmd中必须显式写出绝对路径，例如："shell_cmd": "/usr/bin/python3 -u \"$file\"" - Java 编译需额外指定
-encoding UTF-8和-d .，working_dir 要匹配 package 结构起点 - 中文源码不加
-encoding UTF-8会报“非法字符”；Windows 下建议给java加-Dfile.encoding=UTF-8
最常被忽略的一点：Sublime 的 Build System 是独立于系统 shell 的执行上下文，PATH 继承不可靠，硬编码解释器路径才是稳定解法。哪怕你已经配好了 subl 命令，也不代表 Build System 就能自动拿到 javac 或 python —— 这两个是不同层级的问题。
