Sublime中Java编译执行失败主因是环境变量未透传、构建配置不当、编码不匹配；应正确配置PATH/JAVA_HOME、设置working_dir、添加-encoding UTF-8和-Dfile.encoding=UTF-8参数，复杂项目应改用终端或专业IDE。
Java编译器路径没配对，javac 直接报“command not found”
Sublime Text 本身不带 Java 运行时，所有编译动作都依赖系统已安装的 JDK 和正确配置的 PATH。常见现象是按下 Ctrl+B 后弹出错误：sh: javac: command not found，或 Windows 下提示 'javac' is not recognized。
这不是 Sublime 的问题，而是环境变量没透传进来——尤其 macOS/Linux 用图形界面启动 Sublime 时，它不会自动加载 shell 的 .zshrc 或 .bash_profile 里的 PATH。
- macOS：在终端里执行
open -a "Sublime Text"启动，确保继承当前 shell 环境；或改用subl命令行工具（需先运行ln -s "/Applications/Sublime Text.app/Contents/SharedSupport/bin/subl" /usr/local/bin/subl） - Windows：确认
JAVA_HOME指向 JDK 根目录（如C:\Program Files\Java\jdk-17.0.1），且%JAVA_HOME%\bin已加入系统PATH - Linux：检查
which javac输出，若为空，先装 OpenJDK（如sudo apt install openjdk-17-jdk），再验证javac -version
Build System 配置写错，java 跑的是 .class 文件却提示“找不到或无法加载主类”
Sublime 的 Java 构建本质是调用 javac 编译 + java 执行，但 java 命令默认按包结构找类，不是按文件路径。比如你写了个 MyApp.java，放在 /home/user/demo/MyApp.java，编译后生成 MyApp.class，但直接 java MyApp 会失败——除非你在 /home/user/demo 目录下运行，且该类无 package 声明。
更典型的问题是类名和文件名不一致、用了 package 却没按目录结构组织、或构建配置里没指定 working_dir。
立即学习“Java免费学习笔记（深入）”；
- 最简安全做法：所有 Java 文件不写
package，保存在项目根目录，构建系统中设"working_dir": "$file_path" - 如果必须用包（如
com.example.Hello），则文件必须放在com/example/Hello.java，构建时working_dir设为该文件所在父目录（即包名起点的上一级） - 避免在
cmd中硬编码路径，用$file_base_name和$file_path动态拼接，例如：["javac", "$file_name", "&&", "java", "$file_base_name"]（仅适用于无包场景）
中文乱码、控制台输出含问号，chcp 65001 也不管用
这是 Windows 下 Sublime Build System 的经典字符集陷阱：javac 默认用系统编码（GBK）读源码，但如果你的 .java 文件是 UTF-8 无 BOM，就会编译报错“非法字符”；反过来，java 输出到 Sublime 控制台时，又可能把 UTF-8 字节当 GBK 解码，显示成 。
根本解法不是改系统代码页，而是让 JDK 显式使用 UTF-8。
- 在 Build System 的
cmd中给javac加参数：-encoding UTF-8；给java加-Dfile.encoding=UTF-8 - 完整示例（Windows）：
["javac", "-encoding", "UTF-8", "$file_name", "&&", "java", "-Dfile.encoding=UTF-8", "$file_base_name"] - macOS/Linux 同理，但注意 shell 会解析空格，建议用数组写法而非字符串拼接
- 别依赖编辑器右下角显示的“UTF-8”，务必确认文件实际保存为 UTF-8 无 BOM（Sublime 中用右下角编码名点击 → “Save with Encoding” → “UTF-8”）
想用 JUnit 或 Maven？别硬塞进 Build System
Sublime 的 Build System 是单命令链式执行，适合 javac → java 这种轻量流程。一旦要跑测试、管理依赖、处理多模块，它就力不从心了——你没法在 cmd 里优雅处理 classpath、jar 包冲突、生命周期钩子。
这时候强行折腾只会把构建脚本写成黑盒，出错难定位，协作更难。
- JUnit：写个独立的
TestRunner.java主类，用org.junit.runner.JUnitCore加载测试类，再用原生 Build System 跑它 - Maven/Gradle：彻底放弃 Build System，改用终端：
mvn compile && mvn exec:java -Dexec.mainClass=MyApp；或装插件（如Terminus）嵌入终端到 Sublime 里 - 真正需要 IDE 级功能（断点、变量监视、Maven 图形依赖树）时，VS Code（配合 Extension Pack for Java）或 IntelliJ IDEA 社区版才是合理选择——Sublime 定位就是快速编辑+轻量构建
Java 在 Sublime 里能跑通，靠的是“克制”：只做编译执行这一件事，其他交给专业工具。越想让它变重，越容易掉进路径、编码、classpath 的三重坑里。
