Git ブランチの管理

Git では、ブランチは、たとえば機能の作業が必要な場合や、リリースのためにコードベースの特定の状態を固定する必要がある場合などに、メインの開発ラインから分岐できるようにする強力なメカニズムです。

Gitサポートツールウィンドウのブランチペインで、ブランチを管理したり、複数のブランチに対してバッチ操作を実行したりできます。

新規ブランチの作成

現在のブランチから新しいブランチを作成する

VCS ウィジェットで新規ブランチを選択するか、 Gitサポートツールウィンドウのブランチペインで現在のブランチを右クリックして「ブランチ名」からの新しいブランチを選択します。
表示されたダイアログでブランチ名を指定し、そのブランチに切り替える場合はブランチをチェックアウトするオプションが選択されていることを確認してください。
新しいブランチの名前を入力し始めると、PyCharm は既存のローカルブランチの名前に基づいて関連する接頭辞を提案します。
新しいブランチは、現在のブランチ HEAD から始まります。

選択したブランチから新しいブランチを作成する

VCS ウィジェットまたは Gitサポートツールウィンドウのブランチペインで、新しいブランチを開始するローカルまたはリモートブランチを選択し、選択からの新しいブランチを選択します。
表示されたダイアログでブランチ名を指定し、そのブランチに切り替える場合はブランチをチェックアウトするオプションが選択されていることを確認してください。

選択したコミットから新しいブランチを作成する

ログビューで、新しいブランチの開始点として機能するコミットを選択し、コンテキストメニューから新規ブランチを選択します。
表示されたダイアログでブランチ名を指定し、そのブランチに切り替える場合はブランチをチェックアウトするオプションが選択されていることを確認してください。

ブランチの名前を変更する

VCS ウィジェットまたは Gitサポートツールウィンドウのブランチペインで、名前を変更するブランチを選択し、コンテキストメニューから名前を変更を選択します。
開いたダイアログで、ブランチ名を必要な名前に変更します。
この操作はローカルのブランチの名前のみを変更することに注意してください。ローカルのブランチとリモートで追跡されているブランチの両方に同じ新しい名前を付けたい場合は、新しいリモート（ブランチ）を作成し、代わりに追跡を開始する必要があります。
変更されていない古い名前を持つ現在のリモートブランチの追跡を停止するには、同じブランチの名前変更ダイアログで上流ブランチの設定を解除オプションを選択します。
次回変更をプッシュすると、新しいリモートブランチが自動的に作成され、追跡されます。
変更をプッシュした後、古い名前の古いリモートブランチを削除できます。

ブランチをお気に入りとしてマーク

ブランチが多数ある場合は、お気に入りのブランチだけを表示したい場合があります。メインのブランチはデフォルトでお気に入りとしてマークされています。お気に入りのブランチは、VCS ウィジェットの上部と Gitサポートツールウィンドウのブランチペインに常に表示されます。

ブランチをお気に入りとしてマークするには、VCS ウィジェットでブランチの名前にカーソルを合わせ、左側に表示される星の枠をクリックします。
または、お気に入りとしてマークするブランチを選択し、 Space を押します。
Gitサポートツールウィンドウのブランチペインでブランチを選択して、ツールバーのをクリックすることもできます。

グループブランチ

VCS ウィジェットでは、PyCharm がブランチとタグを 4 つのノードに保持します。

最近のブランチノードには、最近チェックアウトされたブランチが最大 5 つ表示されます。
ローカルブランチノードには、すべてのローカルブランチがリストされます。
リモートブランチノードには、最新のフェッチ後に使用可能なすべてのリモートブランチが表示されます。
タグノードには、チェックアウト、作業ツリーとの比較、マージ、プッシュ、削除できるすべての利用可能なタグがリストされます。

また、PyCharm はブランチを接頭辞ごとに自動的にグループ化し、展開可能なリストに保存します。

ブランチをグループ化するには、ブランチ名の接頭辞をスラッシュ / で区切る必要があります。例： jd/2023.1。

