macOSでEclipse 2025-06が固まるときの対処法・Lombokのimportが消える場合も

このサイトはアフィリエイト広告(Amazonアソシエイト含む)を掲載しています。
MacでEclipse 2025-06が応答せず、虹色のカーソルが表示されているイメージ

macOSでEclipseを2025-06(Pleiades All in One)に上げたら以前より明らかにフリーズが増えた……という経験はないでしょうか。

筆者も同じ状況に陥りまして。しかもLombokを使っているクラスでインポート整理を実行すると必要なimportが消えるという謎の現象まで重なり、アップデートしたのに逆に作業効率が落ちるというなかなかしんどい状態になりました。

この記事ではmacOS環境でEclipse 2025-06が不安定になる原因と実際に試せる対処法を順番に解説します。

Eclipse 2025-06はEclipse 4.36にあたり、本体を動かすにはJava 21以上が必要です。まずEclipseの実行JDK、Lombokのバージョン、ワークスペースの状態を確認してください。


Eclipse関連の設定・トラブル対処をまとめて確認したい方はこちら。

目次

症状別診断表

症状最初に確認すること次に試すこと
Eclipse全体が応答しないEclipseの実行JDK、メモリ、ログeclipse.iniの確認、別ワークスペース
キー入力や選択だけ効かないmacOSのショートカット競合Eclipse・macOSの更新、別バージョン
Lombokのimportが消えるLombokのバージョンLombok再設定、Clean、再起動
呼び出し階層や補完がおかしいプロジェクトのビルド状態Refresh、Clean、新規ワークスペース
Mac全体が重いCPU・メモリ・SpotlightMac側の高負荷プロセスを切り分ける

結論|macOS+Eclipse 2025-06で不安定になる原因と対処法

よくある症状(フリーズ・Lombokエラー・検索不具合)

macOS+Eclipse 2025-06でよく報告されている症状はこちらです。

  • Eclipseがハングアップし強制終了するしか手がなくなる(未保存の作業内容がすべて失われる)
  • Lombokを使っているクラスでインポート整理(Organize Imports)を実行すると必要なimport文が消える
  • 「呼び出し階層(Call Hierarchy)」の検索結果が正しく表示されない
  • コード補完(Content Assist)の動作が遅くなったり候補が出なくなる

これらの症状はすべて同じ要因とは限りません。Eclipse本体、Eclipseを起動しているJDK、Lombokなどのプラグイン、ワークスペース、macOS側の入力処理を順番に確認します。

まず試すべき対処法

Eclipseが応答しない場合はまず通常の終了を試します。終了操作も受け付けないときはoption + command + escを押し、Eclipseを選んで強制終了してください。保存していない変更は失われることがあります。

再起動後は症状に合わせて確認する場所を選びます。

  • 全体が重い・応答しない場合はEclipseの実行JDKとメモリ使用状況を確認する。
  • Lombokを使うクラスで保存やインポート整理が失敗する場合はLombokのバージョンと設定を確認する。
  • 検索やコード補完がおかしい場合はリフレッシュとクリーンを試し、新しいワークスペースでも比較する。
  • キー入力や選択だけが効かない場合はmacOSのショートカット競合や該当する既知問題を確認する。

起動時や右クリック時など、決まった操作で止まる場合はその操作と発生時刻を控えておきます。設定を一度に変えず変更するたびに同じ操作で症状が出るか確認してください。

macOSでEclipse 2025-06が不安定になる主な症状

Eclipseが頻繁にフリーズする

今回のEclipseのフリーズには3つのパターンがあります。

  • パターンA:しばらく待てば回復するフリーズ
    バックグラウンドジョブ(インデックス更新やビルド処理)が重なったときに数秒〜数十秒操作不能になるケースです。虹色カーソル(macOSのビーチボール)が出て待てば戻ってきます。
  • パターンB:強制終了しか手がない完全フリーズ
    操作を受け付けなくなったままいくら待っても回復しないケースです。強制終了するしかなく未保存の作業内容はすべて失われます。Eclipse 2025-06+macOSの組み合わせで特に報告が多いようです。発生タイミングが「保存時」「ファイルを開いたとき」のような決まったきっかけがないのが厄介なところです。
  • パターンC:カーソルは動くが文字入力・保存ができない(部分フリーズ)
    カーソルは動くのに文字入力や選択操作だけが効かない場合は、完全フリーズとは別の問題として切り分けます。
    macOS側のショートカットとEclipseのショートカットが競合しているケースや、SWTの入力・選択処理に関する既知問題が報告されています。が、これらの問題はEclipse全体のフリーズや保存不能の原因を示すものではありません。GitHubでは下記が別問題として挙げられています。
    Issue #1398はmacOS 14.6以降でOSとEclipseに同じショートカットが割り当てられている場合にOS側の操作が優先される問題です。
    Issue #2621はmacOS 26.1で文字の複数行選択やSelect Allが正常に動かない問題です。使用中のmacOSバージョンと症状が一致する場合だけ、該当Issueを参考にしてください。

