java_home不能带\bin，因为它必须指向jdk根目录（含bin、lib等子目录），供maven等工具定位tools.jar和javac；设为\bin会导致javac找不到、编译失败。
JAVA_HOME 为什么不能带 \bin？
因为构建工具（Maven、Gradle、IDEA）靠 JAVA_HOME 找 lib/tools.jar 和 bin/javac.exe，它要的是 JDK 的“根目录”，不是“根下面的 bin”。设成 C:\dev\jdk-21\bin 看似 java -version 能跑，但 javac 会报“不是内部或外部命令”，Maven 编译直接失败。
正确写法示例：C:\dev\jdk-21（结尾不加反斜杠，路径里无空格、无中文）
- 右键文件夹 → “属性” → “位置”栏复制路径，避免隐藏字符
- 别用资源管理器地址栏复制——容易多出引号或空格
- 验证方式：CMD 中执行
echo %JAVA_HOME%，输出应和你填的一致，且该路径下能直接看到bin、lib、jmods等文件夹
Path 里只加 %JAVA_HOME%\bin，别硬编码
硬写死 C:\dev\jdk-21\bin 到 Path，换版本时得同步改两处（JAVA_HOME 和 Path），极易漏掉一个导致混乱。用变量引用才是 Windows 11 下稳定做法。
操作要点：
- 编辑系统变量
Path，新增一行：%JAVA_HOME%\bin - 把这一项拖到
Path列表最顶部——确保优先级最高 - 删掉旧 JDK 的绝对路径条目，比如
C:\Program Files\AdoptOpenJDK\jdk-17.0.2\bin - 特别注意 Oracle 自动加的
C:\Program Files (x86)\Common Files\Oracle\Java\javapath，它常排在前面，必须删或下移
改完环境变量，为什么 java -version 还是旧版本？
Windows 不会自动刷新已打开终端的环境变量，这是最常被忽略的一步。
验证前必须：
- 关闭所有 CMD/PowerShell 窗口
- 新开一个窗口再执行
java -version和javac -version，两个输出版本号必须一致 - 如果仍不对，运行
where java和where javac，看第一行路径是不是你刚配的 JDK 21 的bin目录 - 若返回多个路径，说明旧 JDK 残留，回
Path删干净再试
安装包选 MSI 还是 ZIP？
推荐下载 Eclipse Temurin 的 .msi 安装包（如 OpenJDK21U-jdk_x64_windows_hotspot_21.0.10_13.msi），但安装时务必取消勾选 “Add to PATH” —— 它会硬编码含空格路径（如 C:\Program Files\Java\jdk-21\bin），导致 Gradle 8.4+、某些 Maven 插件解析失败，报错 The filename, directory name, or volume label syntax is incorrect。
ZIP 包适合进阶用户：解压后手动配 JAVA_HOME + %JAVA_HOME%\bin，路径完全可控，但新手易漏 JAVA_HOME 或设错层级。
避坑提示：
- 别下第三方“绿色版”或“精简版”，常删掉
jmods目录，jlink工具直接失效 - Firefox 有时拦截 .msi 下载，建议用 Edge 或 Chrome
- 安装前关杀毒软件——某些国产安全软件会误拦 MSI 的注册表写入
JAVA_HOME 多了个 \bin、路径里多了个空格、或者改完没重启终端——这些细节不显眼，但会让 javac 消失得莫名其妙。
