Sublime Text“一键编译运行Ja va”本质是调用系统ja vac和ja va命令，前提是终端中ja vac -version与ja va -version均能正常输出且版本一致；需将JDK的bin目录加入系统PATH、重启Sublime、手动创建Ja vaC.sublime-build文件并正确配置shell_cmd、working_dir及encoding参数。
很多开发者喜欢用Sublime Text写Ja va，图的就是一个轻快。但得先搞清楚一件事：Sublime本身并不自带Ja va编译器或运行时环境。所谓的“一键编译运行”，本质上只是让Sublime去调用你系统里已经装好的 ja vac 和 ja va 命令。所以，这件事能成的唯一硬性前提是：你得确保在终端里分别执行 ja vac -version 和 ja va -version 都能正常输出，并且两者的版本号得对得上。
确认 JDK 已正确安装并被 Sublime 看见
这里有个关键点：Sublime的构建系统是在子进程里执行命令的，它只认系统环境变量PATH里的 ja vac，不会去读取 JA VA_HOME 或者任何IDE级别的配置。所以，光设置 JA VA_HOME 是没用的。
- Windows用户：必须把
%JA VA_HOME%\bin这个路径明确添加到系统的PATH环境变量里，而不仅仅是设个JA VA_HOME就完事。 - macOS/Linux用户：如果用Homebrew安装了OpenJDK（比如
brew install openjdk@17），记得检查一下/opt/homebrew/opt/openjdk@17/bin这类路径是否已经包含在你的$PATH里。 - 改完环境变量后，必须彻底退出Sublime Text（不是关闭文件窗口，而是结束整个进程）再重新启动。否则，Sublime不会加载新的PATH值。
- 有个验证方法：在Sublime的控制台（快捷键
Ctrl+`）里执行import os; print(os.environ.get('PATH'))，看看打印出来的PATH是否包含了你的ja vac所在目录。
手动创建 Ja vaC.sublime-build（别信默认构建系统）
Sublime自带的那个Ja va构建系统基本是个“半成品”——不支持中文编码、不处理package包结构、编译完也不会自动运行。所以，我们必须自己动手创建一个。这个文件必须保存在 Packages/User/Ja vaC.sublime-build 这个位置。
配置文件内容如下（这是Windows/macOS/Linux通用的版本，不需要为不同平台写多份）：
立即学习“Ja va免费学习笔记（深入）”；
{
"shell_cmd": "ja vac -encoding UTF-8 -d . $file && ja va $file_base_name",
"file_regex": "^(*?):([0-9]*):?([0-9]*)",
"working_dir": "$file_path",
"selector": "source.ja va"
}
-encoding UTF-8：这个参数必须显式加上。否则，源代码里一旦有中文注释或字符串，ja vac就会报“非法字符”错误。-d .：这个参数是关键，它表示按照代码中的package声明自动创建目录结构。比如声明了package com.example;，编译后的.class文件就会输出到./com/example/目录下。ja va $file_base_name：这里是运行命令，注意是$file_base_name（不带扩展名的文件名），而不是$file。因为ja va命令只认类名，不认文件路径。working_dir：务必设为$file_path。这能确保编译和运行时的工作目录就是Ja va文件所在的目录，避免读取资源文件或导入（import）同目录其他类时出现路径错误。
文件路径与命名必须严格匹配 package 声明
Sublime Text本身不会帮你做这个检查，但 ja vac 编译器可是非常严格的。一旦不匹配，编译直接失败。而且错误信息往往很模糊，比如“class X is public, should be declared in a file named X.ja va”，新手很容易误以为是语法问题。
- 如果代码第一行是
package com.example;，那么你的Ja va文件就必须保存在类似com/example/Hello.ja va这样的路径下。注意，com和example应该是实际的子目录名，而不能只是包名前缀。 - public类的类名必须和文件名完全一致（包括大小写）。例如，类定义为
public class Main {}，那么文件名就必须是Main.ja va。 - 如果代码里没有写
package声明，文件可以放在任意目录。但要注意，构建系统里就不要使用-cp .或-d参数去指向其他位置了，否则类路径很容易混乱。
中文乱码、控制台输出问号、编译报错“非法字符”
这其实不是Sublime Text的bug，而是编码链条断裂导致的典型问题：源代码文件的保存编码、ja vac 读取源码时使用的解码方式、以及JVM运行时输出的编码，这三者如果不一致，乱码就出现了。
- 首先，看一眼Sublime右下角的状态栏，确保当前文件的编码是
UTF-8（注意，不要选成UTF-8 with BOM或者GBK）。 ja vac默认使用系统编码来读取源代码。在Windows上，系统编码通常是GBK，所以我们必须通过-encoding UTF-8参数明确告诉它用UTF-8来解码。ja va命令在运行时，默认也是用系统编码来解码输出。Windows的CMD默认是GBK，但Sublime的控制台实际上是按UTF-8来渲染的。所以，即便你在运行时加了-Dfile.encoding=UTF-8参数，也未必能解决问题。最稳妥的做法是：避免直接在控制台输出中文，可以考虑输出到日志文件，或者在外部的终端（如Windows Terminal）中运行。- 如果非要在Sublime的控制台里看到正确的中文，可以尝试修改构建系统的
shell_cmd，仅限Windows系统：cmd /c "chcp 65001 >nul && ja vac -encoding UTF-8 -d . $file && ja va $file_base_name"。这条命令会先将控制台代码页临时切换到UTF-8（65001）。
说到底，配置过程本身步骤并不多。真正把人卡住的，往往是 ja vac 和 ja va 版本不一致、working_dir 工作目录设置错误、或者文件路径与 package 声明不匹配这几个“暗坑”。一旦这几个地方出错，Sublime往往只会抛出一句模糊的错误信息。这时候，最有效的调试方法就是：打开终端，手动执行一遍构建命令，根据终端的详细输出来精准定位问题所在。
