Sublime Text 可通过配置 Build System 调用系统 JDK 编译运行单个 Java 文件，前提是 JDK 已正确安装并配置 PATH；需手动创建 Java.sublime-build 文件，注意类名与文件名一致、编码统一及单文件限制。
Sublime Text 本身不是 IDE，不能像 IntelliJ 或 Eclipse 那样自动管理 Java 项目、依赖或调试，但通过配置 Build System，它确实可以调用系统已安装的 javac 和 java 直接编译运行单个 .java 文件——前提是你的 JDK 已正确安装并加入 PATH。
确认 JDK 已安装且命令行可用
这是最关键的前置条件。Sublime 不负责装 JDK，只调用它。
- 在终端（macOS/Linux）或命令提示符/PowerShell（Windows）中运行
javac -version和java -version，必须能正常输出版本号 - 如果报错
'javac' is not recognized或command not found，说明 JDK 未安装，或JAVA_HOME/PATH没配好 - Windows 用户尤其注意：不要只配
JAVA_HOME，还必须把%JAVA_HOME%\bin加进系统PATH - macOS 使用 Homebrew 安装的 JDK（如
openjdk@17），需确认javac软链接是否已创建（brew install openjdk@17 && sudo ln -sfn /opt/homebrew/opt/openjdk@17/libexec/openjdk.jdk /Library/Java/JavaVirtualMachines/openjdk-17.jdk）
为 Sublime 创建 Java 构建系统（Build System）
Sublime 用 .sublime-build 文件定义如何编译和运行代码。默认不带 Java 支持，需手动添加。
- 菜单栏选择 Tools → Build System → New Build System…
- 替换全部内容为以下 JSON（适配主流平台，含错误高亮支持）：
{
"shell_cmd": "javac -encoding UTF-8 $file && java $file_base_name",
"file_regex": "^(...*?):([0-9]*):?([0-9]*)",
"working_dir": "$file_path",
"selector": "source.java",
"variants": [
{
"name": "Run",
"shell_cmd": "javac -encoding UTF-8 $file && java $file_base_name"
},
{
"name": "Run with Args",
"shell_cmd": "javac -encoding UTF-8 $file && java $file_base_name $args"
}
]
}
- 保存为
Java.sublime-build（路径通常为~/Library/Application Support/Sublime Text/Packages/User/macOS/Linux，或%APPDATA%\Sublime Text\Packages\User\Windows） - 保存后，菜单 Tools → Build System 下会出现
Java选项，选中即可 -
$file_base_name自动提取文件名（不含.java），避免手输类名出错 - 使用
Run with Args变体时，可在 Sublime 控制台（Ctrl+`）输入参数，例如hello world
常见失败原因与修复点
即使构建系统写对了，仍可能报错，多数和环境或代码结构有关。
立即学习“Java免费学习笔记（深入）”；
-
Error: Could not find or load main class XXX：Java 要求public class名必须与文件名完全一致（包括大小写），且main方法签名必须是public static void main(String[] args) - 中文乱码（控制台输出问号）：Windows CMD 默认 GBK 编码，而
javac默认 UTF-8。解决方案是统一编码：javac -encoding UTF-8 XXX.java（已在构建系统中指定） + 在 CMD 中执行chcp 65001切换为 UTF-8 - 无法识别
Scanner等类：不是构建问题，而是代码里漏写了import java.util.Scanner; - Sublime 构建结果窗口不显示输出？检查是否误点了
Build Results（右键 → Copy to Clipboard 或关闭再重试），或尝试重启 Sublime - 多文件项目（含
package）无法直接构建：Sublime 的这个方案只适合单文件练习。一旦用了package，就必须按目录结构组织，并手动调整javac -d . *.java和java xxx.xxx.Main，不再推荐用此轻量方式
真正卡住人的地方往往不是 Sublime 配置，而是 JDK 环境没跑通，或者 Java 基础规则（如类名/文件名匹配、public class 限制）被忽略。先确保终端里 javac 和 java 能用，再配 Sublime，顺序不能反。
