GoLand 2026.1 ヘルプ

共有インデックス

共有インデックスを使用すると、GoLand によるプロジェクト解析にかかる時間を短縮できます。プロジェクトを解析するたびにローカルで作成される通常のインデックスとは異なり、共有インデックスは一度生成され、必要に応じて他のコンピューターで再利用されます。

GoLand は、プロジェクトのコードに対して共有インデックスを構築して使用できます。IDE がプロジェクトを再解析する必要があるときはいつでも、利用可能な共有インデックスを使用し、プロジェクトの残りの部分にはローカルインデックスを構築します。通常、これはプロジェクト全体をローカルで最初から解析するよりも高速です。

プラグインのインストール

共有プロジェクトインデックスを使用するには、共有インデックス(英語)プラグインをインストールする必要があります。

  1. Ctrl+Alt+S を押して設定を開き、プラグインを選択します。

  2. マーケットプレースタブに切り替えて、Shared Indexes と入力し、インストールをクリックします。

  3. 変更を適用してダイアログを閉じます。プロンプトが表示されたら IDE を再起動します。

共有プロジェクトインデックス

共有プロジェクトインデックスは、プロジェクトソースとその依存関係に基づいて構築されます。単一のコンピューターでインデックスを生成し、他のコンピューターに配布することで、各マシンでプロジェクト分析プロセスを繰り返す必要がなくなります。これにより、各コンピューターは、高コストなプロジェクト分析操作を個別に実行することなく、事前に計算されたインデックスを活用できます。これが、通常のインデックスと比較した共有インデックスの主な利点です。

始める前に

共有プロジェクトインデックスを構築するコンピューターと、これらの共有インデックスを使用するすべてのコンピューター:

  • インデックスの互換性を確保するには、同じ IDE バージョンを使用する必要があります。

  • 異なるオペレーティングシステムを使用できます。

共有プロジェクトインデックスをインフラストラクチャに組み込む前に、コマンドラインツールを実行して、プロジェクト分析にかかる時間をどれだけ節約できるかを評価できます。

結果に満足したら、共有インデックスを使い続けることができます。より複雑なシナリオでは、IntelliJ 共有インデックスツールの例(英語)リポジトリのサンプルスクリプトをカスタマイズできます。たとえば、JSON 設定ファイルを使用して、共有インデックスの生成時に xz 圧縮を無効にしたり、gzip 圧縮を使用したりできます。

共有インデックスを使用してプロジェクト分析時間を評価する

ワークフローで共有プロジェクトインデックスを使用する前に、どれだけの時間を節約できるかを確認できます。評価中、ツールは指定したディレクトリにいくつかのファイルを生成します。

  1. コマンドラインツール(英語)の最新バージョンをダウンロードし、アーカイブを解凍します。

  2. コマンドラインで、コマンドラインツールのディレクトリに移動し、次のコマンドを実行してバイナリファイルを実行します。

    .\bin\ij-shared-indexes-tool-cli.bat boost
    ./bin/ij-shared-indexes-tool-cli boost
    ./bin/ij-shared-indexes-tool-cli boost

    次のオプションを使用します。

    • --ij : ローカルにインストールされた IDE への (必須) パス。

    • --project : 共有インデックスを構築するプロジェクトへの (必須) パス。

    • --port : ローカルサーバーを実行するためのポート。デフォルトのポートは 25561 です。

    • --data-directory : 生成されたインデックスとサーバーデータを保存するディレクトリ。デフォルトのディレクトリは ./ij-shared-indexes-tool-data です。

    例:

    ./bin/ij-shared-indexes-tool-cli boost --ij "/Users/jetbrains/Library/Application Support/JetBrains/Toolbox/apps/PyCharm-P/ch-1/232.7754.76/PyCharm 2023.2 EAP.app" --project "/Users/jetbrains/PycharmProjects/mySampleProject"

    例:

    ./bin/ij-shared-indexes-tool-cli boost --ij "/Users/jetbrains/Applications/GoLand.app" --project "/Users/jetbrains/gitProjects/serverdemo"
  3. しばらくお待ちください。その後、共有インデックスありとなしのプロジェクト分析時間が表示されます。

    Estimated project analysis time

時間の差を比較することで、ワークフローで共有プロジェクトインデックスを使用するかどうかを決定できます。

