Sublime Text不依赖Java插件而需手动配置Build System，因其无官方Java IDE功能，插件多已停更、不兼容ST4且无法适配JDK版本、classpath、目录结构及编码参数，易导致编译运行失败。
Sublime Text 本身不提供 Java IDE 级功能，也没有官方维护的 Java 插件生态；所谓“Java 插件”基本是用户自建构建系统或极简包装脚本，Package Control 上标称 Java 支持的插件（如 JavaCompletions、SublimeJava）多数已停止更新、不兼容 ST4、无法处理 package 或模块路径，实际不可靠。
为什么别依赖 Java 插件，而要手动配 Build System
插件失效的核心原因是：Java 编译/运行强依赖 JDK 版本、classpath、源码目录结构和编码参数，而 Sublime 的插件机制无法动态适配这些。常见现象包括：
-
Unable to find package java.lang—— 插件没传-bootclasspath或找不到rt.jar/modules.java.base - 中文乱码 —— 插件硬编码
GBK编码，不读取文件 BOM 或项目配置 -
cannot find symbol却在终端里能编译成功 —— 插件工作目录错乱，或没设置working_dir - 自动补全只对
java.lang有效，java.util或自定义类全无提示 —— 没集成jdt.ls或javac -proc:none分析流程
javac 命令必须显式指定 -encoding UTF-8 和 -d .
默认 javac 在 Windows 上用 GBK、macOS/Linux 用系统 locale，一旦源文件含中文字符串或注释，不加 -encoding 就会报 illegal character: uFFFD。同时，不指定 -d . 会导致 .class 输出到错误位置，后续 java 找不到主类。
正确写法（以 macOS/Linux 为例）：
立即学习“Java免费学习笔记（深入）”；
{
"shell_cmd": "/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home/bin/javac -encoding UTF-8 -d . "$file" && /Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home/bin/java "$file_base_name"",
"working_dir": "$file_path",
"file_regex": "^.*?:(\d+):(?:\d+:)?\s*(.*)$",
"selector": "source.java",
"encoding": "UTF-8"
}
-
-d .强制 class 输出到当前目录，避免嵌套包名时生成子目录干扰 -
"working_dir": "$file_path"必须存在，否则java启动时 classpath 不含当前路径 - Windows 用户注意路径中空格：用双引号包裹完整路径，如
"C:\Program Files\Java\jdk-17.0.1\bin\javac"
带 package 声明的文件必须匹配目录结构
比如 package com.example; 的 App.java，必须放在 com/example/App.java 路径下。Build System 不会帮你挪文件或改包名 —— 这不是插件能绕过的 Java 语言约束。
若你坚持用平铺目录（如所有 .java 都在项目根），唯一办法是删掉 package 行，并确保没有 import 同级以外的类。否则必报：
error: class App is public, should be declared in a file named App.javaError: Could not find or load main class com.example.App
这类错误和 Sublime 无关，javac 命令行下也会一样失败。
真正麻烦的从来不是写几行 JSON 配置，而是 JDK 路径是否真实存在、working_dir 是否生效、package 和磁盘路径是否咬合——这三个点卡住 90% 的人。别让插件名字迷惑你，Sublime 的 Java 支持，本质就是把终端命令封装进 JSON 里而已。
