GitHub Desktop でのワークツリーの管理

ワークツリーについて

Git ワークツリーを使用すると、同じリポジトリの複数のブランチを同時にチェックアウトできます。各ブランチはコンピューター上の独自のディレクトリにあります。つまり、機能ブランチで作業したり、別のブランチで pull request をすばやく確認したり、現在のブランチで不完全な作業を隠したりコミットしたりせずに修正プログラムを作成したりできます。

GitHub Desktop には、ワークツリーの作成、切り替え、名前変更、削除をサポートする組み込みサポートが用意されています。リポジトリにワークツリーがある場合、[リポジトリ] ドロップダウンと [ブランチ] ドロップダウンの間のツール バーに****Worktree ドロップダウンが表示されます。

メモ

[Worktree](ワークツリー) ドロップダウンは、少なくとも 1 つのリンクされたワークツリーがある場合にのみ表示されます。最初のワークツリーを作成するには、[ リポジトリ ] メニューを使用するか、ツールバーの [ リポジトリ ] ドロップダウンを右クリックします。

各ワークツリーは、ブランチ (またはデタッチされた HEAD コミット) に関連付けられています。メインワークツリーは元のリポジトリクローンであり、リンクされたワークツリーは作成した追加のチェックアウトです。

ワークツリーの作成

[ リポジトリ ] メニューから新しいワークツリーを作成するには、ツールバーの [ リポジトリ ] ドロップダウンを右クリックするか、[ Worktree ] ドロップダウンから (既にワークツリーを作成した後に) クリックします。

最初のワークツリーの作成

リポジトリにリンクされたワークツリーがまだない場合、 Worktree ドロップダウンはツールバーに表示されません。最初のワークツリーを作成するには:

メニューバーの [ リポジトリ] をクリックし、[ New Worktree...] をクリックします。

または、ツールバーの [ リポジトリ ] ドロップダウンを右クリックし、[ New Worktree...] をクリックします。
[ワークツリーの追加] ダイアログで、[ワークツリー名] フィールドにワークツリーの名前を入力します。

GitHub Desktop は、入力した名前に基づいて、ワークツリーが作成されるパスを自動的に決定します。完全なパスがダイアログの下部に表示されます。

必要に応じて、[ ブランチ名 ] フィールドにブランチ名を入力または選択します。
- このフィールドを空のままにすると、ワークツリーと同じ名前の新しいブランチが作成されます。
- 既存のローカルブランチの名前を入力すると、そのブランチは新しいワークツリーでチェックアウトされます。
- リモートブランチの名前を入力すると、リモート参照から新しいローカルブランチが作成されます。
[ ワークツリーの作成] をクリックします。

最初のリンクされたワークツリーを作成すると、ツールバーに [Worktree ] ドロップダウンが表示されます。

追加のワークツリーの作成

[Worktree](ワークツリー) ドロップダウンが表示されたら、そこからワークツリーを作成することもできます。

リポジトリバーで、 Worktree ドロップダウンをクリックします。
[ 新しいワークツリー] をクリックします。
「最初のワークツリーの作成」の説明に従って、[ワークツリーを追加] ダイアログの各フィールドに入力し、[ワークツリーを作成] をクリックします。

GitHub Desktop はワークツリーを作成し、自動的にワークツリーに切り替えます。

ワークツリー間の切り替え

ワークツリーはいつでも切り替えることができます。ワークツリーを切り替えると、 GitHub Desktop 選択したワークツリーのパスに作業ディレクトリが更新されます。

リポジトリバーで、 Worktree ドロップダウンをクリックします。
ワークツリーの一覧で、切り替えるワークツリーをクリックします。

ワークツリーリストは、"メインワークツリー" と "リンクされたワークツリー" にグループ化されます。各項目には、ワークツリーディレクトリ名と、関連付けられているブランチ名が表示されます。一覧の上部にあるフィルターフィールドを使用して、名前でワークツリーを検索できます。

ワークツリーの名前を変更する

リンクされたワークツリーの名前を変更できます。メインワークツリーの名前を変更することはできません。

リポジトリバーで、 Worktree ドロップダウンをクリックします。
名前を変更するワークツリーを右クリックし、[名前の 変更...] をクリックします。
[ワークツリー名の変更] ダイアログで、ワークツリーの新しい名前を入力します。
[名前変更] をクリックします。

ワークツリーの削除

不要になったリンクされたワークツリーを削除できます。 Git がロックしているメインワークツリーまたはワークツリーを削除して削除できないようにすることはできません。

リポジトリバーで、 Worktree ドロップダウンをクリックします。
削除するワークツリーを右クリックし、[ 削除...] をクリックします。
確認ダイアログで、[ 削除] をクリックします。

必要に応じて、[ このメッセージを再度表示しない ] を選択して、今後この確認をスキップします。設定で確認を再度有効にすることができます。ワークツリーを削除するためのプロンプトの構成を参照してください。

削除が失敗した場合 (たとえば、ワークツリーにコミットされていない変更が含まれているため)、 GitHub Desktop は、ワークツリーを強制的に削除するためのエラーダイアログオファリングを表示します。取り消すと、 GitHub Desktop は最初に作業していたワークツリーに戻ります。