Eclipse 啟動報錯「找不到 JRE/JDK」？環境變數配置全攻略

雙擊 eclipse.exe 彈出錯誤對話框：「A Java Runtime Environment (JRE) or Java Development Kit (JDK) must be available...」。這是經典的環境變數未正確指向 JDK問題，本文提供 Windows/macOS/Linux 三平台完整配置步驟。

根本原因

Eclipse 啟動器（eclipse.exe）會按順序尋找 JVM：

1. eclipse.ini 中 -vm 指定的路徑
2. 系統 PATH 環境變數中的 javaw.exe
3. Windows Registry HKEY_LOCAL_MACHINE\SOFTWARE\JavaSoft\Java Runtime Environment

若以上皆無，則報錯。

方案一：修改 eclipse.ini（最穩健、推薦）

在 eclipse.ini 第一行 插入：

-vm
C:/Program Files/Java/jdk-17/bin/javaw.exe

• 路徑指向 javaw.exe（非 java.exe），避免控制台窗口閃爍。
• 使用正斜線 / 或雙反斜線 \\。
• -vm 參數必須單獨佔一行，緊接著路徑佔下一行。

方案二：配置系統環境變數（通用但易衝突）

Windows

1. 安裝 JDK（如 C:\Program Files\Java\jdk-17）
2. 新增系統變數 JAVA_HOME = C:\Program Files\Java\jdk-17
3. 編輯 Path，新增 %JAVA_HOME%\bin
4. 驗證：cmd 執行 java -version 顯示正確版本

macOS / Linux

# ~/.zshrc 或 ~/.bashrc
export JAVA_HOME=$(/usr/libexec/java_home -v 17)
export PATH=$JAVA_HOME/bin:$PATH

方案三：使用 JDK 內建的 jpackage / 安裝包自帶 JRE（Eclipse 2024-09+）

新版 Eclipse Installer 可選擇 Bundle JRE，安裝後無需任何環境變數即可運行，適合不想汙染系統環境的用戶。

常見誤區

驗證 Eclipse 是否用對 JDK

• Help → About Eclipse → Installation Details → Configuration
• 搜尋 -vm 或 java.home，確認路徑符合預期

總結

Eclipse 找不到 JDK 99% 是環境變數或 eclipse.ini 配置問題。最省心的方式：在 eclipse.ini 首行加上 -vm 絕對路徑，一勞永逸，不受系統 Path 變更影響。