java环境变量配置不生效，关键在四环节：java_home必须指向jdk根目录（不含bin），path需含%java_home%\bin且优先级最高，终端须重启或source刷新，验证须同时检查java -version、javac -version和echo %java_home%。
Java环境变量配置不生效，问题往往不在步骤本身，而在于几个关键环节没对上。排查要从路径、变量名、加载机制、验证方式四方面入手，逐层确认。
JAVA_HOME 路径是否真实且指向正确目录
这是最常出错的第一环。JAVA_HOME 必须是 JDK 的根目录（如 C:\Program Files\Java\jdk-21），不能带 \bin，也不能指向 JRE 或任意子文件夹。
- 在命令行中运行
echo %JAVA_HOME%（Windows）或echo $JAVA_HOME（macOS/Linux），看输出是否为空或明显错误 - 手动打开该路径，确认目录下存在
bin\javac.exe（Windows）或bin/javac（macOS/Linux） - 路径含空格（如
Program Files）无需加引号，但复制时容易多出反斜杠或换行符，建议重新手输一遍 - 安装的是 JRE 就别硬配 JDK —— JRE 没有
javac，java -version成功但javac -version失败，大概率是这个原因
PATH 是否真正包含 %JAVA_HOME%\bin 并优先生效
只设 JAVA_HOME 不够，PATH 才决定系统能不能找到 java 和 javac 命令。
- 检查 PATH 中是否添加了
%JAVA_HOME%\bin（Windows）或$JAVA_HOME/bin（macOS/Linux），而不是直接写死绝对路径 - Windows 下用
where java和where javac查看实际调用的是哪个位置的可执行文件；若指向C:\Windows\System32\java.exe或 Android Studio 自带 JDK，说明 PATH 里有更高优先级的干扰项 - 多个 Java 路径共存时，PATH 是从左到右匹配，把
%JAVA_HOME%\bin移到 PATH 列表顶部更稳妥 - Linux/macOS 用户注意：改完
~/.zshrc后必须source ~/.zshrc，改~/.bashrc却用 zsh 终端就无效
环境变量是否真正被当前终端读取
系统保存了变量，不代表你正在用的命令行窗口知道这件事。
- Windows：修改后必须关闭所有 CMD/PowerShell 窗口，再新开一个；用管理员身份开的 CMD 和普通用户开的 CMD 读取的变量层级可能不同
- macOS/Linux：不同 shell 加载不同配置文件（zsh 默认读
~/.zshrc，bash 读~/.bash_profile），改错文件等于白改 - IDE（如 IntelliJ、VS Code）和构建工具（如 Maven、Gradle）通常不继承系统环境变量，它们有自己的 JDK 设置入口，需单独配置
- 某些工具（如 Git Bash、WSL）走的是 Linux 子系统逻辑，不读 Windows 系统变量，得在对应 shell 配置里重设
验证方式是否覆盖核心环节
只跑 java -version 容易误判，它成功不代表编译器可用、也不代表 JAVA_HOME 生效。
- 必须同时验证三项：
java -version、javac -version、echo %JAVA_HOME%（或echo $JAVA_HOME） -
javac -version失败 → PATH 没包含 bin，或 JAVA_HOME 指向了 JRE -
echo %JAVA_HOME%为空 → 变量根本没设对，或设在了错误的作用域（比如该设系统变量却只设了用户变量） - 在新终端中执行
where java（Windows）或which java（macOS/Linux），确认路径与预期一致
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