ブランチを接頭辞でグループ化するのを停止するか、最近またはタグノードを非表示にするには、VCS ウィジェットの右上隅にある設定をクリックし、接頭辞でグループ化、最近のブランチを表示、タグを表示オプションの選択を解除します。

ブランチをチェックする (git-checkout)

他のユーザーが作成したブランチで作業したい場合は、それをチェックアウトしてローカルコピーを作成する必要があります。

リモートブランチの完全なリストを確認するには、VCS ウィジェットでをクリックしてください。

ブランチを新しいローカルブランチとしてチェックアウトする

VCSウィジェットまたは Gitサポートツールウィンドウのブランチペインで、リモートブランチからローカルにチェックアウトしたいブランチを選択します。プロジェクトに複数のルートがあり同期ブランチコントロールが有効な場合は共通リモートブランチから、無効な場合はリポジトリ | リモートブランチから選択します。
アクションのリストからチェックアウトを選択します。

新しいローカルブランチが作成され、チェックアウトされ、元のリモートブランチを追跡するように設定されます。

チェックアウトしたいリモートブランチと同じ名前のローカルブランチがすでにある場合があります。状況に応じて、チェックアウトプロセスを完了する方法は次のとおりです。

コミットが失われることがなく、ローカルブランチがすでにリモートをトラックしている場合、PyCharm は自動的にローカルブランチをリモートブランチにリセットし、その後チェックアウトします。
ローカルブランチにリセットによって失われる可能性のあるコミットが含まれている場合、PyCharm は次の操作を提案します：
- Drop Local Commits: PyCharm はローカルコミットをドロップし、ローカルブランチをリセットし、追跡を変更します。
- Rebase onto Remote: PyCharm はローカルブランチをリモートブランチにリベースし、ローカルコミットを保持し、ローカルブランチをリセットし、追跡を変更します。

ブランチを切り替える

マルチタスクを実行していると、関連のない変更をコミットするためにブランチ間を移動する必要がよくあります。

VCS ウィジェットまたは Gitサポートツールウィンドウのブランチペインで、ローカルブランチで切り替えたいブランチを選択し、使用可能な操作のリストからチェックアウトを選択します。
ブランチをリモートバージョンに自動的に同期させるには、チェックアウトと更新を選択してください。アップデートの仕組みについては、ブランチを更新するを参照してください。
複数のリポジトリを使用するプロジェクトの場合、ブランチはリポジトリごとに自動的にグループ化されます。必要なブランチをチェックアウトするには、VCS ウィジェットでまずリポジトリを選択してください。
次に何が起こるかは、まだコミットしていないローカルの変更と、チェックアウトしようとしているブランチに競合があるかどうかによって異なります：
- 作業ツリーがクリーン（つまりコミットされていない変更がない）場合、またはローカルの変更が指定されたブランチと競合しない場合、このブランチがチェックアウトされます（PyCharm ウィンドウの右下隅に通知がポップアップ表示されます）。
- ローカルの変更がチェックアウトによって上書きされる場合、PyCharm は選択したブランチをチェックアウトできないファイルのリストを表示し、強制チェックアウトとスマートチェックアウトの選択を提案します。
  強制チェックアウトをクリックすると、コミットされていないローカルの変更が上書きされ、失われます。
  スマートチェックアウトをクリックすると、PyCharm はコミットされていない変更をシェルブし、選択したブランチをチェックアウトし、その後変更をアンシェルブします。アンシェルブ操作中に競合が発生した場合は、変更をマージするように求められます。詳細については、「競合の解決」を参照してください。
  シェルブではなくスタッシュを使用して作業コピーをクリーンアップする場合は、バージョン管理 | Git 設定ページ Ctrl+Alt+S に移動し、作業ツリーをクリーンアップする設定のスタッシュを選択します。

ブランチの比較

ブランチを現在のブランチと比較する

ブランチが現在のブランチからどのように分岐しているか確認したい場合、比較できます。

