Eclipseは-cleanオプションで起動するとプラグインキャッシュを作り直す

この記事は、構成と文章の整理にAIを使っています。
あくまで読みやすくするための補助で、内容そのものをAIにすべて任せて書いているわけではありませんが、ところどころ相談しながら整えています。

症状

Eclipseにプラグインを入れたり消したりしていると、メニューに古いプラグインの項目が残ってたり、逆に入れたはずのプラグインが読み込まれなかったりすることがある。普通に再起動しても直らない。

コマンド

Macの場合、アプリ内のバイナリを直接叩いて-cleanオプションを渡す。

/Applications/eclipse/Eclipse.app/Contents/MacOS/eclipse -clean

Dockのアイコンから起動する分には渡せないので、ターミナルから叩く必要がある。

何をしているか

-cleanは起動時にconfigurationフォルダ以下にあるキャッシュ（プラグインのバンドル情報など）を破棄して、登録情報を作り直すオプションらしい。中身の実装までは実機で追っていないので未確認。プラグイン本体のファイルが消えるわけではなく、あくまでキャッシュの再構築なので、初回起動だけ普段より少し時間がかかる。

効くケース・効かないケース

• プラグインを追加/削除した直後にメニューやツールバーの表示がおかしい → だいたい直る
• 特定のプラグイン自体が壊れている（jarが壊れているなど） → -cleanでは直らない、プラグイン自体の入れ直しが必要

起動が一回遅くなるだけなので、Eclipseの挙動が怪しいと思ったら、とりあえず-clean付きで起動してみればいい。