前言

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

一、場景 1：設(shè)置全局默認(rèn) JDK（所有新項(xiàng)目生效）

1. 該方式會(huì)修改 IDEA 的配置，后續(xù)新建的項(xiàng)目都會(huì)默認(rèn)使用這個(gè) JDK 版本。

   步驟 1：打開 IDEA 全局設(shè)置

   • 若未打開任何項(xiàng)目：直接點(diǎn)擊 IDEA 啟動(dòng)界面的「文件 → 新項(xiàng)目設(shè)置 → 新項(xiàng)目的結(jié)構(gòu)」（2020 + 版本）；

   • 若已打開項(xiàng)目：點(diǎn)擊「文件 → 項(xiàng)目結(jié)構(gòu)」。

   步驟 2：配置 SDK

   1. 在彈出的「項(xiàng)目結(jié)構(gòu)」窗口左側(cè)，選擇「平臺(tái)設(shè)置 → SDK」；

   2. 點(diǎn)擊右上角「+」號(hào)，選擇「從磁盤添加JDK...」；

   3. 在文件選擇窗口中，找到你安裝的目標(biāo) JDK 根目錄（比如C:\jdk\jdk21），點(diǎn)擊「確定」；

   4. 此時(shí) IDEA 會(huì)自動(dòng)識(shí)別 JDK 版本，確認(rèn)后點(diǎn)擊「應(yīng)用」。

   5. 注意！，只有右側(cè)「類路徑」識(shí)別到多個(gè)清晰識(shí)別到多個(gè)核心包 / 依賴包，才算添加成功

   

   步驟 3：設(shè)置默認(rèn)項(xiàng)目 SDK

   1. 在「項(xiàng)目結(jié)構(gòu)」左側(cè)選擇「項(xiàng)目設(shè)置 → 項(xiàng)目」；

   2. 在右側(cè)「SDK」選擇剛剛添加的 JDK 版本；

   3. 在「語言級(jí)別」中選擇對(duì)應(yīng)版本（建議與 JDK 版本一致，比如 JDK17 選 17）；

   4. 點(diǎn)擊「確定」保存配置，全局默認(rèn) JDK 設(shè)置完成。

      

   步驟 4：修改模塊 SDK（關(guān)鍵！避免編譯報(bào)錯(cuò)）

   1. 左側(cè)選擇「模塊」，選中你的項(xiàng)目模塊；

   2. 切換到「依賴」標(biāo)簽頁；

   3. 在「模塊 SDK」下拉框中選擇目標(biāo) JDK 版本；

   4. 點(diǎn)擊「應(yīng)用 → 確定」。

      

   步驟5：不同項(xiàng)目類型的額外配置

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

   場景 1：普通 Java 項(xiàng)目

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

   場景 2：Maven 項(xiàng)目（有 pom.xml 文件）

   這種情況必須同步修改 pom.xml（僅改 IDEA 會(huì)導(dǎo)致版本不一致報(bào)錯(cuò)）：

   1. 在 IDEA 左側(cè)項(xiàng)目面板中，找到根目錄下的 pom.xml 文件并雙擊打開；

   2. 插入 / 修改以下配置，將版本號(hào)改為目標(biāo) JDK 版本（示例為 JDK17）：

      1. 漢化版 IDEA 更換 JDK 核心是「添加 SDK → 配置項(xiàng)目 SDK → 配置模塊 SDK」三步，三者缺一不可；

      2. 全局設(shè)置適合所有新項(xiàng)目，單個(gè)項(xiàng)目設(shè)置僅影響當(dāng)前項(xiàng)目，全程無需改動(dòng)其他配置；

   修改中間數(shù)字與目標(biāo)JDK版本一致 版本為JDK21就改為21
    <maven.compiler.source>21</maven.compiler.source> 
    <maven.compiler.target>21</maven.compiler.target> 

   3.修改完成后，點(diǎn)擊 IDEA 右側(cè)「Maven」面板的「刷新」按鈕（或右鍵項(xiàng)目 → Maven → 重新加載項(xiàng)目），讓配置生效。

   

   二、驗(yàn)證 JDK 是否更換成功

   方法 1：通過 IDEA 界面驗(yàn)證

   1. 點(diǎn)擊「文件 → 項(xiàng)目結(jié)構(gòu) → 項(xiàng)目」，查看「項(xiàng)目 SDK」是否為目標(biāo)版本；

   2. 打開項(xiàng)目中的任意 Java 類，點(diǎn)擊頂部「文件 → 項(xiàng)目結(jié)構(gòu) → 模塊」，確認(rèn)模塊 SDK 一致。

   方法 2：通過代碼驗(yàn)證（最直觀）

   在項(xiàng)目中新建測試類，運(yùn)行以下代碼，輸出的版本號(hào)即為當(dāng)前使用的 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("當(dāng)前JDK版本：" + javaVersion);
            System.out.println("當(dāng)前JDK路徑：" + javaHome);
        }
    }

   示例輸出（JDK17）：

    當(dāng)前JDK版本：17.0.9
    當(dāng)前JDK路徑：D:\Java\jdk-17.0.9\jre

   三、常見問題與解決方案

   問題 1：添加 JDK 時(shí)提示「所選目錄不是有效的 JDK 主目錄」

   • 原因：選擇的路徑不是 JDK 根目錄（比如選到了jdk-17.0.9\bin）；

   • 解決方案：重新選擇 JDK 的根目錄（包含bin、lib、jre等文件夾的目錄）。

   問題 2：項(xiàng)目編譯報(bào)錯(cuò)「java: 不支持發(fā)行版本 XX」

   • 原因：項(xiàng)目 SDK、模塊 SDK、語言級(jí)別三者版本不一致；

   • 解決方案：統(tǒng)一三者為目標(biāo) JDK 版本（比如全部改為 17）。

四、總結(jié)

到此這篇關(guān)于漢化版IDEA更換JDK版本的文章就介紹到這了,更多相關(guān)漢化版IDEA更換JDK版本內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評(píng)論