Git ワークツリーを使用する。

標準的な Git リポジトリは通常、1つのワークツリーのみを使用します。この構成でブランチを切り替えるには、未完了の作業をコミットまたはスタッシュする必要があります。 Git ワークツリーを使用すると、複数のブランチを別々のディレクトリで同時にチェックアウトでき、すべてが1つの .git ディレクトリにリンクされます。

Git ワークツリーとは?

Git ワークツリーを使うことで、同じリポジトリの複数のブランチを同時に別々のディレクトリでチェックアウトできます。 Git ワークツリーの主なユースケースは次のとおりです。

AI 駆動開発：AI エージェントを別のワークツリーで実行し、ローカルの未保存変更が上書きされないようにします。
緊急バグ修正：進行中の作業を中断せずに、別のディレクトリで重大な問題に対応します。
パラレルコードレビュー：既存の環境、データベース状態、ビルドアーティファクトに影響を与えずに、プルリクエストやマージリクエストをローカルでチェックアウトしテストします。
長時間実行されるタスク：1つのワークツリーで重いテストスイートや複雑なビルドを実行しながら、別のワークツリーでコードを書き続けます。
マルチブランチのコンテキストスイッチ：変更をスタッシュしたり、ブランチ切り替え後の大量ファイルの再インデックスを待たずに、複数の長期ブランチを管理します。

Git ワークツリーは、プロジェクトのリンクされたコピーです。 git clone のようにリポジトリの完全な複製を作成する場合とは異なり、すべてのワークツリーは同じ中央の .git 履歴を共有します。

ワークツリーを作成すると、Git によってファイル用の新しいディレクトリが生成されます。完全な .git フォルダーの代わりに、このディレクトリは元のリポジトリへのパスを記載したプレーンテキストの .git ファイルを含みます。これにより、すべてのワークツリーが同期を保ちながら、それぞれ独立した作業環境を維持できます。

メインワークツリーの Git フォルダーとリンクされたワークツリーの Git ファイル。

Git ワークツリーの詳細については、公式 Git ドキュメントを参照してください。

Git ワークツリーの作成と管理。

プロジェクトですでに2つ以上の Git ワークツリーがある場合、ワークツリータブはデフォルトで使用できます。それ以外の場合は、 Git ツールウィンドウ Alt+9 で、をクリックし、ワークツリーを選択して開くことができます。

Git ワークツリーを作成する。

Git ツールウィンドウ Alt+9 で、ワークツリータブを開き、新しいワークツリーをクリックします。
または、メインメニューで Git｜新しいワークツリーを選択します。
これにより、新しいワークツリーダイアログが開きます。
新しいワークツリーダイアログで、次の項目を指定します。
- 元のブランチ：元となるブランチを選択します。
  同じブランチを2つのワークツリーで同時にチェックアウトすることはできませんのでご注意ください。現在チェックアウトしているブランチを新しいワークツリーの元として使いたい場合は、そこから別のローカルブランチを作成し、それを新しいワークツリーで使うことができます。その場合は、新規ブランチオプションを選択します。
  選択した元ブランチがリモートの場合、既存のローカルブランチと重複しない新しい名前を新規ブランチオプションで指定しない限り、同じ名前のローカルブランチが作成されます。
- プロジェクト名：新しいワークツリーの名前。
- ロケーション：ワークツリーを格納するディレクトリ。
  ワークツリーの入れ子は避けましょう：現在のプロジェクトのディレクトリ（例： Projects/mainProject/linkedWorktree ）の中にワークツリーを作成することは推奨されません。現在、このようなプロジェクトは IntelliJ IDEA によりマルチルートプロジェクトと誤認され、ワークツリー統合が機能しません。