Java环境变量配置失败主因是JAVA_HOME路径错误、PATH含空格路径或未刷新终端；需将JDK装至无空格无中文路径如C:\jdk21，JAVA_HOME指向根目录，PATH添加%JAVA_HOME%\bin，并重启终端验证java/javac版本。
Java 环境变量配不成功，90% 的问题出在 JAVA_HOME 指向了错误路径、PATH 里混用了带空格的路径（比如 C:\Program Files\...），或者系统重启后没刷新终端——不是 JDK 下载错了，也不是你手速慢。
确认 JDK 下载和安装路径是否“干净”
Windows 上推荐下载 jdk-21_windows-x64_bin.exe（或最新 LTS 版）并**自定义安装到无空格、无中文的路径**，例如：C:\jdk21。别用默认的 C:\Program Files\Java\jdk-21——Program Files 中的空格会让 JAVA_HOME 在部分脚本或 IDE 中失效。
安装完成后，进该目录确认存在 bin 和 lib 子目录；如果只有 jre 目录，说明装的是 JRE，不是 JDK，得重下。
- 检查方式：打开文件资源管理器，直接访问你指定的安装路径，看是否有
bin\javac.exe - 命令行验证（临时）：
C:\jdk21\bin\java -version能输出版本即说明安装本身没问题 - Mac/Linux 用户注意：
/Library/Java/JavaVirtualMachines/下的路径要带完整版本号子目录，如jdk-21.jdk/Contents/Home
设置 JAVA_HOME 必须指向 JDK 根目录，不是 bin
JAVA_HOME 是 Java 生态里几乎所有工具（Maven、Gradle、Tomcat、IDEA）识别 JDK 的唯一依据。它必须是 JDK 的**根目录**，不是 bin，也不是 jre。
立即学习“Java免费学习笔记（深入）”；
Windows 示例（系统环境变量）：
JAVA_HOME = C:\jdk21
Mac/Linux（写入 ~/.zshrc 或 ~/.bash_profile）：
export JAVA_HOME=$(/usr/libexec/java_home -v 21) # 或硬编码（不推荐）： export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-21.jdk/Contents/Home
- Windows 用户切勿在
JAVA_HOME后加\bin，否则 Maven 会报Failed to find tools.jar - Mac 用户优先用
/usr/libexec/java_home -v X动态获取路径，避免手动写错 - 设置完别忘了在新终端里执行
source ~/.zshrc（Mac）或重启 CMD/PowerShell（Windows）
PATH 添加 %JAVA_HOME%\bin（Windows）或 $JAVA_HOME/bin（Mac/Linux）
PATH 是让 java、javac 命令能在任意目录下直接运行的关键。它不替代 JAVA_HOME，而是依赖它。
Windows（系统 PATH 变量中新增）：
%JAVA_HOME%\bin
Mac/Linux（追加到 shell 配置文件）：
export PATH=$JAVA_HOME/bin:$PATH
- Windows 用
%JAVA_HOME%\bin，不是%JAVA_HOME%/bin（反斜杠是 Windows 路径分隔符） - 确保这一项在 PATH 最前面，避免旧版本 JDK 干扰（可用
where java查看实际调用路径） - Linux 下如果
java -version显示的是 OpenJDK 11，但$JAVA_HOME指向 JDK 21，大概率是PATH里有别的java在前，用echo $PATH检查顺序
验证时别只信 java -version，要测 javac 和 JAVA_HOME 是否生效
只跑 java -version 成功不代表配置完成。很多初学者卡在 Maven 编译失败，就是因为 javac 找不到或 JAVA_HOME 没被读取。
逐条执行以下命令，全部通过才算真正配好：
echo %JAVA_HOME% # Windows echo $JAVA_HOME # Mac/Linux java -version javac -version
- 如果
javac -version报 “不是内部或外部命令”，说明PATH没包含%JAVA_HOME%\bin或路径拼写错误 - 如果
echo %JAVA_HOME%输出为空，说明环境变量根本没设成功，或设成了用户变量但你在管理员 CMD 里验证（用户变量在管理员模式下不可见） - IntelliJ IDEA 或 Eclipse 不会自动继承新设的系统环境变量，需完全退出再重开
最常被忽略的一点：改完环境变量后，所有已打开的终端、IDE、命令行窗口都得关闭重开——它们启动时就缓存了当时的环境变量，不会动态更新。
