Sublime调用不了javac或java，90%是系统JDK未配好；先确保终端中javac -version和java -version成功，再检查JAVA_HOME、PATH、包路径、编码（UTF-8）、依赖配置等。
Sublime 调用不了 javac 或 java，90% 是系统级 JDK 没配好，不是 Sublime 配置错了。先在终端里跑通 javac -version 和 java -version，否则后面所有构建系统都白搭。
javac -version 报错？先别碰 Sublime 配置文件
这是最常被跳过的硬前提。Sublime 不自带编译器，只调用你系统 PATH 里的命令。如果终端里 javac -version 失败，Sublime 的构建系统一定失败——它根本看不到 javac。
- Windows：检查
JAVA_HOME是否指向 JDK 根目录（如C:\Program Files\Java\jdk-17.0.1），且%JAVA_HOME%\bin已加进系统PATH；只装了 JRE 会通过java -version但卡在javac - macOS：用
brew install openjdk@17后，确认/opt/homebrew/opt/openjdk@17/bin在$PATH里；which javac必须有输出 - Linux：安装的是
openjdk-17-jdk（不是-jre），再执行sudo update-alternatives --config java和--config javac确保两者指向同一版本 - 改完环境变量后，必须彻底退出 Sublime 进程（macOS 右键 Dock 图标 → Quit；Windows 任务管理器杀
subl.exe），否则它仍读旧环境
运行报 “Error: Could not find or load main class”
这不是代码写错了，是 java 命令没找对类路径或类名。关键在于：类名 ≠ 文件名，而取决于 package 声明和工作目录结构。
- 如果源码第一行是
package com.example;，文件就必须放在com/example/HelloWorld.java，且构建时working_dir必须设为com的上一级目录（即包含com/的那个目录） - 构建命令里不能用
java "$file_base_name"直接运行带包的类；得用完整类名，比如java com.example.HelloWorld，且此时working_dir得是com的父目录 - 默认
JavaC.sublime-build不加-d .参数，javac会把.class全塞进当前目录，破坏包结构；必须显式加上"shell_cmd": "javac -d . \"$file\" && java \"$file_base_name\"" - 如果不想折腾包路径，最简做法：删掉所有
package行，把.java文件全放在项目根目录，用working_dir: "$file_path"即可
中文乱码、编译报 “非法字符” 怎么办
Windows 下尤其典型，本质是三处编码不一致：Sublime 文件保存编码、javac 读源码用的编码、控制台输出解码用的编码。三者只要一个错位，就出方块或问号。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
立即学习“Java免费学习笔记（深入）”；
- Sublime 右下角确认文件编码是
UTF-8（不是UTF-8 with BOM）；如果不是，点它 →Reopen with Encoding→UTF-8，再Save with Encoding→UTF-8 - 构建命令里必须加
-encoding UTF-8，否则 Windows 上javac默认用 GBK 解码 UTF-8 源文件，直接报错“非法字符” - 控制台输出乱码：Windows 用户可在
shell_cmd前加chcp 65001 > nul &&（注意&&是转义后的&），强制 CMD 切到 UTF-8 模式 - macOS/Linux 一般无此问题，但若用了非系统默认 shell（如 zsh 配了特殊 locale），也要检查
locale输出是否含UTF-8
为什么 JavaC 插件跑不起来带依赖的项目
因为 JavaC 插件（r-stein 版）只做单文件编译，不处理 -cp、不解析 pom.xml、也不支持通配符 *.jar。它本质是个快捷按钮，不是构建工具。
- 想加 jar 依赖，得手动改构建系统的
shell_cmd，例如："javac -cp \".;lib/*\" -encoding UTF-8 \"$file\" && java -cp \".;lib/*\" \"$file_base_name\""（Windows） - macOS/Linux 要把分号
;换成冒号:，且通配符lib/*在某些 shell 下需展开，可能得写成lib/a.jar:lib/b.jar - 一旦项目有多个源文件、跨包引用、资源文件（如
resources/），JavaC 插件完全失效；这时应转向javac+java手动命令，或换用 VS Code + Extension Pack for Java - Sublime 从不读取项目配置文件（
build.gradle、pom.xml），所谓“自动识别 Maven 项目”纯属误解
真正卡住人的从来不是 JSON 写法，而是 javac 对包路径的绝对要求、Windows 控制台的编码 Legacy、以及误以为 Sublime 能替代 IDE 的预期。把 javac -version 和文件路径匹配这两件事盯死，剩下都是可调的参数。
