Java环境配置失败主因是JAVA_HOME设错或Path引用错误路径；需确保JAVA_HOME指向JDK根目录（不含\bin），Path中添加%JAVA_HOME%\bin，并在各工具中单独配置SDK路径。
Java 环境在 Windows 上配不成功，八成卡在 JAVA_HOME 没设对、或 Path 里引用了错误路径——不是版本号写错，就是多加了 \bin 后缀。
下载 JDK 时别选错版本（特别是 jdk-21+ 的 installer）
Oracle 官网现在默认提供 .exe 安装包（带 GUI 向导），它会自动注册注册表、但不自动配置环境变量；而 OpenJDK 社区版（如 Temurin、Eclipse Adoptium）仍以 .zip 为主，解压即用，更适合手动控制路径。如果你用的是 jdk-21 或更新版，注意：从 jdk-17 起，Windows 版本已不再自带 JRE，java -version 能运行不代表 javac 一定可用——得确认你下的是 JDK（含 javac.exe），不是仅含 java.exe 的 JRE。
- 推荐去 https://www.php.cn/link/e387385ebe0dbeefed3e8e9f3968aaba 下载
Temurin JDK（免安装 zip 包） - 避免使用
jdk-*.exe+ “为所有用户安装”选项，容易导致权限路径（如C:\Program Files\...）引发后续命令行权限问题 - 解压后路径别含中文、空格、特殊符号，例如
C:\dev\jdk-21.0.1是安全的，C:\My Tools\JDK 21会大概率让 Maven/Gradle 找不到javac
JAVA_HOME 必须指向 JDK 根目录，不能带 \bin
JAVA_HOME 是绝大多数构建工具（Maven、Gradle、IDEA、Tomcat）识别 JDK 的唯一依据。设错会导致“javac is not recognized”或构建时报“Unsupported class file major version”。关键点就一个：JAVA_HOME 的值是 JDK 解压后的最外层文件夹，不是里面的 bin 子目录。
- ✅ 正确：
C:\dev\jdk-21.0.1 - ❌ 错误：
C:\dev\jdk-21.0.1\bin（这是Path里该加的） - ❌ 错误：
C:\dev\jdk-21.0.1\jre（JDK 21+ 已无独立 jre 目录） - 设置后务必在新打开的 CMD 或 PowerShell 中验证：
echo %JAVA_HOME%（Windows CMD）或$env:JAVA_HOME（PowerShell）
Path 里只加 %JAVA_HOME%\bin，别重复添加绝对路径
很多教程让你直接把 C:\dev\jdk-21.0.1\bin 写死进 Path，这看似能跑通 java 和 javac，但一旦换 JDK 版本或迁移项目，所有硬编码路径都要手动改——而且容易和 JAVA_HOME 冲突，导致 mvn compile 用的 JDK 和 java -version 显示的不一致。
立即学习“Java免费学习笔记（深入）”；
- ✅ 正确做法：在系统环境变量
Path中新增一项：%JAVA_HOME%\bin - ⚠️ 注意：
%JAVA_HOME%必须是系统变量（不是用户变量），否则某些服务类程序（如 Tomcat 作为 Windows 服务运行）读不到 - 验证方式：新开 CMD，执行
where java和where javac，输出路径应完全相同，且位于%JAVA_HOME%\bin展开后的位置 - 如果
where java返回多个结果（比如 C:\Windows\System32\java.exe），说明旧版 JRE 还残留在系统 Path 前面，把它删掉或调低优先级
IDE 和终端可能读取不同环境变量，别只信 CMD
IntelliJ IDEA、VS Code 的 Java 插件、甚至 Git Bash，都可能缓存旧的环境变量或使用自己的 JDK 配置。你在 CMD 里 java -version 正确，不代表 IDEA 里 Maven 构建用的就是同一套 JDK。
- IntelliJ：File → Project Structure → Project → Project SDK → 点击小齿轮 → Add JDK → 选择你解压的
C:\dev\jdk-21.0.1目录 - VS Code：检查
settings.json中是否有"java.home"，值应为"C:\\dev\\jdk-21.0.1"（双反斜杠） - Git Bash：它不继承 Windows 系统变量，需在
~/.bashrc中显式导出：export JAVA_HOME="/c/dev/jdk-21.0.1"和export PATH="$JAVA_HOME/bin:$PATH" - 最稳妥验证方式：在 IDE 终端里直接运行
java -XshowSettings:properties -version 2>&1 | findstr "java.home"，看实际生效路径
真正麻烦的从来不是装不上，而是 JAVA_HOME 和 Path 在不同上下文里被不同机制覆盖——尤其是当你同时用着 CMD、PowerShell、IDE 内置终端、WSL 时，每个环境都可能加载一套变量。动手前先想清楚：你现在要配的是给谁用？是命令行编译？Maven 构建？还是某个 IDE 的调试器？目标明确了，路径才不会乱。