パターンBとパターンCは症状が異なるため同じ原因として扱わない方が安全です。

Eclipse全体が応答しない場合はメモリ使用量、実行JDK、Eclipseのログを確認します。文字入力や選択だけが効かない場合はmacOSのバージョン、ショートカット競合、SWTの既知問題を確認してください。

Auto Saveはフリーズの原因を直す設定ではありませんが、強制終了が必要になったときの作業ロスを減らせます。

Lombok使用クラスでインポート整理が壊れる

LombokはEclipseのコンパイラAPIに深く依存しているため、Eclipseのバージョンが上がるとすぐ影響を受けます。

典型的な症状は「@RequiredArgsConstructorなどのアノテーションを付けたクラスでインポート整理を実行すると必要なimport文が削除される」というものです。コンパイルエラーが増えてしまい地味に開発の邪魔になりますよね。

メソッドの呼び出し階層が正しく検索されない

「呼び出し階層を開く」で実際と異なる呼び出し元が表示される場合は、インデックスやビルド状態、ワークスペースのメタデータに問題がある可能性があります。まずリフレッシュとクリーンを試し、改善しなければ新しいワークスペースで挙動を確認します。

コード補完やインデックスの挙動が不安定

コード補完の候補が出るまで時間がかかる、型が認識されないといった症状もインデックスやビルド状態の切り分け対象です。症状だけでインデックス破損と断定せずに後述するリフレッシュ、クリーン、新しいワークスペースの順に確認します。

macOS側の入力不具合とEclipseの応答停止を切り分ける

フリーズや入力不能の症状だけではEclipse本体とmacOSの相性が原因とは断定できません。Eclipseを起動しているJava、Lombokなどのプラグイン、ワークスペース、Mac全体の負荷を順番に確認する必要があります。

まずはEclipse本体を動かしているJavaを確認します。プロジェクトのコンパイルに使っているJavaとは別なので混同しないようにしてください。

Eclipse本体を動かしているJavaを確認する

Eclipse 2025-06はEclipse 4.36にあたり、Eclipse本体を動かすにはJava 21以上が必要です。

ここで確認するのはプロジェクトのコンパイルに使うJavaではなくEclipseそのものを起動しているJavaです。プロジェクトがJava 17やJava 11を対象にしていてもそれだけでフリーズの原因とは断定できません。

Eclipse本体をJava 21以上で起動しながら、開発中のプロジェクトではJava 17やJava 11を使う構成も可能です。


Java 8・17・21・25・26のサポート期間やLTSと非LTSの違いは次の記事で整理しています


Eclipse以外でもMac全体が重い場合はこちら。

Apple Silicon / Intel Macで起こる違い

Apple SiliconのMacでは使用しているEclipseとその起動に使うJDKのアーキテクチャを確認します。EclipseとJDKは対応する組み合わせで使用してください。

Eclipse本体がIntel版かApple Silicon版かはFinderの「情報を見る」やターミナルのlipoで確認できます。

Intel版のアプリをApple Silicon上で使う場合はRosettaによる変換が入ります。メモリ不足やGCによる停止はApple SiliconでもIntel Macでも起こるため、CPUの種類だけで原因を決めず実際のメモリ使用状況を確認します。

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

-javaagent:lombok.jarのように相対パスで記載されている場合は使用中のEclipseアプリ内でlombok.jarの実際の保存場所を確認します。

FinderでEclipseアプリを右クリックし「パッケージの内容を表示」を選択してください。Contents/EclipseとContents/MacOSを確認し、実際に存在するlombok.jarのフルパスを次のコマンドへ指定します。

コマンド
java -jar "/実際に確認したlombok.jarのフルパス" --version
コマンド – 実行結果
Lombok v1.18.38 "Envious Ferret"

検索・補完不具合ではワークスペースの状態を確認する

インデックスやビルド状態に問題がある場合の症状

Eclipseはコード補完や検索に必要な情報をワークスペース内で管理しています。コード補完、検索、呼び出し階層の結果がおかしい場合、プロジェクトのビルド状態、ワークスペースのメタデータ、インデックスの不整合などを切り分けます。