プロジェクトインデックスを生成する

インデックスファイルを生成するには、次の手順に従います。インデックスが生成されたら、ファイルをファイルサーバーまたは S3 互換ストレージにアップロードするを実行する必要があります。

  1. コマンドラインツール(英語)の最新バージョンをダウンロードし、アーカイブを解凍します。

  2. コマンドラインで、コマンドラインツールのディレクトリに移動し、次のコマンドを実行してコマンドライン経由でバイナリファイルを実行します。

    .\bin\ij-shared-indexes-tool-cli.bat indexes
    ./bin/ij-shared-indexes-tool-cli indexes
    ./bin/ij-shared-indexes-tool-cli indexes

    次のオプションを使用します。

    • --ij : (必須) ローカルにインストールされた IDE へのパス

    • --project : 共有インデックスを構築するプロジェクトへの (必須) パス。

    • --base-url : (必須) インデックスサーバーの URL。共有インデックスがホストされる完全な URL を定義するために使用されるベース URL。

    • --data-directory : 生成されたインデックスとサーバーデータを保存するディレクトリ。デフォルトのディレクトリは ./ij-shared-indexes-tool-data です。このディレクトリから、base-url パラメーターで指定されたサーバーにファイルをアップロードする必要があります。

  3. プロジェクトインデックスが生成されると、プロジェクト内の共有インデックスを構成するために必要な情報を含むメッセージが表示されます。

インデックスを生成すると、indexes コマンドの実行時に指定したディレクトリに、servertemp の 2 つのフォルダーが表示されます。インデックスファイルは、server ディレクトリ内に保存されます。

ファイルをストレージにアップロードする

インデックスを生成すると、indexes コマンドの実行時に指定したディレクトリに、servertemp の 2 つのフォルダーが表示されます。インデックスファイルは、server ディレクトリ内に保存されます。

共有インデックスをリモートストレージにアップロードする

  • server ディレクトリから data および project フォルダーをファイルサーバーまたは S3 互換ストレージにアップロードします。ストレージの場所のベース URL は、インデックスの生成時に base-url パラメーターを使用して定義された URL と同じである必要があります。

ローカルでテストするときに共有インデックスを公開する

共有インデックスをテストする場合、server コマンドを使用して、生成されたファイルでサーバーを起動できます。

  • コマンドラインで、コマンドラインツールのディレクトリに移動し、次のコマンドを実行してバイナリファイルを実行します。

    .\bin\ij-shared-indexes-tool-cli.bat server
    ./bin/ij-shared-indexes-tool-cli server
    ./bin/ij-shared-indexes-tool-cli server

    次のオプションを使用します。

    • --port : ローカルサーバーを実行するためのポート。

    • --server-directory : サーバーデータのディレクトリ。デフォルトのディレクトリは ./ij-shared-indexes-tool-data/server です。

    例:

    .\bin\ij-shared-indexes-tool-cli.bat server --port 8080 --server-directory "C:\Users\jetbrains\ij-shared-indexes-tool-data\server"
    ./bin/ij-shared-indexes-tool-cli server --port 8080 --server-directory "/Users/jetbrains/ij-shared-indexes-tool-data/server"
    ./bin/ij-shared-indexes-tool-cli server --port 8080 --server-directory "/home/jetbrains/ij-shared-indexes-tool-data/server"

共有インデックスへのアクセスを構成する

プロジェクトインデックスをファイルストレージにアップロードすると、別のコンピューターにダウンロードして適用できるようになります。

  • プロジェクトディレクトリで、新しいファイル intellij.yaml を作成し、ターミナルからの情報を新しいファイルにコピーします。例:

    YAML file with shared indexes

    プロジェクトがまだ分析されていない場合、またはシステムキャッシュをクリアしている場合は、IDE は共有インデックスをダウンロードして使用します。

    デフォルト設定では、IDE は共有インデックスを自動的にダウンロードします。これを変更して、ダウンロードごとに手動で確認することもできます。

プロジェクトインデックスは、IDE システムディレクトリindex/shared_indexes にダウンロードされます。

インデックスのダウンロード中は、ステータスバーに進行状況が表示されます。

すべての準備が完了すると、対応する通知が通知ツールウィンドウに表示されます。

Shared indexes are downloaded

インデックスのダウンロード方法を変更する

