汉化版IDEA 更换 JDK 版本全教程，超详细！
汉化版IDEA 更换 JDK 版本全教程，超详细！
在 Java 开发中，我们经常需要根据项目需求切换不同的 JDK 版本（比如从 JDK8 升级到 JDK17，或降级到 JDK11）。对于使用汉化版 IntelliJ IDEA的小伙伴，本文全程采用中文菜单 / 选项描述，不改动任何非必要配置，手把手教你完成 JDK 切换，全程避坑！
一、场景 1：设置全局默认 JDK（所有新项目生效）
- 若未打开任何项目：直接点击 IDEA 启动界面的「文件 → 新项目设置 → 新项目的结构」（2020 + 版本）；
- 若已打开项目：点击「文件 → 项目结构」。
- 在弹出的「项目结构」窗口左侧，选择「平台设置 → SDK」；
- 点击右上角「+」号，选择「从磁盘添加JDK...」；
- 在文件选择窗口中，找到你安装的目标 JDK 根目录（比如
C:\jdk\jdk21），点击「确定」； - 此时 IDEA 会自动识别 JDK 版本，确认后点击「应用」。
- 注意！，只有右侧「类路径」识别到多个清晰识别到多个核心包 / 依赖包，才算添加成功
- 在「项目结构」左侧选择「项目设置 → 项目」；
- 在右侧「SDK」选择刚刚添加的 JDK 版本；
- 在「语言级别」中选择对应版本（建议与 JDK 版本一致，比如 JDK17 选 17）；
- 点击「确定」保存配置，全局默认 JDK 设置完成。
- 左侧选择「模块」，选中你的项目模块；
- 切换到「依赖」标签页；
- 在「模块 SDK」下拉框中选择目标 JDK 版本；
- 在 IDEA 左侧项目面板中，找到根目录下的
pom.xml文件并双击打开； - 插入 / 修改以下配置，将版本号改为目标 JDK 版本（示例为 JDK17）：
- 点击「文件 → 项目结构 → 项目」，查看「项目 SDK」是否为目标版本；
- 打开项目中的任意 Java 类，点击顶部「文件 → 项目结构 → 模块」，确认模块 SDK 一致。
- 原因：选择的路径不是 JDK 根目录（比如选到了
jdk-17.0.9\bin）； - 解决方案：重新选择 JDK 的根目录（包含
bin、lib、jre等文件夹的目录）。 - 原因：项目 SDK、模块 SDK、语言级别三者版本不一致；
- 解决方案：统一三者为目标 JDK 版本（比如全部改为 17）。
- 汉化版 IDEA 更换 JDK 核心是「添加 SDK → 配置项目 SDK → 配置模块 SDK」三步，三者缺一不可；
- 全局设置适合所有新项目，单个项目设置仅影响当前项目，全程无需改动其他配置；
点击「应用 → 确定」。
该方式会修改 IDEA 的配置，后续新建的项目都会默认使用这个 JDK 版本。
步骤 1：打开 IDEA 全局设置
步骤 2：配置 SDK
步骤 3：设置默认项目 SDK
步骤 4：修改模块 SDK（关键！避免编译报错）
步骤5：不同项目类型的额外配置
更换 JDK 后是否需要修改配置文件，核心取决于你的项目类型，不同类型处理方式完全不同：场景 1：普通 Java 项目无需修改任何配置文件—— 仅需完成上述 IDEA 的 SDK 配置即可，JDK 版本会直接生效，编译、运行均以 IDEA 配置的版本为准。场景 2：Maven 项目（有 pom.xml 文件）这种情况必须同步修改 pom.xml（仅改 IDEA 会导致版本不一致报错）：xml 修改中间数字与目标JDK版本一致 版本为JDK21就改为21 <maven.compiler.source>21</maven.compiler.source> <maven.compiler.target>21</maven.compiler.target> 3.修改完成后，点击 IDEA 右侧「Maven」面板的「刷新」按钮（或右键项目 → Maven → 重新加载项目），让配置生效。
二、验证 JDK 是否更换成功
方法 1：通过 IDEA 界面验证
方法 2：通过代码验证（最直观）
在项目中新建测试类，运行以下代码，输出的版本号即为当前使用的 JDK 版本： public class JdkVersionTest { public static void main(String[] args) { // 获取JDK版本 String javaVersion = System.getProperty("java.version"); // 获取JDK安装路径 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 主目录」
问题 2：项目编译报错「java: 不支持发行版本 XX」
四、总结
