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

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/ja-jp/help/clion/llms.txt).

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

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

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

* AI を活用した開発: ローカルに保存されていない変更が上書きされないように、AI エージェントを別のワークツリーで実行します。

* 緊急バグ修正: 現在の作業を中断することなく、別のディレクトリで重大な問題を解決します。

* 並行コードレビュー: 既存の環境、データベースの状態、ビルドアーティファクトに影響を与えることなく、プルリクエストとマージリクエストをローカルでチェックアウトおよびテストできます。

* 長時間実行されるタスク: 1 つのワークツリーで大規模なテストスイートや複雑なビルドを実行しながら、別のワークツリーでコードの記述を続けます。

* マルチブランチコンテキスト切り替え: スタッシュの変更や、ブランチ切り替え後の大量のファイルの再インデックスを待つことなく、複数の長時間実行されるブランチを管理します。

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

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

![メインワークツリー内の Git フォルダーと、リンクされたワークツリー内の Git ファイル](https://resources.jetbrains.com/help/img/idea/2026.3/linked_worktree.png)

Git ワークツリーの詳細については、 [公式の Git ドキュメント(英語)](https://git-scm.com/docs/git-worktree)を参照してください。

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

> **Note:**
> CLion は現在、単一のリポジトリを含むプロジェクトに対して Git ワークツリーをサポートしています。

プロジェクトにすでに複数の Git ワークツリーが存在する場合、   ワークツリー   タブはデフォルトで表示されます。 そうでない場合は、 ![Down ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.chevronDownLarge.svg) をクリックして   ワークツリー   を選択することで、   Git   ツールウィンドウ `Alt+9` (Windows), `⌘ 9` (macOS), `⌘ 9` (IntelliJ IDEA Classic (macOS)), `⌘ 9` (macOS System Shortcuts), `Alt+9` (XWin), `Alt+9` (GNOME), `Alt+9` (KDE), `Alt+9` (Emacs), `Alt+9` (Sublime Text), `⌘ 9` (Sublime Text (macOS)), `⌘ 2` (Xcode), `Alt+9` (Visual Studio), `⌘ 9` (Visual Studio (macOS)), `Alt+9` (ReSharper), `⌘ 9` (ReSharper (macOS)), `Alt+9` (QtCreator), `⌘ 9` (QtCreator (macOS)), `Alt+9` (NetBeans), `Alt+9` (Eclipse), `⌘ 9` (Eclipse (macOS)) 内で開くことができます。

![ワークツリータブを開くオプション付きの Git ツールウィンドウ](https://resources.jetbrains.com/help/img/idea/2026.3/open_worktrees_tab.png)

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

1. Git   ツールウィンドウ `Alt+9` (Windows), `⌘ 9` (macOS), `⌘ 9` (IntelliJ IDEA Classic (macOS)), `⌘ 9` (macOS System Shortcuts), `Alt+9` (XWin), `Alt+9` (GNOME), `Alt+9` (KDE), `Alt+9` (Emacs), `Alt+9` (Sublime Text), `⌘ 9` (Sublime Text (macOS)), `⌘ 2` (Xcode), `Alt+9` (Visual Studio), `⌘ 9` (Visual Studio (macOS)), `Alt+9` (ReSharper), `⌘ 9` (ReSharper (macOS)), `Alt+9` (QtCreator), `⌘ 9` (QtCreator (macOS)), `Alt+9` (NetBeans), `Alt+9` (Eclipse), `⌘ 9` (Eclipse (macOS)) で、   ワークツリー   タブを開き、 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)   新しいワークツリー   をクリックします。

あるいは、メインメニューで  `Git | 新しいワークツリー`  を選択します。

これにより、   新しいワークツリー   ダイアログが開きます。

![新しいワークツリーダイアログ](https://resources.jetbrains.com/help/img/idea/2026.3/new_worktree.png)

2. 新しいワークツリー   ダイアログで、以下を指定します。

* ブランチより : ソースブランチを選択してください。 同じブランチを 2 つのワークツリーで同時にチェックアウトすることはできませんのでご注意ください。 現在チェックアウトされているブランチを新しいワークツリーのソースとして使用したい場合は、そこから別のローカルブランチを作成し、新しいワークツリーで使用できます。 そのためには、 新規ブランチ オプションを選択してください。 > **Note:** > 選択されたソースブランチが リモートの場合、 新規ブランチ オプションを選択して既存のローカルブランチと一致しない新しい名前を指定しない限り、同じ名前のローカルブランチが作成されます。

* プロジェクト名 : 新しいワークツリーの名前。

* ロケーション : ワークツリーが保存されるディレクトリ。 ワークツリーの入れ子は避けてください。現在のプロジェクトのディレクトリ内にワークツリーを作成することは推奨されません（例： `Projects/mainProject/linkedWorktree` ）。 現在、CLion はこのようなプロジェクトをマルチルートプロジェクトとして誤認し、ワークツリーの統合が機能しなくなります。

新しいワークツリーを作成すると、CLion はそれを別のプロジェクトとして開きます。

Procedure: 異なるワークツリーを切り替える

ワークツリーは一度開くと、他のプロジェクトと同様に動作します。 メインメニューの「   最近のプロジェクト   」またはウィンドウヘッダーのツールバーにあるプロジェクトウィジェットからアクセスできます。

CLion 以外で作成されたものも含め、ワークツリーに切り替えるには次の手順を実行してください：

1. Git   ツールウィンドウ `Alt+9` (Windows), `⌘ 9` (macOS), `⌘ 9` (IntelliJ IDEA Classic (macOS)), `⌘ 9` (macOS System Shortcuts), `Alt+9` (XWin), `Alt+9` (GNOME), `Alt+9` (KDE), `Alt+9` (Emacs), `Alt+9` (Sublime Text), `⌘ 9` (Sublime Text (macOS)), `⌘ 2` (Xcode), `Alt+9` (Visual Studio), `⌘ 9` (Visual Studio (macOS)), `Alt+9` (ReSharper), `⌘ 9` (ReSharper (macOS)), `Alt+9` (QtCreator), `⌘ 9` (QtCreator (macOS)), `Alt+9` (NetBeans), `Alt+9` (Eclipse), `⌘ 9` (Eclipse (macOS)) で、   ワークツリー   タブを開きます。

あるいは、メインメニューで  `Git | ワークツリー`  を選択します。

2. 対象のワークツリーをダブルクリックします。

![Git ツールウィンドウの「ワークツリー」タブには、複数のワークツリーが表示されています。](https://resources.jetbrains.com/help/img/idea/2026.3/several_worktrees.png)

ワークツリーは、システム設定に応じて、新規ウィンドウまたは既存のウィンドウで開きます。

デフォルトでは、   ワークツリー   タブはアクティブなワークツリーのステータスを表示しません。 ステータスインジケーターは、ワークツリーが特定の状態になるとリストに表示されます：

* ロック済み ：ワークツリーが外部でロックされており、移動、 [削除](#delete-a-worktree)、または [クリーンアップ](#prune-worktrees)されないようになっています。

* クリーンアップ可能 ：ワークツリーディレクトリがファイルシステムから手動で削除されました。 これらのレコードはリポジトリをクリーンアップするために安全に [クリーンアップ](#prune-worktrees)できます。

> **Tip:**
> ワークツリーは、VCS ウィジェットや   ログ   タブの   Git   ツールウィンドウからも開くことができます。ワークツリーで現在チェックアウトされているブランチを選択し、右クリックして   Worktree を開く   を選択してください。

Procedure: ワークツリーを削除する

ワークツリーを削除する前に、すべての変更がコミットされていることを確認してください。

1. Git   ツールウィンドウ `Alt+9` (Windows), `⌘ 9` (macOS), `⌘ 9` (IntelliJ IDEA Classic (macOS)), `⌘ 9` (macOS System Shortcuts), `Alt+9` (XWin), `Alt+9` (GNOME), `Alt+9` (KDE), `Alt+9` (Emacs), `Alt+9` (Sublime Text), `⌘ 9` (Sublime Text (macOS)), `⌘ 2` (Xcode), `Alt+9` (Visual Studio), `⌘ 9` (Visual Studio (macOS)), `Alt+9` (ReSharper), `⌘ 9` (ReSharper (macOS)), `Alt+9` (QtCreator), `⌘ 9` (QtCreator (macOS)), `Alt+9` (NetBeans), `Alt+9` (Eclipse), `⌘ 9` (Eclipse (macOS)) で、   ワークツリー   タブを開きます。

あるいは、メインメニューで  `Git | ワークツリー`  を選択します。

2. ワークツリーを選択し、 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.delete.svg)   削除   をクリックします。

> **Note:**
> メインのワークツリーや現在開いているワークツリーは削除できません。

Procedure: ワークツリーをクリーンアップ

IDE で [ワークツリーを削除](#delete-a-worktree)せずにワークツリーディレクトリを手動で削除すると、Git はファイルが存在しないことを検出し、そのワークツリーを   クリーンアップ可能  としてマークします。 クリーンアップを行うと、存在しなくなったワークツリーの内部 Git レコードが削除され、それに関連付けられたブランチが解放されます。

1. Git   ツールウィンドウ `Alt+9` (Windows), `⌘ 9` (macOS), `⌘ 9` (IntelliJ IDEA Classic (macOS)), `⌘ 9` (macOS System Shortcuts), `Alt+9` (XWin), `Alt+9` (GNOME), `Alt+9` (KDE), `Alt+9` (Emacs), `Alt+9` (Sublime Text), `⌘ 9` (Sublime Text (macOS)), `⌘ 2` (Xcode), `Alt+9` (Visual Studio), `⌘ 9` (Visual Studio (macOS)), `Alt+9` (ReSharper), `⌘ 9` (ReSharper (macOS)), `Alt+9` (QtCreator), `⌘ 9` (QtCreator (macOS)), `Alt+9` (NetBeans), `Alt+9` (Eclipse), `⌘ 9` (Eclipse (macOS)) で、   ワークツリー   タブを開きます。

あるいは、メインメニューで  `Git | ワークツリー`  を選択します。

2. ![](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.actions.clearCash.svg)   クリーンアップ   をクリックします。

> **Note:**
> このアクションは、現在の選択に関わらずクリーンアップ可能なすべてのワークツリーを一度にクリアします。

## トラブルシューティング

CLion は別々のワークツリーを同じプロジェクトとして扱う
: `.idea/workspace.xml`  ファイルがリポジトリにコミットされた場合に発生する可能性があります。 このファイルには一意の  `ProjectId` が含まれているため、新しい Git ワークツリーを作成すると、その ID が重複します。 その結果、IDE は同じ ID を持つことによって混乱し、両方のディレクトリを単一プロジェクトとして誤認します。
:
:
:
: 解決方法：
:
:
:
: 1.  CLion でプロジェクトを閉じます。
:
: 2.  Git ワークツリーディレクトリに移動し、  `workspace.xml`  ファイルを削除します（あるいはファイルを開いて  `ProjectId`  行のみ削除することもできます）。
:
: 3.  IDE でプロジェクトを再度開いて、新しい一意の ID を生成するようにしてください。
:
:
:
: 再発を防ぐため、  `.idea/workspace.xml`  がリポジトリの  `.gitignore`  ファイルに追加されていることを確認してください。

