IntelliJ IDEA 切换 JDK 版本完整指南
在 Java 开发过程中,根据项目依赖或兼容性要求切换 JDK 版本是常见操作。无论是从 JDK 8 升级到 17,还是回退到 11,配置不当容易导致编译报错或运行异常。本文将结合 IntelliJ IDEA 的中文界面,详解如何正确配置全局及项目级 JDK,确保环境一致。
一、设置全局默认 JDK
若未打开任何项目,可直接在启动界面点击「文件 → 新项目设置 → 新项目的结构」;若已打开项目,则选择「文件 → 项目结构」。这是为所有新项目设定基准版本的关键步骤。
- 在左侧菜单选择「平台设置 → SDK」。
- 点击右上角「+」号,选择「从磁盘添加 JDK...」。
- 在文件选择窗口中,定位到目标 JDK 的根目录(例如
C:\jdk\jdk21),注意不要选入bin子文件夹,点击「确定」。 - IDEA 会自动识别版本信息,确认无误后点击「应用」。
提示:只有右侧「类路径」能清晰识别到多个核心包时,才算添加成功。如果提示无效,请检查是否选择了正确的 JDK 根目录。
接下来配置项目层面的默认值:
- 左侧选择「项目设置 → 项目」。
- 在「SDK」下拉框中选择刚才添加的版本。
- 「语言级别」建议与 JDK 版本保持一致(如 JDK 17 选 17)。
- 点击「确定」保存。
此时,后续新建的项目将默认使用此 JDK 版本。
二、配置当前项目模块
仅设置全局还不够,当前打开的项目也需要单独指定 SDK,否则可能出现编译不一致的问题。
- 在「项目结构」左侧选择「模块」。
- 选中你的项目模块,切换到「依赖」标签页。
- 在「模块 SDK」下拉框中选择目标 JDK 版本。
对于 Maven 项目,除了 IDE 配置外,还必须同步修改源码中的构建配置,否则会出现版本冲突。
Maven 项目特殊处理
找到根目录下的 pom.xml 文件,修改以下配置项,将版本号改为目标 JDK 版本(示例为 JDK 21):
<properties>
<maven.compiler.source>21</maven.compiler.source>
<maven.compiler.target>21</maven.compiler.target>
</properties>
修改完成后,点击 IDEA 右侧「Maven」面板的「刷新」按钮(或右键项目 → Maven → 重新加载项目),让配置生效。

三、验证 JDK 是否更换成功
配置完成后,可以通过两种方式快速验证。
方法 1:IDEA 界面查看
点击「文件 → 项目结构 → 项目」,查看「项目 SDK」是否为目标版本;同时打开任意 Java 类,确认顶部工具栏显示的 SDK 一致。