症状だけでインデックス破損と断定せず、リフレッシュ、クリーン、新しいワークスペースの順に確認してください。

呼び出し階層や検索結果を切り分ける

呼び出し元が表示されない、削除済みのクラスが検索結果へ残るといった症状がある場合はまずプロジェクトにビルドエラーがないか確認します。

ビルド状態に問題がなければリフレッシュとクリーンを試し、それでも改善しない場合は新しいワークスペースで同じプロジェクトを開いて挙動を比較してください。

Eclipse 2025-06のまま使う場合の対処法

Eclipse 2025-06を使い続ける必要がある場合は、症状に合う対処から試してください。筆者の環境では2025-12へ変更後に問題なく使えていますが、まずは現在の実行JDK、Lombok、ワークスペースの状態を確認します。

Auto Saveを有効にして作業ロスを防ぐ

完全フリーズは根本解決が難しいケースもあるため、強制終了時の被害を最小限にすることも重要な対策です。EclipseにはAuto Save(自動保存)機能があるので一定間隔でファイルを自動保存できます。

設定はEclipse > 設定 > 一般 > エディター > 自動保存から有効化します。

  • 編集中のエディターの自動保存を使用可能にするにチェックを入れる。
  • 自動保存間隔を調整します。60秒程度がいいかもしれません(デフォルトは20秒です)。

⚠️ 注意 自動保存はあくまで「被害を減らす」ための設定です。フリーズ自体を解消するものではないため、後述のメモリ設定やJDK変更と合わせて対処することをおすすめします。

Eclipseのメモリ設定(eclipse.ini)を見直す

Eclipseに割り当てるメモリが少ないと大きなプロジェクトでGC(ガベージコレクション)が頻発してフリーズの原因になるようです。

Eclipseを終了してからeclipse.iniをバックアップして開きます。-Xmsと-Xmxは-vmargsより後ろに1行ずつ記述してください。すでに同じ項目があればその行の値を変更します。

下記は初期ヒープサイズを512MB、最大ヒープサイズを4GBにする設定例です。

eclipse.ini
-Xms512m
-Xmx4096m

ファイルの場所はこちらです。

コマンド
vim /Applications/Eclipse_2025-06.app/Contents/Eclipse/eclipse.ini

-Xmx4096mは設定例です。必要な容量はプロジェクトの規模やプラグインによって変わります。現在の上限がすでに4GB以上なら、この例へ書き換える前に使用状況を確認してください。

Macのアクティビティモニタで「メモリ」を開き、メモリプレッシャーとスワップ使用領域を確認します。Mac全体でメモリが不足している場合は、同時に使うアプリを減らしてから比較してください。設定変更後はEclipseを起動し直し、同じ作業で改善したか確認します。

eclipse.iniを直接編集するため、誤った記述をするとEclipseが起動しなくなることがあります。編集前に元のファイルをバックアップしておいてください。

Eclipse本体の実行JDKをJava 21以上にする

Eclipse 2025-06(Eclipse 4.36)を動かすにはJava 21以上が必要です。macOSで複数のJDKが混在している場合はjava_homeコマンドでバージョンを確認できます。

コマンド
/usr/libexec/java_home -V
実行結果
Matching 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の中にJava 21以上があるか確認します。

このコマンドで確認できるのは、macOSにインストールされているJDKの一覧です。Eclipseが実際にどのJavaで起動しているかは、この結果だけでは確定できません。

Eclipseのメニューから「ヘルプ」「Eclipse IDEについて」「インストール詳細」「構成」の順に開きeclipse.vmとjava.versionを検索してください。eclipse.vmにはEclipseが起動時に使用したJavaのパス、java.versionにはJavaのバージョンが表示されます。

Eclipse 2025-06ではjava.versionが21以上になっていることを確認します。

eclipse.iniに-vmの指定がある場合Eclipse本体はそこに記載されたJavaで起動します。プロジェクトで使用するJavaの設定とは別なので、Eclipse本体の実行JDKとして確認してください。

筆者のマシンには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/Home

21.0.10 (arm64)がインストールできました。x86_64がインストールされてしまった場合はRosetta経由の実行になるのでパフォーマンス面で不利になります。Apple SiliconのMacを使っている場合はarm64版になっているか確認してみてください。

今回の環境では/usr/libexec/java_homeの結果もJava 21へ変わりました。なんですが、この結果とEclipseが実際に使用しているJavaは必ずしも同じとは限りません。Java 21のインストール後にEclipseを再起動し、インストール詳細のeclipse.vmとjava.versionをもう一度確認します。

