Java项目编译版本需统一source语法、target字节码、release跨版本三者，IDEA中Project SDK与language level要协同，Maven推荐用，Gradle应配置toolchain并验证class文件major版本。
Java项目中设置编译版本，核心是让源码、编译器、运行环境三者对齐，避免“Unsupported major.minor version”这类错误。关键不在“设一个版本”，而在于理解 source（源码语法）、target（字节码兼容目标JVM）、release（跨版本编译）三者的区别与协同。
IDEA 中正确配置 JDK 和语言级别
IntelliJ IDEA 的 Project SDK 和 Project language level 是两个独立设置，常被混淆：
- Project SDK：决定你用哪个 JDK 编译和运行（如 JDK 17），必须已安装并指向真实路径
- Project language level：控制你能写哪些语法（如是否允许 var、switch 表达式、record），它不改变字节码版本，只影响编辑器提示和语法校验
- 真正生成什么字节码，取决于 Build → Compiler → Java Compiler 中的 Target bytecode version（对应 javac 的 -target 参数）
建议：language level 与 target bytecode version 保持一致；若用 JDK 17 开发但需部署到 JRE 11 环境，则 target 设为 11，language level 也选 11（否则 var、Stream.toList() 等新语法会报错）。
Maven 项目统一控制编译参数
Maven 默认使用当前 Maven 运行的 JDK 版本编译，但应显式声明，避免因 CI 环境 JDK 升级导致意外编译失败：
立即学习“Java免费学习笔记（深入）”；
- 在
pom.xml中配置maven-compiler-plugin - 推荐用
示例（编译为 JDK 11 兼容字节码，且不调用 JDK 12+ 新增类）：
org.apache.maven.plugins maven-compiler-plugin 3.11.0 11
Gradle 项目中的版本声明方式
Gradle 5.0+ 推荐使用 java.toolchain 声明构建所需的 JDK，比旧版 sourceCompatibility 更精准：
-
java.sourceCompatibility = JavaVersion.VERSION_17：仅约束语法和 API 使用范围 -
java.targetCompatibility = JavaVersion.VERSION_17：已废弃，不再推荐 - 正确做法是启用 toolchain，并指定 vendor 和 version
示例（强制用 Adoptium JDK 17 编译，生成 17 字节码）：
java {
toolchain {
languageVersion = JavaLanguageVersion.of(17)
vendor = JvmVendorSpec.ADOPTIUM
}
}
若需向下兼容（如源码用 17 语法，但跑在 11 JVM），则需搭配 --release 11 参数（Gradle 7.4+ 支持）：
java {
toolchain {
languageVersion = JavaLanguageVersion.of(17)
}
compileJava {
options.release = 11
}
}
验证与排查常见问题
光设了不等于生效，需主动验证：
- 执行
mvn clean compile后，检查target/classes/xxx.class文件头：用javap -verbose Xxx.class | grep major，major 55 → JDK 11，56 → JDK 12，依此类推 - 运行时报
java.lang.UnsupportedClassVersionError，说明运行时 JVM 版本低于 class 文件要求的版本 - 编译时报
cannot find symbol且涉及新 API（如String.isBlank()），检查是否误用了
不复杂但容易忽略
