Java SDK版本说了算，Language Level仅控制语法支持；编译输出兼容性由字节码版本和javac路径（即SDK）共同决定，需与SDK主版本保持一致，并注意Gradle/Maven配置、注解处理器版本的协同。
IDEA里Language Level和Java SDK版本到底谁说了算
Language Level只是编译器对语法特性的“允许开关”，不改变字节码目标版本，也不影响运行时行为。真正决定编译输出兼容性的，是project bytecode version（即编译生成的class文件版本）和你实际使用的javac路径——后者由SDK绑定。
常见错误现象：Language Level设成17，但SDK选的是JDK 8，结果连var都报错；或者SDK是JDK 17，Language Level却卡在8，导致switch表达式被标红。
- 检查顺序：先确认
Project Structure → Project → Project SDK指向正确的JDK安装路径 - 再同步设置
Project language level，建议与SDK主版本一致（如JDK 17 → Language Level 17） - 模块级覆盖：右键模块 →
Open Module Settings → Language level可单独调低，但仅限需要兼容旧环境的子模块
Gradle项目中Language Level被build.gradle覆盖了怎么办
IDEA读取build.gradle里的sourceCompatibility和targetCompatibility后，会自动同步覆盖界面设置。你手动调了Language Level，下次刷新Gradle就回去了。
使用场景：团队统一要求编译到Java 11字节码，但部分开发者本地装了JDK 17，想用新语法写代码——这时必须同时配好Gradle和IDEA。
立即学习“Java免费学习笔记（深入）”；
- 在
build.gradle中明确声明：java { sourceCompatibility = JavaVersion.VERSION_17 targetCompatibility = JavaVersion.VERSION_11 } - 对应IDEA里：SDK选JDK 17，
Project language level设为17，但Project bytecode version要手动改成11（在Settings → Build → Compiler → Java Compiler里） - 注意
targetCompatibility只控制字节码版本，不约束语法；语法上限仍由sourceCompatibility和IDEA的Language Level共同决定
为什么改了Language Level，Lombok或MapStruct还是报错
这些注解处理器（annotation processor）有自己的Java版本适配逻辑。比如Lombok 1.18.28开始才完全支持record语法，哪怕IDEA语言级别设成14，老版本Lombok仍会把record当非法关键字处理。
性能/兼容性影响：启用高Language Level后未升级配套工具链，会导致编译期静默失败、IDE索引异常、甚至调试时变量不可见。
- 检查Lombok插件版本是否匹配JDK：IDEA插件市场搜
Lombok，确认已启用且版本≥1.18.26（对应JDK 17+） - MapStruct需同步升级依赖：
org.mapstruct:mapstruct版本要≥1.5.0.Final才能识别sealed类 - 开启
Annotation Processors → Obtain processors from project classpath，避免IDEA用内置旧版AP
Maven项目切换JDK版本后，IDEA没反应
IDEA不会自动监听pom.xml里的maven-compiler-plugin配置变更。你改了<source></source>和<target></target>，但IDEA还在用旧的Language Level缓存。
常见错误现象：pom里写着<source>17</source>，IDEA里却显示Language Level 8，所有新语法全标红。
- 手动触发同步：右键项目 →
Maven → Reload project - 或打开
Settings → Build → Build Tools → Maven → Importing，勾选Import Maven projects automatically - 极端情况需清缓存：
File → Invalidate Caches and Restart → Invalidate and Restart，尤其发生在跨大版本迁移（如从JDK 8→17）时
Language Level不是独立开关，它始终依附于SDK、构建工具配置、注解处理器三者的交集。最容易被忽略的是：模块级Language Level可能和项目级不一致，而IDEA默认只显示项目级设置，右键单个模块才能看到真实生效值。