デフォルト構成では、IDE は共有インデックスを自動的にダウンロードします。すべてのダウンロードを手動で確認できます。

  1. intellij.yaml ファイルから consents セクションを削除し、プロジェクトを再起動します。

  2. 設定ダイアログ (Ctrl+Alt+S) でツール | 共有インデックスを選択し、プロジェクト共有インデックス領域でダウンロード前に確認を選択します。

    Configuring options for downloading shared indexes
  3. 変更を適用し、ダイアログを閉じます。

ダウンロードした共有インデックスを無効化する

無効化後、GoLand は利用可能な新しい共有インデックスがあればダウンロードして使用します。そうでない場合は、プロジェクト分析中に新しいインデックスがローカルで構築されます。

  1. メインメニューからファイル | キャッシュの破棄…を選択します。

  2. ダウンロードした共有インデックスを無効化するを選択し、破棄して再起動をクリックします。

共有インデックス CLI コマンドリファレンス

ブースト

プロジェクト共有インデックスを使用してプロジェクト分析の速度を測定します。オプション:

  • --project : (必須) プロジェクトへのパス。

  • --ij : (必須) ローカルにインストールされた IDE へのパス

  • --port : ローカルサーバーを実行するためのポート。デフォルトのポートは 25561 です。

  • --data-directory : 生成とサーバーデータに使用するディレクトリ。

インデックス

プロジェクト共有インデックスを生成し、アップロードできるように準備します。オプション:

サーバー

ローカルインデックスでサーバーを起動します。オプション:

  • --port : ローカルサーバーを実行するためのポート。デフォルトのポートは 25561 です。

  • --server-directory : サーバーデータのディレクトリ。デフォルトのディレクトリは ./ij-shared-indexes-tool-data/server です。

バージョン

共有インデックスのバージョン情報を表示します。オプション:

コマンドラインから共有インデックスを引き続き使用できます。より複雑なシナリオでは、IntelliJ 共有インデックスツールの例(英語)リポジトリからサンプルスクリプトをカスタマイズできます。

2026 年 4 月 22 日

関連ページ:

プロジェクト分析

プロジェクト分析により、GoLand はスマート IDE 機能 (コード補完、インスペクション、リファクタリング、ナビゲーション、使用箇所の検索、構文のハイライト) を有効にできます。GoLand は、新しいプロジェクトを開いたりクローンを作成したり、プラグインを有効化または無効化したり、ブランチを切り替えたりした後に、このプロセスをトリガーします。また、大規模な外部ファイルの更新(たとえば、プロジェクトのビルド時に複数のファイルが作成または生成される場合など)後にもトリガーされます。分析中、G...

キャッシュの破棄

GoLand は、この IDE バージョンでこれまでに作業したすべてのプロジェクトの大量のファイルをキャッシュするため、システムキャッシュがオーバーロードになる可能性があります。たとえば、頻繁に短期プロジェクトを扱う場合など、キャッシュが二度と必要なくなる場合があります。キャッシュを無効にすると、GoLand は、現在のバージョンの IDE で実行されたすべてのプロジェクトのキャッシュファイルを削除します。次回これらのプロジェクトを開いたときに、ファイルが再作成されます。システムキャッシュをクリ...

IDE で使用されるディレクトリ

デフォルトでは、GoLand は、各 IDE インスタンスのユーザー固有のファイル(構成、キャッシュ、プラグイン、ログなど)をユーザーのホームディレクトリに保存します。ただし、必要に応じて、これらのファイルを保存する場所を変更できます。IDE で使用されるファイルとディレクトリを見つけるメインメニューからを選択します。開いたダイアログには、GoLand によって使用されるすべてのファイルとディレクトリが、現在のインストールの正確なパスとともに表示されます。リスト内の特定の項目を選択してキーを押...

スコープとファイルの色

スコープは、プロジェクト内のファイルとフォルダーの名前付きセットです。スコープを使用すると、IDE のさまざまなビューでプロジェクト項目を視覚的に区別し、特定の操作の範囲を制限できます。スコープを使用すると、ファイルを論理的に整理できます。たとえば、テストソースをテストスコープに配置し、本番環境のコードを本番環境スコープに配置することができます。これにより、大スコーププロジェクトでの作業が容易になります。インスペクションをテストのみで実行すると、コードベース全体で実行するよりも高速になります。G...