Sublime Text“一键编译运行Java”本质是调用系统javac和java命令，前提是终端中javac -version与java -version均能正常输出且版本一致；需将JDK的bin目录加入系统PATH、重启Sublime、手动创建JavaC.sublime-build文件并正确配置shell_cmd、working_dir及encoding参数。
Sublime Text 本身不带 Java 编译器或运行时，所谓“一键编译运行”，本质是让它调用系统已安装的 javac 和 java 命令。能跑通的前提只有一个：终端里 javac -version 和 java -version 都能正常输出，且版本一致。
确认 JDK 已正确安装并被 Sublime 看见
Sublime 的构建系统是在子进程中执行命令，它只认系统 PATH 里的 javac，不读取 JAVA_HOME 或 IDE 级别的配置。
- Windows 用户必须把
%JAVA_HOME%\bin显式加进系统 PATH（不只是设置JAVA_HOME） - macOS/Linux 用户用
brew install openjdk@17后，检查/opt/homebrew/opt/openjdk@17/bin是否在$PATH中 - 改完环境变量后，**必须彻底退出 Sublime（不是关文件，是杀进程）再重开**，否则它不会加载新 PATH
- 在 Sublime 控制台（
Ctrl+`）里执行import os; print(os.environ.get('PATH'))，可验证它看到的 PATH 是否含javac路径
手动创建 JavaC.sublime-build（别信默认构建系统）
Sublime 自带的 Java 构建系统不支持中文、不处理 package、也不自动运行，必须自己写一个。保存位置必须是 Packages/User/JavaC.sublime-build。
内容如下（Windows/macOS/Linux 通用，无需分平台写）：
立即学习“Java免费学习笔记（深入）”；
{
"shell_cmd": "javac -encoding UTF-8 -d . $file && java $file_base_name",
"file_regex": "^(*?):([0-9]*):?([0-9]*)",
"working_dir": "$file_path",
"selector": "source.java"
}
-
-encoding UTF-8必须显式加，否则含中文注释或字符串会报“非法字符” -
-d .表示按package声明自动建目录（如package com.example;→ 输出到./com/example/），这是支持包结构的关键 -
java $file_base_name是运行命令，不是java $file——java只认类名，不认路径 -
working_dir设为$file_path，否则读取资源文件或 import 其他类时会找不到
文件路径与命名必须严格匹配 package 声明
Sublime 不校验，但 javac 会直接失败，错误信息往往只显示“class X is public, should be declared in a file named X.java”，容易误判为语法问题。
- 如果代码第一行是
package com.example;，文件就必须保存为com/example/Hello.java（即com是子目录，不是包名前缀） - public 类名必须和文件名完全一致（大小写敏感），例如
public class Main {}→ 文件名必须是Main.java - 没写
package的话，文件可直接放在任意目录，但构建系统里不能用-cp .或-d指向其他位置，否则类路径错乱
中文乱码、控制台输出问号、编译报错“非法字符”
这不是 Sublime 的 bug，而是编码链断裂：源文件编码、javac 解码方式、JVM 输出编码三者不一致导致的。
- 先看右下角状态栏，确保文件编码是
UTF-8（不是UTF-8 with BOM，也不是GBK） -
javac默认用系统编码读源码，Windows 是 GBK，所以必须加-encoding UTF-8参数 -
java运行时默认用系统编码解码输出，Windows CMD 默认是 GBK，但 Sublime 控制台实际按 UTF-8 渲染，所以即使加了-Dfile.encoding=UTF-8也未必解决——最稳做法是避免在控制台直接输出中文，改用日志文件或外部终端 - 如果非要在 Sublime 控制台看中文，可在构建系统中把
shell_cmd改成：cmd /c "chcp 65001 >nul && javac -encoding UTF-8 -d . $file && java $file_base_name"（仅 Windows）
真正卡住人的从来不是配置步骤多，而是 javac 和 java 版本不一致、working_dir 设错、或者文件路径和 package 对不上——这三处出错，Sublime 往往只报一句模糊错误，得靠终端手动跑一遍命令来定位。
