漢化版IDEA更換JDK版本完全教程(超詳細！)

更新時間：2026年04月01日 08:41:45 作者：燭之武

更換JDK版本是Java開發(fā)者在日常開發(fā)、項目遷移、兼容性適配、安全升級或構(gòu)建環(huán)境統(tǒng)一過程中極為常見且關(guān)鍵的操作,這篇文章主要介紹了漢化版IDEA更換JDK版本的相關(guān)資料,需要的朋友可以參考下

前言

在 Java 開發(fā)中，我們經(jīng)常需要根據(jù)項目需求切換不同的 JDK 版本（比如從 JDK8 升級到 JDK17，或降級到 JDK11）。對于使用漢化版 IntelliJ IDEA的小伙伴，本文全程采用中文菜單 / 選項描述，不改動任何非必要配置，手把手教你完成 JDK 切換，全程避坑！

一、場景 1：設置全局默認 JDK（所有新項目生效）

該方式會修改 IDEA 的配置，后續(xù)新建的項目都會默認使用這個 JDK 版本。

步驟 1：打開 IDEA 全局設置
- 若未打開任何項目：直接點擊 IDEA 啟動界面的「文件 → 新項目設置 → 新項目的結(jié)構(gòu)」（2020 + 版本）；
- 若已打開項目：點擊「文件 → 項目結(jié)構(gòu)」。
步驟 2：配置 SDK
1. 在彈出的「項目結(jié)構(gòu)」窗口左側(cè)，選擇「平臺設置 → SDK」；
2. 點擊右上角「+」號，選擇「從磁盤添加JDK...」；
3. 在文件選擇窗口中，找到你安裝的目標 JDK 根目錄（比如C:\jdk\jdk21），點擊「確定」；
4. 此時 IDEA 會自動識別 JDK 版本，確認后點擊「應用」。
5. 注意！，只有右側(cè)「類路徑」識別到多個清晰識別到多個核心包 / 依賴包，才算添加成功
步驟 3：設置默認項目 SDK
1. 在「項目結(jié)構(gòu)」左側(cè)選擇「項目設置 → 項目」；
2. 在右側(cè)「SDK」選擇剛剛添加的 JDK 版本；
3. 在「語言級別」中選擇對應版本（建議與 JDK 版本一致，比如 JDK17 選 17）；
4. 點擊「確定」保存配置，全局默認 JDK 設置完成。
步驟 4：修改模塊 SDK（關(guān)鍵！避免編譯報錯）
1. 左側(cè)選擇「模塊」，選中你的項目模塊；
2. 切換到「依賴」標簽頁；
3. 在「模塊 SDK」下拉框中選擇目標 JDK 版本；
4. 點擊「應用 → 確定」。
步驟5：不同項目類型的額外配置

更換 JDK 后是否需要修改配置文件，核心取決于你的項目類型，不同類型處理方式完全不同：

場景 1：普通 Java 項目

無需修改任何配置文件—— 僅需完成上述 IDEA 的 SDK 配置即可，JDK 版本會直接生效，編譯、運行均以 IDEA 配置的版本為準。

場景 2：Maven 項目（有 pom.xml 文件）

這種情況必須同步修改 pom.xml（僅改 IDEA 會導致版本不一致報錯）：
1. 在 IDEA 左側(cè)項目面板中，找到根目錄下的 pom.xml 文件并雙擊打開；
2. 插入 / 修改以下配置，將版本號改為目標 JDK 版本（示例為 JDK17）：
  1. 漢化版 IDEA 更換 JDK 核心是「添加 SDK → 配置項目 SDK → 配置模塊 SDK」三步，三者缺一不可；
  2. 全局設置適合所有新項目，單個項目設置僅影響當前項目，全程無需改動其他配置；
```
修改中間數(shù)字與目標JDK版本一致 版本為JDK21就改為21
 <maven.compiler.source>21</maven.compiler.source> 
 <maven.compiler.target>21</maven.compiler.target> 
```
3.修改完成后，點擊 IDEA 右側(cè)「Maven」面板的「刷新」按鈕（或右鍵項目 → Maven → 重新加載項目），讓配置生效。

二、驗證 JDK 是否更換成功

方法 1：通過 IDEA 界面驗證
1. 點擊「文件 → 項目結(jié)構(gòu) → 項目」，查看「項目 SDK」是否為目標版本；
2. 打開項目中的任意 Java 類，點擊頂部「文件 → 項目結(jié)構(gòu) → 模塊」，確認模塊 SDK 一致。
方法 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 主目錄」
- 原因：選擇的路徑不是 JDK 根目錄（比如選到了jdk-17.0.9\bin）；
- 解決方案：重新選擇 JDK 的根目錄（包含bin、lib、jre等文件夾的目錄）。
問題 2：項目編譯報錯「java: 不支持發(fā)行版本 XX」
- 原因：項目 SDK、模塊 SDK、語言級別三者版本不一致；
- 解決方案：統(tǒng)一三者為目標 JDK 版本（比如全部改為 17）。