最常见原因是shell配置未重载或写错文件：Linux/macOS需根据$SHELL确认改~/.zshrc或~/.bashrc并source生效；Windows需将%JAVA_HOME%\bin置PATH最前且JAVA_HOME末尾不加反斜杠。
Java环境变量配置后 java -version 仍报“command not found”
最常见原因是系统未重新加载 shell 配置，或配置写到了错误的文件里。Linux/macOS 下，~/.bashrc、~/.zshrc、/etc/profile 作用范围不同：~/.bashrc 只对交互式非登录 shell 生效（比如新打开的终端标签页），而 /etc/profile 对所有登录 shell 生效，但普通用户通常没权限改它。
- 确认你编辑的是当前 shell 正在使用的配置文件：运行
echo $SHELL，如果是/bin/zsh就该改~/.zshrc；如果是/bin/bash，注意 macOS Catalina 后默认是 zsh，改~/.bashrc不起作用 - 配置写完必须手动重载：执行
source ~/.zshrc（或对应文件），不能只靠关掉再开终端——某些终端（如 VS Code 内置终端）启动时不会触发 login shell，不会自动读/etc/profile -
JAVA_HOME必须指向 JDK 根目录，不是bin子目录：正确是/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home，错误是.../Home/bin - 检查
PATH是否拼错：应是export PATH=$JAVA_HOME/bin:$PATH，漏掉$JAVA_HOME/bin或写成$JAVA_HOME（没带/bin）都会导致java命令找不到
Windows 上 java -version 显示旧版本，但 JAVA_HOME 已指向新 JDK
Windows 的 PATH 是顺序匹配的，系统会取第一个找到的 java.exe。即使 JAVA_HOME 指向 JDK 17，如果 PATH 里有 C:\Program Files (x86)\Common Files\Oracle\Java\javapath 这种路径，它可能包含旧版 JRE 的 java.exe，且排在 %JAVA_HOME%\bin 前面。
- 在命令行运行
where java，查看实际被调用的java.exe路径——这是唯一可信依据 - 进「系统属性 → 高级 → 环境变量」，在「系统变量」中检查
PATH，把%JAVA_HOME%\bin移到最前面，或直接删掉 Oracle 自动加的javapath条目（它常驻后台更新，干扰性强） - 确认
JAVA_HOME值末尾**不要加反斜杠**：C:\jdk-17✅，C:\jdk-17\❌ —— 某些 Java 工具（如 Maven）会因结尾斜杠解析失败 - 修改后必须新开命令行窗口，CMD/PowerShell 不继承父进程的环境变量变更
IDE（IntelliJ / Eclipse）不认系统 JAVA_HOME，仍用内置 JRE
IDE 启动时读取的是其自身启动进程的环境变量，而不是你终端里设置的那个。尤其 macOS/Linux 下通过桌面图标或 Dock 启动的 IDE，根本没加载你的 shell 配置。
- IntelliJ：进入
Help → Edit Custom VM Options...，添加-Didea.jdk.home.path=/path/to/jdk（仅限部分版本），更可靠的是在项目设置里指定 SDK：File → Project Structure → Project → Project SDK - Eclipse：Window → Preferences → Java → Installed JREs，点 Add… 手动添加 JDK 路径，再勾选它为默认；同时检查 Run Configurations → JRE 选项卡是否设为 “Use workspace default JRE”
- VS Code + Extension Pack for Java：确保
java.home设置正确，在settings.json中写"java.home": "/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home"，路径必须精确，不能用~或环境变量占位符
Gradle/Maven 构建时提示 “Unsupported class file major version”
这说明构建工具用的 Java 版本低于源码编译版本。例如用 JDK 17 编译了代码（class 文件版本 61），但 Gradle 启动时用了 JDK 8（最多支持版本 52），就会报这个错。根源常是构建工具自举时没读取 JAVA_HOME，而是用了系统默认或自带的 JRE。
立即学习“Java免费学习笔记（深入）”；
- Gradle：检查
gradle -version输出的 “JVM” 行，确认它和java -version一致；若不一致，在gradle.properties中显式指定：org.gradle.java.home=/path/to/jdk-17 - Maven：运行
mvn -version，看 “Java version” 是否匹配；可设置MAVEN_OPTS="-Djava.home=/path/to/jdk-17"，或在mvn脚本开头硬编码JAVA_HOME - Docker 构建中出问题？镜像内没装 JDK 或
JAVA_HOME未 export —— Alpine 镜像常用openjdk17-jre（只有 JRE），要换openjdk17-jdk
export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64 export PATH=$JAVA_HOME/bin:$PATH # 注意：这行必须存在，且位置要在 PATH 修改之后才生效 source ~/.zshrc
环境变量本身没有“全局广播”机制，每个进程只继承启动时父进程的副本。改完配置却没生效，大概率不是配错了，而是没让目标进程真正看到它——查 where java 或 which java，看它到底从哪来的，比反复检查配置文件更直接。
