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

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

Git ワークツリーとは何ですか？

Git ワークツリーを使用すると、同じリポジトリの複数のブランチを別々のディレクトリに同時にチェックアウトできます。 Git ワークツリーの一般的な使用例は次のとおりです。

AI を活用した開発: ローカルに保存されていない変更が上書きされないように、AI エージェントを別のワークツリーで実行します。
緊急バグ修正: 現在の作業を中断することなく、別のディレクトリで重大な問題を解決します。
並行コードレビュー: 既存の環境、データベースの状態、ビルドアーティファクトに影響を与えることなく、プルリクエストとマージリクエストをローカルでチェックアウトおよびテストできます。
長時間実行されるタスク: 1 つのワークツリーで大規模なテストスイートや複雑なビルドを実行しながら、別のワークツリーでコードの記述を続けます。
マルチブランチコンテキスト切り替え: スタッシュの変更や、ブランチ切り替え後の大量のファイルの再インデックスを待つことなく、複数の長時間実行されるブランチを管理します。

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

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

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

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

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

プロジェクトにすでに複数の Git ワークツリーが存在する場合、ワークツリータブはデフォルトで表示されます。そうでない場合は、をクリックしてワークツリーを選択することで、 Git ツールウィンドウ Alt+9 内で開くことができます。

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

Git ツールウィンドウ Alt+9 で、ワークツリータブを開き、新しいワークツリーをクリックします。
あるいは、メインメニューで Git | 新しいワークツリーを選択します。
これにより、新しいワークツリーダイアログが開きます。
新しいワークツリーダイアログで、以下を指定します。
- ブランチより: ソースブランチを選択してください。
  同じブランチを 2 つのワークツリーで同時にチェックアウトすることはできませんのでご注意ください。現在チェックアウトされているブランチを新しいワークツリーのソースとして使用したい場合は、そこから別のローカルブランチを作成し、新しいワークツリーで使用できます。そのためには、新規ブランチオプションを選択してください。
  選択されたソースブランチがリモートの場合、新規ブランチオプションを選択して既存のローカルブランチと一致しない新しい名前を指定しない限り、同じ名前のローカルブランチが作成されます。
- プロジェクト名: 新しいワークツリーの名前。
- ロケーション: ワークツリーが保存されるディレクトリ。
  ワークツリーのネストは避けてください。現在のプロジェクトのディレクトリ内にワークツリーを作成すること（例えば、 Projects/mainProject/linkedWorktree ）は推奨されません。現在、WebStorm はそのようなプロジェクトをマルチルートプロジェクトとして誤認識し、ワークツリーの統合が機能しなくなります。