Sublime Text本身不支持Java编译运行，必须依赖系统PATH中的javac和java命令；配置失败主因是环境变量未透传，需确保终端与Sublime均能识别javac -version，且构建系统正确设置-d .、-encoding UTF-8及working_dir。
Sublime 本身不装 JDK，也不管你装在哪——它只认系统 PATH 里的 javac 和 java 命令。配置失败 90% 是因为终端能跑通，但 Sublime 启动时根本没拿到这些命令。
javac -version 能跑，Sublime 却报 “command not found” 怎么办
这不是 Sublime 的 bug，是它没继承你的 shell 环境变量。
- macOS：图形界面双击打开 Sublime 时，
~/.zshrc或~/.bash_profile里的$PATH默认不加载；改用终端执行open -a "Sublime Text"启动，或先运行ln -s "/Applications/Sublime Text.app/Contents/SharedSupport/bin/subl" /usr/local/bin/subl，再用subl .打开项目 - Windows：确认
JAVA_HOME指向 JDK 根目录（如C:Program FilesJavajdk-17.0.1），且%JAVA_HOME%in已加入“系统变量”中的Path（不是用户变量） - Linux：运行
which javac，如果无输出，先装完整 JDK：sudo apt install openjdk-17-jdk；再检查echo $PATH是否含$JAVA_HOME/bin - 改完环境变量后，必须彻底退出 Sublime 进程（macOS 右键 Dock 图标 → “退出”，Windows 任务管理器杀
subl.exe），再重开，否则新变量不会生效
Build System 怎么写才支持 package 和中文源码
默认的 Java.sublime-build 只编译单文件，一写 package com.example; 就崩。关键在 -d . 和 -encoding UTF-8。
Java注释规范Skills
下载
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
- 用
-d .让javac按 package 自动建目录结构（比如com/example/Hello.java编译后生成com/example/Hello.class） - 必须加
-encoding UTF-8，否则 Windows 下默认用 GBK 读源码，中文字符直接报 “非法字符” -
working_dir设为"$file_path"，不能写死成"."或绝对路径，否则import其他类或读取同目录资源会失败 - 推荐配置（保存为
Packages/User/JavaC.sublime-build）：
{
"shell_cmd": "javac -encoding UTF-8 -d . "$file" && java -cp . "$file_base_name"",
"file_regex": "^.*?:([0-9]+):([0-9]+): (.*)$",
"working_dir": "$file_path",
"selector": "source.java",
"encoding": "utf-8"
}
为什么 java 总报 “Could not find or load main class”
这不是代码问题，是 java 命令找不到类的路径或名字。核心规则就两条：类名 ≠ 文件名；类路径必须匹配 package 声明。
立即学习“Java免费学习笔记（深入）”；
- 如果源码有
package com.example;，那么Hello.java必须放在com/example/子目录下，且编译后Hello.class也得在com/example/目录里（靠-d .实现） - 运行时不能写
java Hello，得写java com.example.Hello（注意是带包名的全限定类名） - 上面的构建配置里用的是
"$file_base_name"，所以它只适用于无package声明的单文件；有 package 的项目，建议直接切到终端手动编译运行，或改用脚本封装 - 如果非要 Sublime 里跑带 package 的程序，把
shell_cmd改成："cd "$file_path" && javac -encoding UTF-8 -d . "$file" && java -cp . `dirname "$file" | sed 's|/|.|g' | sed 's|^\.||'`."$file_base_name""（仅作示意，实际建议别这么绕）
真正容易被忽略的点是：Sublime 对 Java 的支持止步于“单文件快速验证”。一旦涉及多文件、依赖管理、资源加载或标准输入交互，它立刻掉链子。这时候不是配置没到位，而是工具边界到了——该换终端，或者上 IDE。
