【Eclipse】メモリ使用量を調整してパフォーマンスを向上させる方法｜eclipse.ini設定・GC最適化・トラブル対処まで

注意：macOS の場合は Finder で Eclipse.app を右クリック → 「パッケージの内容を表示」で辿れます。ターミナルから開く場合は open -a TextEdit Eclipse.app/Contents/Eclipse/eclipse.ini を使いましょう。

-Xms と -Xmx のポイント

• -Xms と -Xmx を同じ値にすると、起動時にメモリを一括確保するためGCの発生頻度が下がり安定します
• 値の単位は m（メガバイト）または g（ギガバイト）で指定します
• 物理メモリの 1/4 〜 1/2 を目安に設定するのが一般的です
• 搭載メモリ以上の値を設定するとEclipseが起動しなくなるので注意してください

注意：eclipse.ini を編集する前に、必ずバックアップを取っておきましょう。設定を誤るとEclipseが起動しなくなる可能性があります。

// Eclipse 起動パラメータ
-startup
plugins/org.eclipse.equinox.launcher_1.6.600.v20231106-1826.jar
--launcher.library
plugins/org.eclipse.equinox.launcher.win32.win32.x86_64_1.2.800.v20231003-0937
-product
org.eclipse.epp.package.jee.product
-showsplash
org.eclipse.epp.package.common
--launcher.defaultAction
openFile
--launcher.appendVmargs
-vmargs
-Dosgi.requiredJavaVersion=17
-Dosgi.instance.area.default=@user.home/eclipse-workspace
-Xms256m
-Xmx1024m
--add-modules=ALL-SYSTEM

-startup
plugins/org.eclipse.equinox.launcher_1.6.600.v20231106-1826.jar
--launcher.library
plugins/org.eclipse.equinox.launcher.win32.win32.x86_64_1.2.800.v20231003-0937
-product
org.eclipse.epp.package.jee.product
-showsplash
org.eclipse.epp.package.common
--launcher.defaultAction
openFile
--launcher.appendVmargs
-vmargs
-Dosgi.requiredJavaVersion=17
-Dosgi.instance.area.default=@user.home/eclipse-workspace
// --- メモリ設定 ---
-Xms1024m
-Xmx2048m
// --- GC設定 ---
-XX:+UseG1GC
-XX:+UseStringDeduplication
// --- その他の最適化 ---
-XX:MaxMetaspaceSize=512m
-Xss2m
--add-modules=ALL-SYSTEM

ポイント：-vmargs の行より下にJVMパラメータを記述します。-vmargs より上はEclipse本体のランチャー設定なので、メモリ関連のパラメータを書いても無視されます。

表示例

512M / 2048M

-Xlog:gc*:file=gc.log:time,uptime,level,tags

-verbose:gc
-XX:+PrintGCDetails
-XX:+PrintGCDateStamps
-Xloggc:gc.log

-XX:+UseG1GC
-XX:MaxGCPauseMillis=200
-XX:+UseStringDeduplication
-XX:G1HeapRegionSize=16m

// Metaspace の最大サイズ（クラス情報のメモリ上限）
-XX:MaxMetaspaceSize=512m

// コンパイラスレッド数（CPUコア数に応じて調整）
-XX:CICompilerCount=4

// コード キャッシュの最大サイズ
-XX:ReservedCodeCacheSize=512m

// JIT コンパイルの最適化を有効化
-XX:+TieredCompilation

// クラスデータ共有（起動高速化）
-XX:+UseCompressedOops
-XX:+UseCompressedClassPointers

// スレッドのスタックサイズ
-Xss2m

注意：-XX:MaxPermSize（PermGen領域）は Java 8 以降で廃止されました。Java 8+ では -XX:MaxMetaspaceSize を使用してください。また -XX:+AggressiveOpts は Java 11 以降では非推奨となっているため、使用を避けましょう。

-clean

ポイント：-clean は起動が遅くなるため、毎回付けるのではなく動作が不安定なときだけ一時的に使用してください。改善したら eclipse.ini から削除しましょう。

注意：.metadata フォルダ自体を削除するとワークスペースの設定がすべてリセットされます。.history フォルダのみ削除してください。

エラーメッセージ

java.lang.OutOfMemoryError: Java heap space

エラーメッセージ

java.lang.OutOfMemoryError: Metaspace

ポイント：eclipse.ini では -Xmx と 2048m を改行で分けて書いてはいけません。-Xmx2048m のように1行にまとめて記述してください。

エラーメッセージ

java.lang.StackOverflowError

Eclipse と IntelliJ IDEA の使い分け

• Eclipse：無料で使いたい・軽量に保ちたい・プラグインで自由にカスタマイズしたい場合
• IntelliJ IDEA：メモリに余裕がある・コード補完やリファクタリングの精度を重視する場合
• どちらもJVMベースのため、-Xms / -Xmx によるメモリチューニングの考え方は共通です

-startup
plugins/org.eclipse.equinox.launcher_1.6.600.v20231106-1826.jar
--launcher.library
plugins/org.eclipse.equinox.launcher.win32.win32.x86_64_1.2.800.v20231003-0937
-product
org.eclipse.epp.package.jee.product
-showsplash
org.eclipse.epp.package.common
--launcher.defaultAction
openFile
--launcher.appendVmargs
-vmargs
-Dosgi.requiredJavaVersion=17
-Dosgi.instance.area.default=@user.home/eclipse-workspace
// ===== メモリ設定 =====
-Xms2048m
-Xmx4096m
-Xss2m
// ===== GC 設定 =====
-XX:+UseG1GC
-XX:MaxGCPauseMillis=200
-XX:+UseStringDeduplication
-XX:G1HeapRegionSize=16m
// ===== その他最適化 =====
-XX:MaxMetaspaceSize=512m
-XX:ReservedCodeCacheSize=512m
-XX:+TieredCompilation
-XX:+UseCompressedOops
-XX:+UseCompressedClassPointers
--add-modules=ALL-SYSTEM