subl命令无效需先确认可执行文件是否存在：windows检查c:\program files\sublime text\subl.exe，macos/linux检查/applications/sublime text.app/contents/sharedsupport/bin/subl；存在则配置path并重启终端，不存在则重装官网正版。
subl 命令无效？先确认 subl.exe 或 subl 是否真实存在
Windows 上敲 subl 报“不是内部或外部命令”，大概率不是 PATH 配错了，而是根本没这个可执行文件。官方安装包（.exe）默认会带 subl.exe，但绿色版、解压即用版、第三方打包版通常不包含它。
验证方法：打开 Sublime 安装目录（如 C:\Program Files\Sublime Text），手动找一下有没有 subl.exe；没有就别配 PATH，重装官网正版再试。
macOS/Linux 同理：检查 /Applications/Sublime Text.app/Contents/SharedSupport/bin/subl 是否存在。注意路径中 App 名称可能含版本号（如 Sublime Text 4.app），软链接若指向错误名称会失效。
PATH 配对了却仍不生效？重启终端或杀干净 subl 进程
改完系统 PATH 后，旧的 CMD/PowerShell 窗口不会自动加载新变量——这是 Windows 行为逻辑，不是 Sublime 的 bug。关掉所有终端窗口，新开一个再试 subl --help。
macOS/Linux 用户容易忽略 shell 初始化文件加载时机：
- zsh（macOS Catalina+ 默认）：必须把路径写进
~/.zshrc，例如：export PATH="/Applications/Sublime Text.app/Contents/SharedSupport/bin:$PATH" - bash：改
~/.bash_profile或~/.bashrc - 改完后要
source ~/.zshrc，或注销重登录，否则 GUI 启动的 Sublime 读不到
Windows Terminal、ConEmu 等第三方终端，也要重启整个程序，不只是标签页。
Sublime 自身不继承终端环境变量？别指望它自动读 .zshrc
双击图标启动 Sublime，它不会加载 ~/.zshrc 或 %PATH% 的最新状态。这就是为什么你在终端里能跑 javac -version，但在 Sublime 里按 Ctrl+B 却报 “command not found”。
解决思路只有两个：
- macOS/Linux：统一用终端启动，例如
open -a "Sublime Text"或先配好subl再用subl . - Windows：右键任务栏 Sublime 图标 → “退出”（不是只关窗口），确保所有
subl.exe进程被杀干净，再重新打开
别信“自动继承环境变量”的说法——Sublime 的 Build System 是独立子进程，PATH 来源和你当前终端完全隔离。
Build System 里硬编码路径比依赖 PATH 更可靠
尤其当你有多个 JDK、Python 版本，或 PATH 在不同上下文里不一致时，shell_cmd 里直接写绝对路径最稳。
示例（Java 编译）：
{
"shell_cmd": "/usr/lib/jvm/jdk-17.0.1/bin/javac -encoding UTF-8 \"$file\" && /usr/lib/jvm/jdk-17.0.1/bin/java \"$file_base_name\"",
"working_dir": "$file_path",
"file_regex": "^(.*?):([0-9]+):([0-9]+): (.*)$"
}
关键点：
- 中文源码必须加
-encoding UTF-8，否则编译报“非法字符” - 带
package的项目，working_dir得设成包结构根目录（如src），否则java com.example.Main找不到类 -
file_regex配对错误格式，才能点击跳转到报错行
环境变量污染和路径歧义是 Sublime 中最隐蔽的问题——它不报错，只是静默失败。验证方式永远是：在终端里手动执行 Build System 里写的那条完整命令，看是否成功。
