Java开发环境需确保JDK、IDE、Maven三者字节码版本严格对齐，重点检查JAVA_HOME、PATH、IDE Project SDK与Language Level、pom.xml或build.gradle编译配置一致性，并清理缓存。
Java开发环境不是装个JDK就完事，关键在于版本对齐、工具链协同和路径可信——多数编译失败或java.lang.UnsupportedClassVersionError错误，都源于JDK、IDE、Maven三者目标字节码版本不一致。
确认JDK安装与系统级PATH是否生效
很多问题其实卡在java -version和javac -version输出不一致，或终端里能运行但IDE里报“Cannot resolve symbol”。这往往说明：
-
JAVA_HOME没设，或指向了JRE而非JDK目录（比如/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home才对，.../jre结尾的是错的） -
PATH里$JAVA_HOME/bin没前置，导致系统优先调用旧版/usr/bin/java -
macOS上用Homebrew装过多个JDK，但没通过
sudo arch -x86_64 zsh -c "brew install openjdk@17"等明确指定架构，导致ARM/Intel混用
验证命令必须跑全：
echo $JAVA_HOME which java which javac java -version javac -version
四者输出的路径和版本号必须完全一致。
立即学习“Java免费学习笔记（深入）”；
IntelliJ IDEA中Project SDK和Language Level必须手动对齐
IDE自动探测JDK常出错：它可能选了JRE、选了旧版本、或识别出JDK但没同步Language Level。这会导致：
- 代码里用了
var或record，却提示“Language level 8 does not support …” - Maven导入后依赖标红，但
mvn compile命令行却成功——因为IDE用的是自己缓存的SDK配置，不是pom.xml里的maven-compiler-plugin配置
正确做法：
- 进
File → Project Structure → Project：设置Project SDK为已安装的JDK（如17 (17.0.x)），再把Project language level拉到对应值（如17 - Sealed types, pattern matching for switch） - 再进
Modules → Sources：确认Language level继承自Project，别手动降级 - 最后检查
Settings → Build → Compiler → Java Compiler：Target bytecode version必须和Project language level一致
Maven的source和target不能只靠IDE默认
IDEA会读pom.xml，但如果你没显式声明编译插件，它就按IDE自身language level走——而CI服务器或同事的机器很可能没配IDE，纯靠mvn命令执行，结果就是本地能跑、打包失败。
必须在pom.xml里锁定：
<properties> <maven.compiler.source>17</maven.compiler.source> <maven.compiler.target>17</maven.compiler.target> <maven.compiler.release>17</maven.compiler.release> </properties>
注意：maven.compiler.release比target更严格，它禁用所有非目标JDK的API（比如在JDK 17里编译但想跑在JDK 11上，用release会直接报错调用了String.isBlank()这种11没有的方法）。
Gradle项目更要警惕java.toolchain和sourceCompatibility分离
Gradle 17+推荐用java.toolchain而不是老式的sourceCompatibility，否则容易出现“编译用JDK 17，但测试时JVM却启动了JDK 8”。典型症状是JUnit 5测试里@TestFactory方法不执行，或Stream.toList()报NoSuchMethodError。
正确写法（build.gradle）：
java {
toolchain {
languageVersion = JavaLanguageVersion.of(17)
}
}
// 不再写 sourceCompatibility = '17' —— 它已被toolchain覆盖同时检查gradle.properties里是否有org.gradle.java.home，若有，必须指向和toolchain一致的JDK路径；若没有，Gradle会用自己的JDK（可能是Gradle wrapper自带的），那就得统一。
最常被跳过的一步：每次换JDK后，清掉IDE的~/.idea/caches和~/.m2/repository里对应_remote.repositories标记异常的包。缓存不干净，连java.util.List都能标红。
