根本原因是PATH未包含JAVA_HOME/bin路径，JAVA_HOME仅指向JDK根目录，系统不会自动在其下查找java；Windows需添加%JAVA_HOME%\bin，macOS/Linux需添加$JAVA_HOME/bin，且IDE的JDK配置与系统环境变量相互独立。
PATH里写了JAVA_HOME但java -version还是报错
根本原因不是JAVA_HOME没设对，而是PATH里漏加了%JAVA_HOME%\bin（Windows）或$JAVA_HOME/bin（macOS/Linux）。JAVA_HOME只是个指向JDK根目录的变量，系统根本不会自动去它下面找java可执行文件。
- Windows用户检查
PATH是否包含类似%JAVA_HOME%\bin，不能只写%JAVA_HOME% - macOS/Linux用户用
echo $PATH确认$JAVA_HOME/bin是否在输出中；如果用了export JAVA_HOME=...，必须在同一行或之后再export PATH=$JAVA_HOME/bin:$PATH - 改完PATH后，新开终端生效——旧终端不会自动重读环境变量
javac能用但java找不到类，或者报NoClassDefFoundError
这不是环境变量问题，是运行时类路径（-cp或CLASSPATH）没配对。尤其常见于手动编译+运行、IDE外调试、或打包成jar后执行的场景。
- 编译用
javac Main.java生成Main.class，运行时得明确告诉JVM在哪找这个类：java -cp . Main（注意.代表当前目录） - 如果类在包里（比如
com.example.Main），必须在com的父目录下执行java -cp . com.example.Main，不能进到com/example/里再跑 - 避免全局设置
CLASSPATH环境变量——它会覆盖默认的当前目录，反而让简单命令失效
装了多个JDK，java -version和javac -version显示版本不一致
说明PATH里不同JDK的bin目录顺序混乱，或者系统PATH里混进了JRE的bin（只有java，没有javac）。
- 运行
where java（Windows）或which java（macOS/Linux）看调用的是哪个java.exe；同理查javac - 常见坑：某些软件（如Android Studio、Eclipse）自带JRE并悄悄把它的
bin加进PATH前端；卸载或重装JDK后，旧路径残留 - 解决方案：清理PATH，确保只有一个JDK的
bin在最前面；Java 17+用户尤其注意别把JRE路径（如C:\Program Files\Java\jre1.8.0_301\bin）留在PATH里
Maven/Gradle项目里java命令正常，但IDE报“Cannot resolve symbol”或编译失败
IDE没读你的系统环境变量，它用自己的JDK配置。即使终端里一切正常，IDE也可能完全无视JAVA_HOME。
立即学习“Java免费学习笔记（深入）”；
- IntelliJ：File → Project Structure → Project → Project SDK → 点“+”添加本地JDK路径（不能选JRE）
- Eclipse：Preferences → Java → Installed JREs → Add → Standard VM → 指向JDK根目录（不是
bin子目录） - VS Code + Extension Pack for Java：检查
java.home设置是否指向完整JDK（如/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home），不是.../bin
JAVA_HOME是两套独立体系，改完系统变量不等于IDE自动同步。 