VCS ウィジェットまたは Gitサポートツールウィンドウのブランチペインから、現在のブランチと比較するブランチを選択し、現在のブランチと比較を選択します。
新しいタブが Gitサポートツールウィンドウに追加され、選択したブランチに存在し、現在のブランチには存在しないすべてのコミットが一覧表示されます。
ブランチを入れ替えリンクをクリックして、他のブランチと比較するベースと見なされるブランチを変更できます。
2 つのブランチ間で異なるすべてのファイルを一覧表示するには、 Ctrl+A を押してください。変更されたファイルペインに差分があるすべてのファイルが表示されます。

ブランチと作業ツリーを比較する

ブランチを現在のブランチと比較する以外に、現在のブランチのローカル状態と比較することができます。これは、コミットされていない変更がローカルにある場合に役立ちます。

VCS ウィジェットまたは Gitサポートツールウィンドウのブランチペインから、ローカル作業ツリーと比較するブランチを選択し、作業ツリーとの差分を表示を選択します。
開いた変更ツールウィンドウには、現在チェックアウトされているブランチと比較して、選択したブランチで異なるすべてのファイルのリストが表示されます。
- 選択したブランチに存在し、現在のブランチには存在しないファイルは、灰色でマークされます。
- 現在のブランチに存在するが、選択したブランチにないファイルは、緑色でマークされます。
- 選択したブランチと現在のブランチの違いを含むファイルは、青色でマークされています。
ブランチを入れ替えリンクをクリックして、他のブランチと比較するベースと見なされるブランチを変更できます。
- 特定のファイル内の違いを確認するには、ファイルを選択してツールバーのをクリックするか、 Ctrl+D を押します。
- ファイルの内容全体を現在のブランチに適用するには、をクリックします。詳細については、個別のファイルを適用するを参照してください。

一方のブランチから他方のブランチに含まれていないすべてのコミットを一覧表示する

2 点範囲表記(英語)を使用すると、選択したブランチから、他のブランチに含まれていないすべてのコミットを一覧表示できます。

たとえば、誰かが機能ブランチに取り組んでいて、時々メインのブランチをこの機能ブランチにマージする場合に役立ちます。このフィルターを使用すると、機能ブランチのコミットのみをリストし、メインのブランチのコミットはリストしません。

Git ツールウィンドウ Alt+9 を開きます。
コミットペインで、ブランチ | 選択に移動します。
比較するブランチを次のように指定します: branch1..branch2 は、 branch1 に含まれていない branch2 のすべてのコミットを一覧表示します。
Ctrl+Enter を押す。
この例では、リストにはブランチ feature1 に含まれ、ブランチ main に含まれないコミットが含まれています。

このビデオを見て、変更をブランチと比較する方法をより良く理解してください：

ブランチを削除

機能ブランチからメイン開発ラインに変更を統合した後、不要になったブランチを削除できます。

今後の作業に使用するブランチを確認してください。
VCS ウィジェットまたは Gitサポートツールウィンドウのブランチペインで、削除するブランチを右クリックして削除を選択します。

ブランチを削除した後、削除したブランチを元に戻せる通知が右下隅に表示されます：

ブランチに、上流のブランチまたは現在のブランチにまだマージされていないコミットが含まれている場合でも、すぐに削除されます（git branch --D または git branch --delete --force コマンドと同等）が、通知には、マージされていないコミットを表示できるリンクも含まれます。

削除したブランチがリモートブランチを追跡していた場合、この通知にリモートブランチを削除するリンクも表示されます。

同期ブランチ制御を構成する

マルチルートリポジトリがある場合は、単一のリポジトリのようにすべてのルートでブランチ操作（チェックアウト、マージ、削除など）を同時に実行するように PyCharm を設定できます。

Ctrl+Alt+S を押して設定を開き、バージョン管理 | Git を選択します。
すべてのルートに対してブランチ操作を実行するオプションを選択します（このオプションは、プロジェクトに複数のルートがある場合にのみ使用できることに注意してください）。

いずれかのリポジトリで操作が失敗した場合、PyCharm は成功したリポジトリでこの操作のロールバックを提案し、ブランチの分岐を防ぎます。

2026 年 6 月 1 日