项目SDK与模块SDK不一致会导致编译报错或NoClassDefFoundError，因模块SDK才真正决定字节码版本、语言特性及依赖解析，两者冲突时IDE行为不可预测，且Gradle同步可能覆盖设置。
IntelliJ IDEA 里项目 SDK 和模块 SDK 不一致会怎样
直接后果是编译报错或运行时 NoClassDefFoundError，尤其在多模块 Maven/Gradle 项目中——比如父模块用 JDK 17，子模块误配成 JDK 11，var、sealed 或新 API 就会标红，但错误提示往往只说“cannot resolve symbol”，不提 SDK 版本问题。
根本原因：IDEA 的项目 SDK 是全局编译器默认值，模块 SDK 才真正决定该模块的字节码版本、语言特性支持和依赖解析范围。两者不一致时，IDE 行为不可预测，Gradle 同步后还可能被自动覆盖。
怎么查当前项目和各模块的实际 SDK 设置
打开 File → Project Structure（快捷键 Ctrl+Alt+Shift+S），左侧选 Project 看顶部的 Project SDK；再逐个点开 Modules 下的每个模块，检查各自的 Module SDK。别信 Maven 或 pom.xml 里的 <java.version>，那只是构建工具提示，IDEA 不自动同步。
- 如果模块 SDK 显示
None，说明它强制继承项目 SDK，但继承关系不保证语言级别一致 - 如果模块 SDK 显示具体版本（如
17 (java version "17.0.2")），而项目 SDK 是21，就得手动对齐 - Maven 项目同步后，模块 SDK 可能被重置为
Project SDK，需二次确认
统一 SDK 的实操步骤（Maven/Gradle 多模块）
最稳的方式是「项目 SDK 定义底线，模块 SDK 显式声明」，而不是全靠继承：
- 先设好
Project SDK为团队约定版本（如17），语言级别同步设为17 - 每个模块右键 → Open Module Settings → 在
Module SDK下拉框里，**手动选择同一版本**（不要选Inherit project SDK） - 如果是 Gradle 项目，在
build.gradle中补上java { sourceCompatibility = JavaVersion.VERSION_17 }，防止命令行构建脱节 - 改完点
Apply，然后 File → Reload project from Disk（Maven）或 Reload project（Gradle）
注意：改 SDK 后，out/production 和 out/test 编译输出目录会清空，首次编译稍慢，属于正常现象。
为什么改了还是标红？常见干扰项
SDK 对齐了但代码仍报错，大概率是缓存或元数据没刷新：
- 执行
File → Invalidate Caches and Restart → Invalidate and Restart，不是仅重启 - 检查模块的
Language level（在同一个Module Settings页面里），它必须 ≤ SDK 版本，且不能高于项目设置的语言级别 - 确认没有在模块内单独配置了
.idea/misc.xml或.idea/modules.xml错误覆盖 SDK 声明 - 如果用了 Lombok，确保 Lombok plugin 和 SDK 版本兼容（如 Lombok 1.18.30+ 才完全支持 JDK 21）
模块 SDK 这层设置看似简单，但它和编译器、构建工具、插件三者耦合极深，漏掉任意一环都可能让“看起来设对了”变成“实际没生效”。
