IDE识别不到JDK需先检查JAVA_HOME是否指向JDK根目录且PATH含%JAVA_HOME%\bin，再手动在IDE中配置SDK路径；版本不匹配需统一Project SDK、Language Level及构建工具JDK版本。
IDE识别不到JDK：先看环境变量，再查IDE配置路径
IDE报“JDK not found”或新建项目时SDK列表为空，90%不是JDK没装，而是它根本没被IDE“看见”。JAVA_HOME必须指向JDK根目录（如C:\Program Files\Java\jdk-17.0.2），不能是JRE，也不能漏掉\bin在PATH里——否则命令行能用java -version，IDE却找不到javac。
- Windows：右键“此电脑”→“高级系统设置”→“环境变量”，检查
JAVA_HOME值是否准确，Path中是否含%JAVA_HOME%\bin -
macOS/Linux：运行
echo $JAVA_HOME确认路径；若用/usr/libexec/java_home -V列出多个JDK，复制对应版本的完整路径（如/Library/Java/JavaVirtualMachines/jdk-17.0.2.jdk/Contents/Home）用于IDE配置 - IntelliJ IDEA：进入
File → Project Structure → SDKs，点+→Add JDK，**手动选择该路径**，不要依赖自动扫描——自动扫描常跳过非标准安装位置
IDEA或Eclipse编译报错“不支持的class文件版本”
这是典型版本错配：代码用JDK 17编译，但IDE底层用了JDK 8的SDK，或反向操作。错误信息类似java.lang.UnsupportedClassVersionError: xxx has been compiled by a more recent version of the Java Runtime，说明字节码版本和运行时JDK不匹配。
- 在IntelliJ中，不止要设
Project SDK，还要同步检查Project language level（如选17 - Sealed types, pattern matching）和每个Module的Language level，三者必须一致 - Eclipse中右键项目→
Properties → Java Build Path → Libraries，确认JRE System Library显示的是JDK 17（而非jre1.8.0_XXX）；再进Java Compiler页签，勾选Enable project specific settings，把Compiler compliance level设为17 - VS Code用户：按
Ctrl+Shift+P→输入Java: Configure Java Runtime，在Java Tooling和Java Runtime两个区域都选同一JDK 17路径
Maven/Gradle构建结果和IDE运行结果不一致
IDE能跑通，但mvn clean compile失败，或反过来——说明构建工具和IDE各用各的JDK，互不买账。尤其Spring Boot 3.x强制要求JDK 17+，但Maven默认可能仍用系统旧版。
- Maven：在
pom.xml中显式锁死版本，避免只靠source/target：
<properties> <maven.compiler.source>17</maven.compiler.source> <maven.compiler.target>17</maven.compiler.target> <maven.compiler.release>17</maven.compiler.release> </properties>
- Gradle：用
toolchain比sourceCompatibility更可靠，它会强制Maven/Gradle进程本身也用指定JDK：
java {
toolchain {
languageVersion = JavaLanguageVersion.of(17)
}
}- 验证方式：终端执行
mvn -v，看Java version是否为17；gradle --version同理。如果仍是旧版，说明JAVA_HOME没生效，或IDE内嵌的Maven用了自带JRE
老IDE不支持新JDK特性（比如IDEA 2020.1跑JDK 21）
不是所有JDK都能塞进任意IDE。IntelliJ IDEA 2021.3才开始实验性支持JDK 17的sealed类，而JDK 21的虚拟线程（Thread.ofVirtual()）需IDEA 2023.2+。用低版本IDE硬配高版本JDK，会出现语法高亮错乱、代码补全失效、甚至调试断点不触发。
立即学习“Java免费学习笔记（深入）”；
- 查官方文档：搜索“IntelliJ IDEA system requirements”或“Eclipse Java version support”，确认你的IDE版本是否在支持列表中
- 临时绕过：若无法升级IDE，可在
pom.xml或build.gradle中降级source和target到IDE支持的最高版本（如IDEA 2020.3最高支持JDK 15），但放弃使用record、pattern matching等新特性 - 最稳妥做法：IDE和JDK都选LTS版本组合，例如IDEA 2023.3 + JDK 21，或Eclipse 2023-12 + JDK 17——LTS之间兼容性经过长期验证，出问题概率最低
真正卡住人的往往不是某一步操作，而是改完JAVA_HOME后忘了重启IDE，或清了缓存却没删.idea里的jdk.table.xml残留配置。遇到问题，先同步确认命令行、IDE全局SDK、项目SDK、构建工具四端的JDK版本输出是否完全一致，再动手改。
