macOSでEclipseを2025-06（Pleiades All in One）に上げたら以前より明らかにフリーズが増えた……という経験はないでしょうか。
筆者も同じ状況に陥りまして。しかもLombokを使っているクラスでインポート整理を実行すると必要なimportが消えるという謎の現象まで重なり、アップデートしたのに逆に作業効率が落ちるというなかなかしんどい状態になりました。
この記事ではmacOS環境でEclipse 2025-06が不安定になる原因と実際に試せる対処法を順番に解説します。
Eclipse関連の設定・トラブル対処をまとめて確認したい方はこちら
この記事でわかること
- macOS＋Eclipse 2025-06で起きやすい不具合の種類
- フリーズ・Lombokエラー・検索不具合の原因
- 設定変更から再インストールまで段階的な対処法
- それでも解決しない場合のダウングレード方法
結論｜macOS＋Eclipse 2025-06で不安定になる原因と対処法
よくある症状（フリーズ・Lombokエラー・検索不具合）
macOS＋Eclipse 2025-06でよく報告されている症状はこちらです。
- Eclipseがハングアップし強制終了するしか手がなくなる（未保存の作業内容がすべて失われる）
- Lombokを使っているクラスでインポート整理（Organize Imports）を実行すると必要なimport文が消える
- 「呼び出し階層（Call Hierarchy）」の検索結果が正しく表示されない
- コード補完（Content Assist）の動作が遅くなったり候補が出なくなる
これらは個別の問題に見えて実は「Eclipseのインデックス破損」「LombokとEclipseの互換性」「macOSのJava環境」という3つの原因に集約されることが多いです。
まず試すべき対処法
効果の高い順にまとめます。
- Auto Saveを有効にする — 完全フリーズで作業内容が消えるリスクを減らします。
- Lombokを最新版に更新する — Lombok自体のバグや互換性の問題を解消します。
- ワークスペースのインデックスを再構築する — Eclipseのインデックス破損の場合の対処です。
- eclipse.ini のメモリ設定を見直す — 後述しますがEclipseの起動パラメーター
-Xmxを調整します。 - JDKを安定版（Java 21 LTS）に変更する
- 別バージョンのEclipseに変更する
macOSでEclipse 2025-06が不安定になる主な症状
Eclipseが頻繁にフリーズする
今回のEclipseのフリーズには3つのパターンがあります。
- パターンA：しばらく待てば回復するフリーズ
バックグラウンドジョブ（インデックス更新やビルド処理）が重なったときに数秒〜数十秒操作不能になるケースです。虹色カーソル（macOSのビーチボール）が出て待てば戻ってきます。 - パターンB：強制終了しか手がない完全フリーズ
操作を受け付けなくなったままいくら待っても回復しないケースです。強制終了するしかなく未保存の作業内容はすべて失われます。Eclipse 2025-06＋macOSの組み合わせで特に報告が多いようです。発生タイミングが「保存時」「ファイルを開いたとき」のような決まったきっかけがないのが厄介なところです。 - パターンC：カーソルは動くが文字入力・保存ができない（部分フリーズ）
カーソルは動くのにキーボードを押しても無反応になるパターンです。Cmd＋Sを押しても保存されず文字も入力できません。これはEclipseのUIツールキット（SWT）がmacOSとの間でキーボードイベントを正常に受け渡せなくなる「フォーカスロスト」という現象で、プロセス全体がハングしているわけではありません。Eclipseウィンドウの外をクリックしてから再度Eclipseをクリックすると、キー入力が復活することがあります（しないこともあります……）。根本的にはSWTとmacOSのイベント処理の相性問題で、Eclipse 2025-06とmacOSの組み合わせで発生しやすいことがGitHub上でも複数報告されています。
パターンB・Cともに、Javaプロセス側でメモリ不足やGCの停止が起きているか、macOSのファイルシステムとのI/O処理が詰まっている可能性が高いです。後述するeclipse.iniのメモリ設定見直しとJDK変更が効果的ですが、パターンCはAuto Saveとの組み合わせで被害を最小限に抑えることも重要です。
Lombok使用クラスでインポート整理が壊れる
LombokはEclipseのコンパイラAPIに深く依存しているため、Eclipseのバージョンが上がるとすぐ影響を受けます。
典型的な症状は「@RequiredArgsConstructorなどのアノテーションを付けたクラスでインポート整理を実行すると必要なimport文が削除される」というものです。コンパイルエラーが増えてしまい地味に開発の邪魔になりますよね。
メソッドの呼び出し階層が正しく検索されない
「呼び出し階層を開く」でメソッドの呼び出し元を調べても実際と異なる呼び出し元が表示される場合があります。Eclipseのインデックスが壊れているサインであることが多いです。
コード補完やインデックスの挙動が不安定
コード補完の候補が出るまで時間がかかったり、型が認識されずに補完が壊れたりするケースも報告されています。いずれもインデックス破損が絡んでいることが多いです。
原因① macOS＋Eclipse 2025-06の相性問題
Eclipse 2025-06で変更された内部仕様
Eclipse 2025-06（4.35）ではJDT（Javaデベロッパーツール）の内部処理とバックグラウンドジョブの管理方法が一部変更されました。この変更がmacOSのスレッド管理やファイルシステムとの相性に影響していると考えられています。
macOSのJava環境（JDKバージョン）との相性
macOSでEclipseを動かす際、システムにインストールされているJDKのバージョンとEclipseが要求するバージョンがずれていると不安定になることがあります。
Eclipse 2025-06はJava 21以上を推奨していますが、開発プロジェクトの都合でJava 17や11を使っている場合、設定の食い違いがフリーズや誤動作を引き起こすことがあります。
Eclipse以外でもMac全体が重い場合はこちら。
Apple Silicon / Intel Macで起こる違い
Apple Silicon（M1、M2…）のMacでARM版JDKとx86版JDKを混在させている場合、Rosettaを経由した処理で予期しない遅延が発生することがあります。
一方Intel Macでは主にメモリ不足やGC（ガベージコレクション）の停止が原因になりやすいです。自分のMacがどちらかを確認した上で対処法を選ぶとより効果的です。
原因② LombokとEclipseの互換性問題
LombokがEclipse内部APIに依存している理由
Lombokはコンパイル時にソースコードを変換するため、EclipseのJDT（内部コンパイラAPI）に直接フックして動作します。
このためEclipseのマイナーバージョンが上がっただけでも内部APIが変わり、Lombokが正常に動作しなくなることがあります。これはLombok固有の問題で、仕組み上避けられない宿命のようなものです。
Eclipseアップデート直後に起きやすい不具合
Eclipseを新しいバージョンへアップデートした直後に、古いバージョン向けのLombokがそのまま残っていると互換性の問題が発生します。
「アップデートしたら急にエラーが増えた」という場合はまずLombokのバージョンを疑ってみましょう。
Lombokのバージョン確認方法
現在使用しているLombokはeclipse.iniで確認できます。デフォルトだと下記のような形だと思います。
cat /Applications/Eclipse_2025-06.app/Contents/Eclipse/eclipse.ini | grep lombok-javaagent:lombok.jarこの場合Eclipseの実行ファイルと同じ場所（Contents/MacOS内）にあります。インストールされているLombokのバージョンは以下のコマンドで確認できます。
java -jar /Applications/Eclipse_2025-06.app/Contents/MacOS/lombok.jar --versionLombok v1.18.38 "Envious Ferret"原因③ Eclipseのインデックス破損
インデックスが壊れると何が起こるのか
Eclipseはプロジェクト内のクラス・メソッド・変数などの情報をワークスペース内のインデックスファイル（.metadata配下）に保存しています。
このインデックスが何らかの原因で破損すると「コード補完・検索・呼び出し階層を開く」などの機能が正常に動かなくなります。
Mac側のインデックス処理も見直したい場合はこちらをどうぞ。
呼び出し階層や検索が壊れる理由
インデックスが古いまま、または壊れた状態だとEclipseはクラスの依存関係を正しく把握できません。その結果、呼び出し元・呼び出し先の検索結果が空になったり、削除済みのクラスが検索結果に残り続けるといった現象が起きます。
Eclipse 2025-06のまま使う場合の対処法
Eclipse 2025-06は不安定な要素が多いので別バージョンに変更するほうが望ましいですが、このまま使い続ける場合は以下を順番に試してみてください。
Step 1. Auto Saveを有効にして作業ロスを防ぐ
完全フリーズは根本解決が難しいケースもあるため、強制終了時の被害を最小限にすることも重要な対策です。EclipseにはAuto Save（自動保存）機能があるので一定間隔でファイルを自動保存できます。
設定はEclipse > 設定 > 一般 > エディター > 自動保存から有効化します。
- 編集中のエディターの自動保存を使用可能にするにチェックを入れる。
- 自動保存間隔を調整します。60秒程度がいいかもしれません（デフォルトは20秒です）。
⚠️ 注意 自動保存はあくまで「被害を減らす」ための設定です。フリーズ自体を解消するものではないため、後述のメモリ設定やJDK変更と合わせて対処することをおすすめします。
Step 2. eclipse.ini のメモリ設定を見直す
Eclipseに割り当てるメモリが少ないと大きなプロジェクトでGC（ガベージコレクション）が頻発してフリーズの原因になるようです。
eclipse.iniを開き以下の値を調整（記載がなければ追加）します。
-Xms512m
-Xmx4096mファイルの場所はこちらです。
vim /Applications/Eclipse_2025-06.app/Contents/Eclipse/eclipse.ini-Xmx（最大ヒープサイズ）は搭載メモリの4分の1〜半分程度を目安に設定してください。16GBのMacであれば4096m（4GB）が現実的な値です。
⚠️ 注意
eclipse.iniを直接編集するため、誤った記述をするとEclipseが起動しなくなることがあります。編集前に元のファイルをバックアップしておいてください。
Step 3. JDKバージョンを安定版（Java 21 LTS）に変更する
Eclipse 2025-06に推奨されるJDKはJava 21 LTSです。
macOSで複数のJDKが混在している場合はjava_homeコマンドでバージョンを確認できます。
/usr/libexec/java_home -VMatching Java Virtual Machines (2):
18.0.2.1 (arm64) "Eclipse Adoptium" - "OpenJDK 18.0.2.1" /Users/【ユーザー名】/Library/Java/JavaVirtualMachines/temurin-18.0.2.1/Contents/Home
1.8.0_312 (x86_64) "Eclipse Temurin" - "Eclipse Temurin 8" /Users/【ユーザー名】/Library/Java/JavaVirtualMachines/temurin-8.jdk/Contents/Home筆者のマシンにはJDK 21がなかったのでインストールしてみることにします。Eclipse Temurin（旧AdoptOpenJDK）からダウンロードしてインストールしました。
Matching Java Virtual Machines (4):
21.0.10 (arm64) "Eclipse Adoptium" - "OpenJDK 21.0.10" /Library/Java/JavaVirtualMachines/temurin-21.jdk/Contents/Home
18.0.2.1 (arm64) "Eclipse Adoptium" - "OpenJDK 18.0.2.1" /Users/【ユーザー名】/Library/Java/JavaVirtualMachines/temurin-18.0.2.1/Contents/Home
1.8.0_312 (x86_64) "Eclipse Temurin" - "Eclipse Temurin 8" /Users/【ユーザー名】/Library/Java/JavaVirtualMachines/temurin-8.jdk/Contents/Home21.0.10 (arm64)がインストールできました。x86_64がインストールされてしまった場合はRosetta経由の実行になるのでパフォーマンス面で不利になります。Apple SiliconのMacを使っている場合はarm64版になっているか確認してみてください。
インストーラーでインストールした場合はデフォルトで使用するJavaのバージョンも書き換えてくれていました。
/usr/libexec/java_home/Library/Java/JavaVirtualMachines/temurin-21.jdk/Contents/HomeStep 4. ワークスペースのインデックスを再構築する
インデックスの再構築は以下の手順で実行できます。
- ワークスペースのリフレッシュ
プロジェクトエクスプローラーで全プロジェクトを選択し右クリック > リフレッシュを実行します。 - プロジェクトのクリーン
メニュー > プロジェクト > クリーンを選択しすべてのプロジェクトをクリーンを選んでOKをクリックします。
Step 5. Lombokの最新版を適用する
Lombokの公式サイトから最新版のlombok.jarをダウンロードし既存のものに上書きします。
⚠️ 注意 Lombokの再インストール後は必ずEclipseを完全に終了してから再起動してください。再起動しないと変更が反映されません。
別バージョンのEclipseに変更する
過去バージョンだとEclipse 2024-12や2024-09はmacOSとの相性が比較的安定していると報告されています。筆者の場合は2025-12に変えてみて特に問題なく使用できています。
インストールしなおせる状況であれば別バージョンを使うことをおすすめします。
Eclipseを再インストールしてクリーンな環境が整ったら開発環境のSSL対応も一緒に見直してみるのがおすすめです。
Q&A
まとめ｜macOS＋Eclipse 2025-06の不具合は環境要因が多い
- macOS＋Eclipse 2025-06のフリーズや誤動作は「インデックス破損」「Lombok非互換」「JDK設定のミスマッチ」が主な原因だよ。
- 完全フリーズは待っても回復しないのでまず自動保存を有効にして作業ロスを減らしてね。
- Lombokを最新版に更新しクリーンビルドを実行してみるのが手だよ。
- Eclipseのメモリ使用量（
-Xmx）を増やすことでフリーズが軽減されることもあるよ。 - Apple SiliconのMacはARM64ネイティブのJDKを使うと安定しやすいよ。
- それでも解決しない場合はEclipse 2024系へのダウングレードも有効な選択肢だよ。
- メジャーリリース直後（特に.06リリース）は不具合が出やすい傾向があるよ。安定性を優先するなら数ヶ月待つのも手だよ。
- eclipse.iniのメモリ設定はデフォルトのままだと低めになっていることがあるから一度確認してみる価値があるよ。
- ワークスペースは定期的にバックアップを取っておくといざというときに安心だよ。