Java项目指定目标运行版本需协同配置-source、-target和--release参数，推荐使用--release一站式约束语法、API和字节码；Maven通过maven-compiler-plugin设，Gradle用java.toolchain与options.release组合实现精准控制。
在Java项目中指定目标运行版本，关键在于正确配置编译器的源码版本（-source）、字节码目标版本（-target）以及运行时兼容版本（--release或-bootclasspath），三者需协同一致，否则可能引发 UnsupportedClassVersionError 或运行时行为异常。
明确区分 source、target 和 release 参数
-source 控制编译器接受的 Java 语法特性（如是否允许 var、switch 表达式）；-target 决定生成的 class 文件主版本号（对应 JVM 能否加载）；而 --release（推荐使用）则一站式约束语法、API 和字节码版本，自动适配对应 JDK 的系统类库，避免意外调用高版本 API。
- 例如：用 JDK 17 编译但要求运行在 Java 11 环境，应优先用
--release 11，而非仅设-source 11 -target 11 -
--release自 JDK 9 引入，不支持跨大版本回退（如 JDK 17 不支持--release 8），此时需搭配对应 JDK 8 编译或使用-bootclasspath
Maven 项目中的标准配置方式
Maven 默认继承 JDK 版本，但显式声明更可靠。通过 maven-compiler-plugin 统一控制：
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.11.0</version>
<configuration>
<source>11</source>
<target>11</target>
<!-- 推荐替代方案 -->
<!-- <release>11</release> -->
</configuration>
</plugin>- 启用
<release></release>后，<source></source>和<target></target>会被忽略，且编译过程完全隔离于当前 JDK 的 API - 若项目依赖第三方库含高版本字节码，需确保其提供对应低版本兼容包，或升级运行环境
Gradle 项目中的等效设置
Gradle 从 6.7+ 开始推荐使用 java.toolchain + javacArgs 组合实现精准控制：
立即学习“Java免费学习笔记（深入）”；
java {
toolchain {
languageVersion = JavaLanguageVersion.of(11)
}
}
compileJava {
options.release = 11 // JDK 11+ 编译器支持
// 或手动指定：
// options.compilerArgs += ['-source', '11', '-target', '11']
}-
toolchain指定构建使用的 JDK，options.release锁定语义和字节码目标，二者配合最稳妥 - 旧版 Gradle（sourceCompatibility 和
targetCompatibility，但不如release安全
验证与常见问题排查
编译后可通过 javap -verbose YourClass.class | grep "major version" 查看实际字节码版本（major version 对照表：52→Java 8，55→11，61→17）；同时检查运行日志是否出现 java.lang.UnsupportedClassVersionError。
- 错误提示中 “Unsupported major.minor version XXX” 中的 XXX 即 class 文件主版本号，对照目标 JVM 支持范围即可定位不匹配点
- IDE（如 IntelliJ）需同步设置：Project SDK、Project language level、Compiler compliance level，三者须一致
- Spring Boot 项目还需检查
spring-boot-maven-plugin的jvmVersion（打包用）是否与编译版本对齐
