IntelliJ IDEA 中配置 JDK 需协调项目 SDK、模块 SDK 和语言级别:先在 Project Structure → Project 设置项目 SDK 及匹配的语言级别;再在 Modules → Dependencies 中确认或调整模块 SDK;最后同步 Maven/Gradle 的编译插件版本,必要时清理缓存重启。

在 IntelliJ IDEA 中配置项目 JDK 版本,关键在于区分三个层级:项目 SDK、模块 SDK 和语言级别(Language Level),三者需协调一致,否则可能出现编译报错或运行异常。
设置项目级 JDK(Project SDK)
这是整个项目的默认基础 JDK,影响新建模块的默认配置。
- 打开 File → Project Structure(或快捷键 Ctrl+Alt+Shift+S)
- 左侧选 Project,右侧在 Project SDK 下拉框中选择已配置的 JDK(如未列出,点 New… → JDK,然后定位到 JDK 安装目录,如
C:\Program Files\Java\jdk-17) - 同时确认下方 Project language level 与所选 JDK 匹配(例如 JDK 17 对应 17 - Sealed types, pattern matching for switch)
检查并设置模块 JDK(Module SDK)
单个模块可覆盖项目级 SDK,适合多模块项目中混用不同 JDK 的场景。
- 在 Project Structure 窗口中,左侧选 Modules
- 选中对应模块,在右侧 Dependencies 标签页中,检查 Module SDK 是否为 Inherited project SDK;若需单独指定,点击下拉框选择其他已配置的 JDK
- 不建议随意更改,除非明确需要模块级隔离(如兼容老代码)
验证和常见问题处理
配置完成后务必验证是否生效,尤其注意 Maven/Gradle 项目可能覆盖 IDEA 设置。
立即学习“Java免费学习笔记(深入)”;
- 在项目根目录检查是否有
.idea/misc.xml或.idea/modules.xml,其中会记录 SDK 引用路径,但一般无需手动修改 - 如果是 Maven 项目,确保
pom.xml中的maven-compiler-plugin配置与 IDEA 设置一致,例如: - 若仍提示“Cannot resolve symbol”或编译失败,尝试 File → Invalidate Caches and Restart → Invalidate and Restart
基本上就这些。只要项目 SDK 和语言级别匹配、模块未意外覆盖、构建工具配置同步,JDK 版本就能稳定生效。










