解決「Perhaps JAVA_HOME does not point to the JDK」Eclipse 編譯錯誤

在 Eclipse 中使用 Ant 構建項目時，常遇到 Perhaps JAVA_HOME does not point to the JDK 錯誤。本文針對綠色版（免安裝）Eclipse/JDK 環境，提供三種遞進式解決方案，幫助快速定位並修復 JDK 路徑配置問題。

錯誤現象

BUILD FAILED
... Perhaps JAVA_HOME does not point to the JDK.
It is currently set to "C:\Program Files\Java\jre1.8.0_xxx"

核心原因：Ant 的 javac 任務需要 JDK 的 tools.jar，但 JAVA_HOME 指向了 JRE 而非 JDK。

方案一：Eclipse 外部工具配置指向 JDK（推薦，不改系統環境）

1. 菜單 Run → External Tools → External Tools Configurations...
2. 左側選中你的 Ant Build 配置，右側切換 JRE 頁籤。
3. Runtime JRE 選擇 Separate JRE，點擊 Installed JREs... 按鈕。
4. 在彈出窗口點擊 Add... → Standard VM → Next。
5. JRE home directory 選擇 JDK 安裝目錄（如 D:\Java\jdk1.8.0_202），非 JRE 目錄。
6. 完成後，回到 JRE 頁籤，在 Separate JRE 下拉框選中剛添加的 JDK。
7. 點擊 Apply 應用，重新運行 Ant 構建。

優點：僅影響當前構建配置，不污染系統環境變量，適合多 JDK 共存環境。

方案二：複製 tools.jar 到 JRE lib 目錄（快速臨時修復）

# 假設 JDK 安裝在 D:\Java\jdk1.8.0_202
# JRE 安裝在 D:\Java\jre1.8.0_202
copy D:\Java\jdk1.8.0_202\lib\tools.jar D:\Java\jre1.8.0_202\lib\

然後在 Eclipse Window → Preferences → Java → Installed JREs 中確保勾選的 JRE 路徑正確（指向包含 tools.jar 的那個 lib 目錄）。

缺點：JRE 升級後需重複操作，非標準做法，僅作應急。

方案三：系統環境變量配置 JAVA_HOME 指向 JDK（標準做法）

1. 右鍵「此電腦」→ 屬性 → 高級系統設置 → 環境變量。
2. 系統變量 → 新建：
   • 變量名：JAVA_HOME
   • 變量值：D:\Java\jdk1.8.0_202（JDK 根目錄，含 bin、lib、include）
3. 編輯 Path 變量，在最前面添加 %JAVA_HOME%\bin。
4. 新建/編輯 CLASSPATH：.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar。
5. 重啟 Eclipse（必須重啟才能讀取新環境變量）。

@echo off
set JAVA_HOME=D:\Java\jdk1.8.0_202
set PATH=%JAVA_HOME%\bin;%PATH%
start "" "eclipse.exe" -vm %JAVA_HOME%\bin\javaw.exe