Sublime本身不带Java编译器，配置本质是正确调用系统javac/java；若终端中javac -version失败，则所有构建配置均无效，主因是PATH未生效或Sublime未继承环境变量。
Sublime 本身不带 Java 编译器，所谓“配置 Java 编译环境”，本质是让它正确调用你系统里已装的 javac 和 java 命令。如果终端里 javac -version 都报错，所有构建配置都白搭。
为什么 Ctrl+B 后提示 'javac' is not recognized？
这不是 Sublime 的问题，是它根本没找到 javac 可执行文件。关键在系统 PATH 是否真正生效，且 Sublime 是否继承了它。
- Windows：检查
PATH中是否包含%JAVA_HOME%\bin（不是只设了JAVA_HOME），并在命令提示符中运行where javac确认路径 - macOS/Linux：运行
which javac，如果没输出，说明$JAVA_HOME/bin没进$PATH；注意 Sublime 启动方式——从桌面图标启动时通常不加载~/.zshrc，建议从终端执行subl启动 - 改完环境变量后，必须彻底退出 Sublime（杀进程），再重开；否则它仍用旧的
PATH - 在 Sublime 控制台（
Ctrl+`）里执行import os; print(os.environ.get('PATH'))，直接看它实际看到的路径里有没有javac所在目录
JavaC.sublime-build 怎么写才支持 package 和中文？
默认构建系统连 package 都处理不了，更别说中文源码。核心是两件事：指定编码、按包结构生成 class 目录。
- 必须加
-encoding UTF-8，否则含中文字符串或注释时javac直接报“非法字符”（Windows 默认用 GBK 读文件） - 必须用
-d .，而不是只写javac $file；否则package com.example;的类会被编译到当前目录，而不是./com/example/下，后续java根本找不到 -
working_dir必须设为"$file_path"，不能是固定路径；否则import其他本地类或读取同目录资源文件会失败 - 推荐用
cmd数组而非shell_cmd，避免 shell 解析差异（比如 Windows 的cmd不支持&&连写）
一个最小可用配置示例：
立即学习“Java免费学习笔记（深入）”；
{
"cmd": ["javac", "-encoding", "UTF-8", "-d", ".", "$file"],
"working_dir": "$file_path",
"selector": "source.java"
}
运行时报 “Could not find or load main class” 怎么办？
这几乎从来不是代码问题，而是 java 命令没按 package 结构找对类名或工作目录不对。
- 类名 ≠ 文件名：
java后面跟的是**全限定类名**，比如com.example.Hello，不是Hello或Hello.class - 如果用了
-d .编译，class 文件就在./com/example/Hello.class，那运行就得在项目根目录下执行java com.example.Hello，不能 cd 进com/example再java Hello - 不要硬塞编译+运行到一个
shell_cmd里（如"javac ... && java ..."）；建议拆成两个variants：“Compile” 和 “Run”，手动控制更稳 - 有依赖 jar 包时，必须显式加
-cp ".:lib/some.jar"（macOS/Linux）或-cp ".;lib\some.jar"（Windows），不能只靠-cp .
为什么改了 build 文件还是不生效？
Sublime 构建系统加载有缓存和路径陷阱，常见失效点很具体。
- 文件必须保存在
Packages/User/目录下，后缀是.sublime-build；放在别处（比如桌面或项目目录）Sublime 根本不会扫描 - 文件名不能含空格或特殊字符，比如
Java C.sublime-build会加载失败；推荐用JavaC.sublime-build或MyJava.sublime-build - 保存后，必须在菜单
Tools → Build System中手动选中它；Sublime 不会自动切换到刚新建的构建系统 - 如果文件里用了
shell_cmd但没设"shell": true，在 Windows 上可能静默失败；macOS/Linux 则通常默认走 shell
最麻烦的其实是 package 路径和 -d 输出目录的匹配——这里一错，编译能过，运行必崩，而且错误信息完全不提示真实原因。
