最常见原因是修改了错误的配置文件或未使配置生效：Linux/macOS需source对应shell配置文件并确认PATH含$JAVA_HOME/bin，Windows需重启终端并检查PATH顺序及架构匹配。
Java环境变量配置后 java -version 仍报“命令未找到”
最常见原因是修改了错误的配置文件，或未在当前终端生效。Linux/macOS 下 PATH 变更只对新启动的 shell 生效，已打开的终端不会自动重载 ~/.bashrc 或 ~/.zshrc；Windows 则常因修改了用户变量却在系统级命令行中验证，或未重启 CMD/PowerShell。
- Linux/macOS：运行
source ~/.bashrc（Bash）或source ~/.zshrc（Zsh），再执行echo $PATH确认是否含$JAVA_HOME/bin - Windows：若用 CMD，改完环境变量后必须关闭并重新打开 CMD；若用 PowerShell，需运行
$env:PATH = [System.Environment]::GetEnvironmentVariable("PATH","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("PATH","User")手动刷新（但更推荐直接重启终端） - 检查
JAVA_HOME是否指向 JDK 根目录（如/usr/lib/jvm/java-17-openjdk-amd64），而非bin子目录——否则$JAVA_HOME/bin/java会变成双bin路径
Windows 上 java -version 显示旧版本，但 JAVA_HOME 已指向新 JDK
PATH 中存在硬编码的旧 JDK bin 路径（例如 C:\Program Files\Java\jdk1.8.0_202\bin），它会优先于 %JAVA_HOME%\bin 被匹配。Windows 按 PATH 从左到右搜索，顺序决定优先级。
- 在 CMD 中运行
where java，查看实际被调用的java.exe路径 - 打开系统环境变量编辑器，检查
PATH列表，删除所有显式包含旧 JDKbin的条目 - 确保
%JAVA_HOME%\bin出现在 PATH 的靠前位置（不是末尾），且没有空格或中文路径干扰 - 注意：某些 IDE（如 IntelliJ）或构建工具（如 Maven）可能缓存 JDK 路径，需在对应设置中手动切换，不依赖系统 PATH
macOS M1/M2 芯片下配置 JDK 17+ 后 javac 报错“Bad CPU type in executable”
这是典型的架构不匹配：下载了 x86_64 版本 JDK，但系统是 ARM64（Apple Silicon）。即使 JAVA_HOME 设置正确，bin/java 本身无法运行。
- 运行
arch确认当前 shell 架构（应为arm64） - 运行
file $JAVA_HOME/bin/java，输出中若含x86_64即为错配 - 卸载当前 JDK，从 Eclipse Temurin 或 Oracle 官网 下载标注
aarch64或ARM64的版本 - 安装后更新
JAVA_HOME，例如：export JAVA_HOME=$(/usr/libexec/java_home -v 17)
（该命令自动识别 ARM64 JDK）
Linux 下多 JDK 共存时如何快速切换默认 java
不要反复手动改 PATH，用 update-alternatives 统一管理更可靠，尤其适合运维或 CI 环境。
立即学习“Java免费学习笔记（深入）”；
- 先注册各 JDK：
sudo update-alternatives --install /usr/bin/java java /usr/lib/jvm/jdk-11/bin/java 11<br>sudo update-alternatives --install /usr/bin/java java /usr/lib/jvm/jdk-17/bin/java 17
- 交互式切换：
sudo update-alternatives --config java，按提示选编号 - 验证：
java -version和update-alternatives --query java - 注意：此方式不影响
JAVA_HOME，需单独设；且仅对通过/usr/bin/java调用生效，直接写绝对路径绕过该机制
