IntelliJ IDEA 切换 JDK 版本完整教程
在 Java 开发中，经常需要根据项目需求切换不同的 JDK 版本。本文介绍如何在 IntelliJ IDEA 中完成 JDK 版本的切换与配置。
一、设置全局默认 JDK
若未打开项目，启动界面点击「文件 → 新项目设置 → 新项目的结构」；若已打开项目，点击「文件 → 项目结构」。
- 在左侧选择「平台设置 → SDK」。
- 点击右上角「+」号，选择「从磁盘添加 JDK...」。
- 找到目标 JDK 根目录（如
C:\jdk\jdk21），点击「确定」。 - 确认 IDEA 自动识别的版本，点击「应用」。
随后在「项目设置 → 项目」中：
- 右侧「SDK」选择刚添加的版本。
- 「语言级别」选择对应版本（建议与 JDK 一致）。
- 点击「确定」保存。
最后检查模块配置：
- 左侧选择「模块」，选中项目模块。
- 切换到「依赖」标签页。
- 在「模块 SDK」下拉框中选择目标 JDK 版本。
该方式会修改 IDEA 的配置，后续新建的项目都会默认使用这个 JDK 版本。
二、Maven 项目额外配置
如果项目包含 pom.xml，需同步修改编译器配置：
<maven.compiler.source>21</maven.compiler.source>
<maven.compiler.target>21</maven.compiler.target>
修改完成后，点击 IDEA 右侧「Maven」面板的「刷新」按钮，让配置生效。
三、验证 JDK 是否更换成功
方法 1：通过 IDEA 界面验证
查看「项目结构」中的「项目 SDK」及模块 SDK 是否一致。
方法 2：通过代码验证
新建测试类运行以下代码：
public class JdkVersionTest {
public static void main(String[] args) {
String javaVersion = System.getProperty("java.version");
String javaHome = System.getProperty("java.home");
System.out.println("当前 JDK 版本：" + javaVersion);
System.out.println("当前 JDK 路径：" + javaHome);
}
}
示例输出（JDK17）：
当前 JDK 版本：17.0.9
当前 JDK 路径：D:\Java\jdk-17.0.9\jre
四、常见问题与解决方案
问题 1：添加 JDK 时提示「所选目录不是有效的 JDK 主目录」
原因：选择的路径不是 JDK 根目录（例如选到了 jdk-17.0.9\bin）。
解决：重新选择 JDK 的根目录（包含 bin、lib、jre 等文件夹的目录）。
问题 2：项目编译报错「java: 不支持发行版本 XX」
原因：项目 SDK、模块 SDK、语言级别三者版本不一致。 解决：统一三者为目标 JDK 版本。
