Target bytecode version是IDEA中控制生成.class文件兼容JVM版本的关键配置，对应javac的-target参数，决定字节码主版本号，需与Project SDK及构建工具配置协同一致。
Java Compiler 设置里的 Target bytecode version 是什么
它不是运行时 JDK，而是告诉 IDEA 的编译器：生成的 .class 文件要兼容哪个 JVM 版本。比如设为 17，生成的字节码就不能被 JDK 8 的 JVM 加载——哪怕你用 JDK 21 编译，只要这里选了 17，结果就是 JVM 17+ 可运行。
这个值和 maven-compiler-plugin 的 <target>、Gradle 的 targetCompatibility 语义完全一致，IDEA 会读取构建配置自动同步，但手动改过之后就可能脱钩。
- 路径是：
File → Settings → Build, Execution, Deployment → Compiler → Java Compiler - 关键字段叫
Target bytecode version，不是 “Project SDK” 或 “Language level” - 如果项目含多个模块，勾选
Per-module bytecode version后，每个模块可单独设置；否则统一走全局默认
为什么改了 Project SDK 还报 “源发行版 17 需要目标发行版 17”
因为 Project SDK（在 Project Structure → Project 里）只决定 IDE 用哪个 JDK 去编译、补全、检查语法，不控制字节码生成版本。真正触发这句警告的是编译器后端对 source 和 target 不匹配的校验。
- 常见组合错误：
Project SDK = JDK 21，但Target bytecode version = 11，同时代码用了var或sealed——这时source实际按 21 解析，但target却限制为 11，冲突就爆出来 - Gradle 项目里，
sourceCompatibility = 17但没设targetCompatibility，IDEA 可能 fallback 到旧默认值（如 11），导致不一致 - Maven 项目若没配
maven-compiler-plugin，IDEA 默认用Project language level推导target，但推导逻辑不透明，容易误判
Module SDK 和 Target bytecode version 谁优先
Module SDK 决定用哪个 JDK 的 javac 执行编译，Target bytecode version 决定传给那个 javac 的 -target 参数。两者必须兼容：不能用 JDK 8 的 javac 去生成 -target 21 的字节码。
- 例如：模块 SDK 设为
JDK 8，但Target bytecode version设成21→ 编译直接失败，报错类似error: invalid target release: 21 - 反过来：模块 SDK 是
JDK 21，Target bytecode version设为8，能成功，但会丢弃所有新语法（如record会报错） - 安全做法：模块 SDK 主版本 ≥
Target bytecode version，且Project language level与Target bytecode version保持一致（如都用17）
构建工具（Maven/Gradle）改了，IDEA 没同步怎么办
IDEA 默认会监听 pom.xml 或 build.gradle 变更并自动刷新，但有时卡住或被禁用。最直接的验证方式是看 Target bytecode version 字段右侧是否显示 “Managed by Maven” 或 “Managed by Gradle” 提示。
- 没提示？点右上角
Reload project（Maven）或Refresh Gradle project（Gradle）按钮 - 仍不同步？检查 Maven 配置是否真生效：
<properties><maven.compiler.source>17</maven.compiler.source><maven.compiler.target>17</maven.compiler.target></properties>，注意别漏掉<target> - Gradle 中若用了
java { toolchain { languageVersion = JavaLanguageVersion.of(21) } }，IDEA 2026.1+ 才支持自动映射，旧版需手动设targetCompatibility
真正容易被忽略的是：模块级 Target bytecode version 一旦手动修改过，就会脱离构建工具管理，后续即使改了 pom.xml 也不会自动回滚——得手动清空再重载。
