IntelliJ IDEA 2025.3 ヘルプ

モジュールをアンロードする

IntelliJ IDEA の動作を高速化するために、現時点では必要のないモジュールを一時的に確保 (アンロード) することができます。IDE は、コードの検索やリファクタリング、またはプロジェクトのコンパイル時に、アンロードされたモジュールを無視します。

モジュールをアンロードするときは、ローカルで実行します。アンロードされたモジュールに関する情報は、バージョン管理を通じて共有されません。

モジュールを手動でアンロードする

  1. プロジェクトツールウィンドウ (Alt+1 または表示 | ツールウィンドウ | プロジェクト ) でモジュールを右クリックし、モジュールのロード / アンロードを選択します。

  2. ダイアログ内のモジュールをダブルクリックしてロードまたはアンロードすることも、ダイアログ中央のボタンを使用することもできます。

Unloading a module

新しいモジュールを自動的にロードおよびアンロードする

チームメイトが新しいモジュールをプロジェクトに追加する場合は、それらのモジュールをプロジェクトアップデート上のコンピューターにダウンロードします。その後、IDE は更新されたプロジェクト内のすべてのモジュール間の依存関係を分析します。

アンロードされたモジュールがある場合、IntelliJ IDEA は依存関係分析の結果に従って新しいモジュールをロードまたはアンロードします。

新しいモジュールが既存のアンロード済みモジュールに依存している場合、新しいモジュールはアンロード済みとしてマークされます。そうでなければ IntelliJ IDEA はそれらをコンパイルしようとするとエラーに直面するかもしれないため無視します。

Adding new modules to the unloaded module

既存のロード済みモジュールが新しいモジュールに直接依存している場合、新しいモジュールはロード済みとしてマークされます。

Adding new modules to the loaded module

既存のロードされているモジュールが新しく追加されたモジュールに依存していない場合、新しいモジュールはアンロード済みとしてマークされます。必要になったらすぐに手動でロード済みとしてマークを付けることができます。

Adding new modules to the loaded module with no dependencies

アンロードされたモジュールで変更をコミットする

アンロードされたモジュールがあり、アンロードされたモジュールが依存するファイルを変更した場合、それらのモジュールのコンパイルは、ロードした後で失敗することがあります。

アンロードされたモジュールのコンパイルエラーを回避するには、変更のコミットダイアログで影響を受けるアンロード済みのモジュールをコンパイルするオプションが選択されていることを確認してください。

変更されたファイルをコミットする前に、IntelliJ IDEA はアンロードされたモジュールをコンパイルして、変更がこれらのモジュールに影響を与えないことを確認します。IDE は検出されたエラーについて通知し、コミット前にエラーを解決することを提案します。

トラブルシューティング

プロジェクト内のモジュールが互いに依存している場合は、1 つ以上のモジュールをアンロードするとエラーが発生する可能性があります。

例: モジュール 1 がモジュール 2 に依存しており、モジュール 2 をアンロードした場合、IntelliJ IDEA はモジュール 2 のクラスへの参照を解決できません。さらに、モジュール 1 のコンパイルはおそらく失敗します。

このようなエラーを回避するために、IDE はモジュールをロードまたはアンロードするときに依存関係を分析します。モジュールをロードするとき、IntelliJ IDEA はすべての依存関係もロードすることを提案します。モジュールをアンロードすると、IDE はすべての依存モジュールを見つけて、それらもアンロードします。

Unloading modules

モジュール 1 をアンロードすると、モジュール 2 のコードにエラーが表示されず、モジュール 2 もコンパイルできます。ただし、モジュール 2 のコードを変更することで、モジュール 1 の依存コードのコンパイルを誤って中断する可能性があります。モジュール 1 はアンロードされているため、ロードし直してコンパイルするまでエラーは表示されません。

モジュール 2 に含まれる使用箇所の検索 Alt+F7 またはクラス、フィールド、メソッド Ctrl+Alt+Shift+T のリファクタリングを呼び出すと、モジュール 1 の内容が考慮されないため、結果が不完全になる可能性があります。IntelliJ IDEA がそれについて通知します。

さらに、IDE は変更をコミットするたびにアンロードされたモジュールをコンパイルし、変更がアンロードされたモジュールに影響しないことを確認します。アンロードされたモジュールによる変更のコミットの詳細を参照してください。

Unloading modules
2024 年 2 月 11 日