JAVA_HOME必须指向JDK根目录而非bin目录，因为Maven等工具需通过它定位lib下的tools.jar或jrt-fs.jar等核心类库；PATH应配置为%JAVA_HOME%\bin或$JAVA_HOME/bin以确保java与javac版本一致。
为什么 JAVA_HOME 必须指向 JDK 根目录，而不是 bin 目录
很多初学者把 JAVA_HOME 设成 C:\Program Files\Java\jdk-17\bin，结果 javac 找不到或 Maven 报错。这是因为 JAVA_HOME 的设计本意是“JDK 的安装根路径”，所有工具链（如 javac、javadoc、java）都通过它拼接子路径定位资源 —— 比如 Maven 会去 $JAVA_HOME/lib/tools.jar（JDK 8）或 $JAVA_HOME/lib/jrt-fs.jar（JDK 9+）加载编译器 API。bin 是可执行文件所在目录，不是“家”。
-
JAVA_HOME应设为C:\Program Files\Java\jdk-17（Windows）或/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home（macOS） - Windows 下建议用双引号包裹含空格的路径，避免批处理解析失败
- Linux/macOS 中若用
export JAVA_HOME=/path/to/jdk，需确保该行在~/.bashrc或~/.zshrc中，并执行source ~/.zshrc
PATH 中该加 %JAVA_HOME%\bin 还是直接加绝对路径
必须加 %JAVA_HOME%\bin（Windows）或 $JAVA_HOME/bin（Unix），不能硬编码绝对路径。否则换 JDK 版本时要改两处：JAVA_HOME 和 PATH，极易遗漏导致 java -version 和 javac -version 显示不同版本。
- Windows：在系统变量
PATH开头追加%JAVA_HOME%\bin，避免被旧版 JRE 覆盖 - macOS/Linux：在 shell 配置中先定义
JAVA_HOME，再写export PATH=$JAVA_HOME/bin:$PATH，顺序很重要 —— 把 JDK 的bin放最前才能优先命中 - 验证命令：
which java和which javac应输出同一路径下的两个文件
为什么 java -version 正常但 javac 找不到
这是典型的 PATH 配置错误：系统自带的 JRE（比如 Windows 的 C:\Windows\System32\java.exe）或旧版 JDK 的 bin 在 PATH 中排在前面，导致 java 命令能运行，但 javac 不在那个路径下。JRE 没有 javac，只有 JDK 才有。
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 运行
where java（Windows）或which java（macOS/Linux）看实际调用的是哪个java - 检查该路径上级是否包含
javac；不包含就说明调错了 JDK - 临时修复：命令行中先执行
set JAVA_HOME=...（Windows）或export JAVA_HOME=...（macOS/Linux），再重设PATH，观察是否立即生效
Maven/Gradle 依赖 JAVA_HOME 的真实行为
Maven 和 Gradle 并不只靠 PATH 找 java，它们会主动读取 JAVA_HOME 变量来定位 JDK 内部类库和工具链。例如 Maven 的 maven-compiler-plugin 在 JDK 11+ 下需要 $JAVA_HOME/lib/jrt-fs.jar 来访问模块系统元数据；Gradle 的 JavaCompile 任务也会通过 JAVA_HOME 加载 tools.jar（JDK 8）或 jdk.compiler 模块（JDK 9+）。
立即学习“Java免费学习笔记（深入）”；
- 即使
java和javac都能运行，若JAVA_HOME指向 JRE 或错误路径，Maven 编译可能报Unsupported class file major version或找不到javax.annotation - IntelliJ IDEA 的 Maven 运行配置默认继承系统环境变量，但终端启动的 IDEA 可能不读
~/.zshrc—— 建议在 IDE 设置里显式指定JDK home path
JAVA_HOME 和 PATH 必须同步更新，且要验证 javac -version 与 java -version 输出完全一致。任何不一致，都是环境变量没对齐的明确信号。 