コマンド
/usr/libexec/java_home
実行結果
/Library/Java/JavaVirtualMachines/temurin-21.jdk/Contents/Home

リフレッシュとクリーンを試し新しいワークスペースで切り分ける

リフレッシュとクリーンは検索やコード補完がおかしいときに最初に試しやすい対処です。

リフレッシュはEclipse内の情報をローカルファイルと同期する操作、クリーンは既存のビルド状態を破棄してビルドし直す操作です。これだけでJDTのインデックスが完全に作り直されるとは限りません。

まずリフレッシュとクリーンを試し、改善しない場合は新しいワークスペースで同じプロジェクトを開いて挙動を確認します。

  1. ワークスペースのリフレッシュ
    プロジェクトエクスプローラーで全プロジェクトを選択し右クリック > リフレッシュを実行します。
  2. プロジェクトのクリーン
    メニュー > プロジェクト > クリーンを選択しすべてのプロジェクトをクリーンを選んでOKをクリックします。
  3. 新しいワークスペースで確認する
    リフレッシュとクリーンで改善しない場合、現在のワークスペースをバックアップしてから新しいワークスペースで挙動を確認します。
    Eclipseのメニューから「ファイル」「ワークスペースの切り替え」「その他」の順に開き、空のフォルダを新しいワークスペースとして指定してください。
    Eclipseが再起動したら、使用しているプロジェクトの形式に合わせてプロジェクトをインポートします。新しいワークスペースで症状が出なくなった場合、元のワークスペースに保存されている設定やメタデータが影響している可能性があります。
    確認が終わるまでは元のワークスペースを削除しないでください。

Lombokの最新版を適用する

Lombokの公式サイトからlombok.jarをダウンロードします。Eclipseを終了しダウンロードしたJARを次の形式で実行してください。パスは実際の保存先へ置き換えます。

コマンド
java -jar "/ダウンロード先/lombok.jar"

インストーラーで今回使用しているEclipseを選んでインストールします。Eclipseを複数入れている場合は、対象のアプリを間違えないよう確認してください。

インストール後はEclipseを起動し直し、問題が出たクラスで保存やインポート整理を試します。MavenやGradleで指定しているLombokの依存関係も確認してください。

別バージョンのEclipseに変更する

筆者の場合はEclipse 2025-12に変えてみて特に問題なく使用できています。設定を見直しても改善しない場合は、別バージョンを別の場所へインストールし同じ作業で症状が出るか比較してみてください。

比較には新しいワークスペースを使いプロジェクトをインポートします。新しいEclipseで開いたワークスペースを古いバージョンで開くと互換性の問題が起きることがあります。元のワークスペースはバックアップして残してください。

迷いやすいポイント

Apple SiliconのMacとIntel Macで対処法は変わる?

基本的な切り分け方は同じです。Apple SiliconではEclipseと起動用JDKのアーキテクチャを確認してください。どちらのMacでも実行JDK、メモリ使用状況、Lombok、ワークスペースを確認します。

Lombokを更新したらプロジェクトのビルドエラーが増えました。

まずエラーメッセージを確認し、Eclipseへ導入したLombokとMavenやGradleで指定しているLombokのバージョンを確認してください。Eclipseを完全に終了して起動し直し、プロジェクトのクリーンを試します。更新前のバージョンへ戻す場合はその版が使用中のEclipseとJDKに対応していることを確認してください。

eclipse.iniを編集したらEclipseが起動しなくなりました。

バックアップから元のeclipse.iniに戻してください。バックアップがない場合はPleiades All in Oneを再インストールすることで初期状態のeclipse.iniが復元されます。

Pleiades以外の通常版Eclipseでも同じ症状が起きる?

Pleiadesに限らずmacOS上のEclipse 2025-06全般で起きる可能性があります。Lombokのインストール方法やeclipse.iniの場所が異なりますが、対処法の考え方は同じです。

まとめ

  • Eclipse 2025-06はEclipse 4.36にあたり本体の起動にはJava 21以上が必要だよ。プロジェクトで使うJavaとは分けて確認してね。
  • 完全フリーズ、キー入力・選択の不具合、Lombokエラー、検索・補完の不具合は同じ原因とは限らないよ。
  • 実行JDK、Lombok、メモリ設定、ワークスペースを順番に切り分けて確認してね。
  • 改善しない場合はEclipseのログを確認した上で、別のワークスペースや別バージョンでも再現するか比較してみるといいよ。
  • URLをコピーしました!
目次