Eclipse 執行 ANT 出現 OutOfMemoryError 解決方案：調整 JVM 記憶體參數

問題現象

在 Eclipse 中執行 Ant 建置專案時，控制台噴出 java.lang.OutOfMemoryError，導致建置中斷。原因是 Ant 預設分配給 JVM 的堆疊記憶體不足，無法應付大型專案的編譯、打包需求。

解決方法：在 Eclipse 中設定預設 VM 參數

1. 開啟 Window → Preferences
2. 展開 Java → Installed JREs
3. 選中目前專案使用的 JDK/JRE，點擊 Edit...
4. 在 Default VM Arguments 欄位輸入：-Xmx1024m（或更大，視實體記憶體而定）
5. 點擊 Finish → Apply and Close

參數說明

• -Xms：初始堆疊大小
• -Xmx：最大堆疊大小（建議設為實體記憶體 50%~75%）
• 範例：-Xms512m -Xmx1024m

補充：命令列執行 Ant 時的設定

若在終端機直接執行 ant，可修改 ANT_OPTS 環境變數：

# Linux / macOS
export ANT_OPTS="-Xms512m -Xmx1024m"

# Windows (cmd)
set ANT_OPTS=-Xms512m -Xmx1024m

# Windows (PowerShell)
$env:ANT_OPTS="-Xms512m -Xmx1024m"

常見誤區

• ❌ 修改 eclipse.ini 的 -Xmx 只會影響 Eclipse 本身，不會影響 Ant 子程序。
• ✅ 必須在 Installed JREs 的 VM Arguments 設定，因為 Ant 是在獨立 JVM 執行。

總結

透過調整 Eclipse 內建 JRE 的預設 VM 參數，即可徹底解決 Ant 建置時的記憶體不足問題，無需修改專案建置腳本或環境變數。