Sublime Text调用javac前必须确保终端中javac -version和java -version均能正常输出且版本一致；否则所有构建配置均无效，因Sublime不自带Java编译器，仅依赖系统PATH中的JDK命令。
javac -version 报错，Sublime 肯定调不动
Sublime Text 本身不带 Java 编译器，所有编译动作都依赖系统已安装的 javac 和 java 命令。如果终端里运行 javac -version 提示 command not found 或 'javac' is not recognized，那 Sublime 按 Ctrl+B 一定失败——别急着改配置文件，先修环境。
关键检查点：
-
java -version和javac -version必须都能正常返回版本号（注意：只装 JRE 不行，必须是 JDK） - Windows：确认
JAVA_HOME指向 JDK 根目录（如C:\Program Files\Java\jdk-17.0.1），且%JAVA_HOME%\bin已加入系统PATH - macOS/Linux：用
brew install openjdk@17或apt install openjdk-17-jdk，再检查$PATH是否包含$JAVA_HOME/bin - macOS 图形界面启动 Sublime 时可能不继承 shell 环境变量 → 改用终端执行
open -a "Sublime Text"或配置subl命令行工具 - 改完环境变量后，必须彻底退出 Sublime（不是关窗口，要杀进程），否则新变量不会加载
JavaC.sublime-build 怎么写才不报“找不到或无法加载主类”
这个错误几乎全是 working_dir 或包结构不匹配导致的。Sublime 的构建系统默认在任意路径下执行 java MyClass，但 JVM 查找类时严格按 package 声明和目录结构来定位。
最简安全做法（适合初学者第一个 Demo）：
立即学习“Java免费学习笔记（深入）”；
- Java 文件不要写
package声明 - 文件保存在任意目录下（比如
/demo/HelloWorld.java），确保文件名与 public 类名完全一致（public class HelloWorld） - Build System 中必须设
"working_dir": "$file_path"，让javac和java都在源文件所在目录运行 - 推荐配置（保存为
Packages/User/JavaC.sublime-build）：
{
"cmd": ["javac", "-encoding", "UTF-8", "$file"],
"working_dir": "$file_path",
"selector": "source.java",
"variants": [
{
"name": "Run",
"cmd": ["java", "$file_base_name"],
"working_dir": "$file_path"
}
]
}
注意：$file_base_name 是不含扩展名的文件名，HelloWorld.java → HelloWorld，正好匹配 java HelloWorld 要求。
中文乱码、编译失败、运行一闪而过？这些参数不能少
Java 源文件含中文字符时，javac 默认用系统编码（Windows 是 GBK），但 Sublime 默认 UTF-8，不指定会报错或输出乱码。另外，java 运行时也要告诉 JVM 用 UTF-8 解析字节码里的字符串常量。
修正后的 Build System 关键参数：
- 编译加
-encoding UTF-8：确保javac正确读取源码中的中文 - 运行加
-Dfile.encoding=UTF-8：让java输出中文时不乱码 - Windows 下用
cmd /c封装命令，避免&&解析失败；macOS/Linux 直接用shell_cmd+ 双引号更稳 - 如果想运行完暂停看结果（尤其 Windows），
"cmd": ["cmd", "/c", "java -Dfile.encoding=UTF-8 $file_base_name & pause"]
有 package 的项目，为什么死活跑不起来
一旦写了 package com.example;，就不再是“把 .java 放哪都行”的事了。JVM 要求：com/example/Hello.java 必须放在 working_dir 的子目录下，且 working_dir 必须是 com 的父目录（即包名起点的上一级）。
例如：
- 源文件路径是
/project/src/com/example/Hello.java - 则
working_dir应设为/project/src（不是/project/src/com/example） - 编译命令得加
-d .把.class输出到当前目录结构下 - 运行命令得用
java com.example.Hello，不是java Hello - 这意味着你无法用一个通用 Build System 自动适配任意 package —— 复杂项目建议直接切到终端，或换 IntelliJ/Eclipse
真正容易被忽略的是：Sublime 的 Build System 不解析 package，也不自动推导路径。它只忠实地执行你写的命令。写错一层目录，ClassNotFoundException 就立刻报给你看。
