IntelliJ IDEA 默認內存設置修改指南

問題現象

Maven 編譯大項目時提示「系統資源不足」（OOM），但系統內存尚有餘量。原因：**IDE 默認最大堆內存（-Xmx）過小**，無法支撐大型項目索引、編譯、構建。

修改步驟

macOS

1. Finder 定位 /Applications/IntelliJ IDEA 13.app（版本號按實際調整）
2. 右鍵 → 顯示包內容
3. 進入 Contents/bin/ 目錄
4. 編輯 idea.vmoptions（若無則複製 idea.vmoptions.example 重命名）
5. 修改 -Xmx750m → 推薦 -Xmx2048m 或更高（視物理內存）
6. 保存，重啟 IDEA 生效

Windows / Linux

1. 安裝目錄下 bin/idea64.exe.vmoptions（64位）或 idea.exe.vmoptions（32位）
2. 同樣修改 -Xmx 值
3. 建議：-Xms1024m -Xmx2048m -XX:ReservedCodeCacheSize=512m

推薦配置模板（16GB+ 內存機器）

-Xms1024m
-Xmx3072m
-XX:ReservedCodeCacheSize=1024m
-XX:+UseG1GC
-XX:SoftRefLRUPolicyMSPerMB=50
-Dfile.encoding=UTF-8
-Dsun.io.useCanonCaches=false

驗證生效

• Help → Diagnostic Tools → Memory Indicator（右下角顯示已用/最大堆）
• 或 jps -v 查看進程啟動參數

注意事項

• 修改 .app/Contents/bin/ 下文件屬於**全局修改**，影響所有項目
• 項目級調優：Settings → Build, Execution, Deployment → Compiler → Shared build process VM options
• 不要盲目設極大 -Xmx，留 2-4GB 給 OS/文件緩存/其他進程
• IDEA 2020.1+ 支持 .vmoptions 用戶目錄覆蓋（~/Library/Application Support/JetBrains/IntelliJIdea202X/），優先級更高，升級不丟失

總結

調大 -Xmx 是解決 IDEA 卡頓、編譯 OOM、索引失敗的「銀彈」。根據物理內存科學配置，配合 G1GC、CodeCache 調優，讓 IDEA 流暢支撐百萬行級大項目。