Java版本与JAVA_HOME配置错误导致编译运行失败：需确保JAVA_HOME指向JDK根目录（非bin）、路径无空格/中文；Maven需≥3.6.3且maven-compiler-plugin≥3.8.0；IDE需独立配置JDK路径；多JDK共存时应统一终端实际调用版本。
Java版本和JAVA_HOME路径配错最常见
新手常直接下载最新版JDK（比如JDK 21），但IDE或构建工具（如Maven）默认不认高版本，报错Unsupported class file major version。关键是JAVA_HOME必须指向JDK根目录（不是bin子目录），且路径中不能含中文、空格或Program Files这类带空格的文件夹。
- 验证方式：终端运行
echo $JAVA_HOME（macOS/Linux）或echo %JAVA_HOME%（Windows），再执行java -version和javac -version，两个输出版本号必须一致 - Windows用户容易把
JAVA_HOME设成C:\Program Files\Java\jdk-17.0.1\bin——错，bin要删掉 - Mac用户用Homebrew装的OpenJDK，路径通常是
/opt/homebrew/opt/openjdk，但这个是符号链接，建议用realpath确认真实路径
Maven找不到tools.jar或提示Could not find artifact
这是JDK 9+彻底移除tools.jar导致的典型兼容问题。如果你用的是老教程或旧版Maven插件（比如maven-compiler-plugin低于3.8.0），它仍尝试加载已不存在的jar，就会失败。
- 检查
pom.xml里maven-compiler-plugin版本：3.11.0 - Maven本身也要≥3.6.3（官网下载页明确标“JDK 11+”支持）
- 别手动往
lib目录塞tools.jar——JDK 17根本没这个文件，硬塞会引发类加载冲突
IDE（IntelliJ / Eclipse）识别不到JDK或编译级别错乱
IDE的JDK配置和系统环境变量是两套独立设置。即使JAVA_HOME正确，IDE也可能用自带的JRE或缓存旧路径。
- IntelliJ：File → Project Structure → Project → Project SDK → 点“+”添加JDK，选你本地安装的
jdk-17.0.1目录（不是jre） - Eclipse：Preferences → Java → Installed JREs → Add → Standard VM → Directory选JDK根目录；再进Project → Properties → Java Build Path → Libraries → 右侧“Edit…”确保用的是刚添加的JDK
- 项目级编译级别（如Language Level）要和JDK版本匹配：JDK 17对应
17 - Sealed types, pattern matching for switch，别选成8或21
运行时NoClassDefFoundError却明明有.class文件
这通常不是缺类，而是类加载器找不到依赖——尤其新手把javac和java命令混用时路径没对齐。
立即学习“Java免费学习笔记（深入）”；
-
javac Hello.java生成Hello.class后，必须在Hello.class所在目录执行java Hello（不能加.class后缀） - 如果类在包里（如
package com.example;），源文件必须放在com/example/Hello.java路径下，编译后进入com/example/上一级目录，再用java com.example.Hello - 用
-cp指定类路径时，当前目录要用.表示：java -cp ".:lib/some.jar" Main（macOS/Linux）或java -cp ".;lib\some.jar" Main（Windows）
最麻烦的其实是多个JDK共存时的隐性冲突——比如Android Studio自带JDK、VS Code Java插件自配JDK、系统又装了一个，三者版本和JAVA_HOME不同步，错误信息却只报“无法启动”。遇到这种，先关掉所有IDE，只用终端跑java -version和which java（macOS/Linux）或where java（Windows），盯住到底调用的是哪个java可执行文件。
