绝大多数情况下缺的是JDK而非JRE；JRE仅运行.class文件，JDK才含javac等开发工具，JAVA_HOME必须指向JDK根目录且PATH需包含%JAVA_HOME%\bin或$JAVA_HOME/bin。
Java程序跑不起来，到底是缺JRE还是JDK？
绝大多数情况下，你缺的是JDK，不是JRE。JRE只负责运行已编译的.class文件；JDK才包含javac、jar、javadoc这些开发必需工具。如果你在IDE里点运行报“Command 'javac' not found”，或者命令行敲javac提示“command not found”，那基本就是没装JDK，或JAVA_HOME指向了仅含JRE的路径。
- JRE安装包通常叫“Java Runtime Environment”，官网下载页会明确标出“JRE”字样；JDK则叫“Java Development Kit”
- Windows上JRE默认装在
C:\Program Files\Java\jre1.8.0_301这类路径；JDK则是C:\Program Files\Java\jdk-17.0.2这种 - macOS用Homebrew装的话，
brew install openjdk装的是JDK；brew install --cask temurin-jre才是纯JRE（极少有人单独装）
JAVA_HOME该设成JDK还是JRE的路径？
JAVA_HOME必须指向JDK根目录，不能指向JRE。很多构建工具（Maven、Gradle）、IDE（IntelliJ、Eclipse）和脚本都依赖$JAVA_HOME/bin/javac存在。设成JRE路径会导致编译失败，且错误信息往往不直接说“缺javac”，而是报Failed to execute goal org.apache.maven.plugins:maven-compiler-plugin这类模糊提示。
- 验证方式：执行
$JAVA_HOME/bin/javac -version，有输出即正确；若提示“command not found”，说明路径错了 - Linux/macOS建议在
~/.zshrc或~/.bash_profile里写：export JAVA_HOME=/usr/lib/jvm/jdk-17.0.2（路径以实际为准） - Windows注意不要带末尾反斜杠：
setx JAVA_HOME "C:\Program Files\Java\jdk-17.0.2"（多一个\可能让某些脚本解析失败）
为什么PATH里还要加%JAVA_HOME%\bin？
因为操作系统靠PATH找命令，JAVA_HOME只是个环境变量，不参与命令搜索。即使JAVA_HOME设对了，如果%JAVA_HOME%\bin没进PATH，终端依然找不到java、javac这些可执行文件。
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- Windows：PATH里要显式加
%JAVA_HOME%\bin，不能只靠JAVA_HOME - macOS/Linux：PATH中加
$JAVA_HOME/bin，顺序很重要——如果系统自带老版本Java也在PATH里，把它放前面会导致java -version显示旧版 - 常见陷阱：改完PATH后没新开终端，导致
which java仍指向旧位置
IDE里提示“Project SDK is not defined”怎么办？
这是IDE（尤其是IntelliJ）在告诉你：它没找到可用的JDK，或者找到了但没被选为项目SDK。这个设置和系统级JAVA_HOME无关，是IDE自己的配置项，必须手动指定到JDK安装目录（不是JRE，也不是bin子目录）。
立即学习“Java免费学习笔记（深入）”；
- IntelliJ：File → Project Structure → Project → Project SDK → Add JDK → 选中
jdk-17.0.2文件夹（路径里不能有/bin） - Eclipse：Preferences → Java → Installed JREs → Add → Standard VM → JRE home选JDK根目录（Eclipse允许把JDK当JRE用）
- VS Code + Extension Pack for Java：需要在
settings.json里配"java.home"，值为JDK路径，例如"java.home": "/Library/Java/JavaVirtualMachines/jdk-17.0.2.jdk/Contents/Home"
真正容易被忽略的是：同一台机器上多个JDK共存时，JAVA_HOME、IDE的SDK设置、Maven的toolchains.xml、甚至单个项目的.java-version（用jEnv时）可能各自指向不同版本。出问题时别只查一处，得挨个确认。
