Git ブランチの管理

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

1. ブランチポップアップで、新規ブランチを選択するか、Git ツールウィンドウのブランチペインで現在のブランチを右クリックして、「ブランチ名」からの新しいブランチを選択します。

2. 表示されたダイアログでブランチ名を指定し、そのブランチに切り替える場合はブランチをチェックアウトするオプションが選択されていることを確認してください。

   新しいブランチの名前を入力し始めると、PyCharm は既存のローカルブランチの名前に基づいて関連する接頭辞を提案します。

   新しいブランチは、現在のブランチ HEAD から始まります。

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

1. ブランチポップアップまたは Git ツールウィンドウのブランチペインで、新しいブランチを開始するローカルまたはリモートブランチを選択し、選択からの新しいブランチを選択します。

2. 表示されたダイアログでブランチ名を指定し、そのブランチに切り替える場合はブランチをチェックアウトするオプションが選択されていることを確認してください。

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

1. ログビューで、新しいブランチの開始点として機能するコミットを選択し、コンテキストメニューから新規ブランチを選択します。

2. 表示されたダイアログでブランチ名を指定し、そのブランチに切り替える場合はブランチをチェックアウトするオプションが選択されていることを確認してください。

1. ブランチポップアップまたは Git ツールウィンドウのブランチペインで、名前を変更するブランチを選択し、名前変更を選択します。

2. 開いたダイアログで、ブランチ名を必要な名前に変更します。

ブランチがたくさんある場合は、お気に入りのものだけを表示することをお勧めします。メインのブランチは、デフォルトでお気に入りとしてマークされています。お気に入りのブランチは、常にブランチポップアップの上部と Git ツールウィンドウのブランチペインに表示されます。

• ブランチをお気に入りとしてマークするには、ブランチポップアップでブランチ名の上にマウスを置き、左側に表示される星の輪郭をクリックします。

  

  または、お気に入りとしてマークするブランチを選択し、Space を押します。

  Git ツールウィンドウのブランチペインでブランチを選択して、ツールバーの をクリックすることもできます。

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

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

2. アクションのリストからチェックアウトを選択します。

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

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

• コミットが失われず、ローカルブランチがすでにリモートを追跡している場合、PyCharm はローカルブランチを リモートブランチに自動的にリセットしてからチェックアウトします。

• ローカルブランチに、リセットのために失われる可能性のあるコミットが含まれている場合、PyCharm は次のことを提案します。

  • ローカルコミットのドロップ : PyCharm は、ローカルコミットをドロップし、ローカルブランチをリセットし、追跡を変更します。

  • リモートへのリベース : PyCharm は、ローカルブランチを リモートブランチにリベースし、ローカルコミットを保持し、ローカルブランチをリセットし、追跡を変更します。

ブランチを切り替える

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

1. ブランチポップアップまたは Git ツールウィンドウのブランチペインで、ローカルブランチに切り替えるブランチを選択し、使用可能な操作のリストからチェックアウトを選択します。

   マルチリポジトリプロジェクトの場合、ブランチはリポジトリごとに自動的にグループ化されます。必要なブランチをチェックアウトするには、ブランチポップアップで、最初にリポジトリを選択します。

2. 次に起こることは、まだコミットしていないローカルの変更と、チェックアウトしようとしているブランチとの間に矛盾があるかどうかによって異なります。

   • 作業ツリーがクリーンである (つまり、コミットされていない変更がない) 場合、またはローカルの変更が指定されたブランチと競合しない場合、このブランチはチェックアウトされます (PyCharm ウィンドウの右下隅に通知がポップアップ表示されます)。

   • ローカルの変更がチェックアウトによって上書きされる場合、PyCharm は、選択されたブランチをチェックアウトできないファイルのリストを表示し、強制チェックアウトとスマートチェックアウトの選択を提案します。

     強制チェックアウトをクリックすると、コミットされていないローカルの変更が上書きされ、失われます。

     スマートチェックアウトをクリックすると、PyCharm はコミットされていない変更をシェルブし、選択したブランチをチェックアウトして、変更をアンシェルブします。アンシェルブ操作中に競合が発生した場合は、変更をマージするように求められます。詳細については、「競合の解決」を参照してください。

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

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

1. ブランチポップアップまたは Git ツールウィンドウのブランチペインから、現在のブランチと比較するブランチを選択し、現在のブランチと比較を選択します。

   新しいタブが Git ツールウィンドウに追加され、選択したブランチに存在し、現在のブランチには存在しないすべてのコミットが一覧表示されます。

   ブランチを入れ替えリンクをクリックして、他のブランチと比較するベースと見なされるブランチを変更できます。

2. 2 つのブランチで異なるすべてのファイルのリストを表示するには、Ctrl+A を押します。変更されたファイルペインは、相違点を含むすべてのファイルをリストします。

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

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

• ブランチポップアップまたは Git ツールウィンドウのブランチペインから、ローカルの作業ツリーと比較するブランチを選択し、作業ツリーとの差分を表示を選択します。

  開いた変更ツールウィンドウには、現在チェックアウトされているブランチと比較して、選択したブランチで異なるすべてのファイルのリストが表示されます。

  • 選択したブランチに存在し、現在のブランチにないファイルは、灰色でマークされます。

  • 現在のブランチに存在するが、選択したブランチにないファイルは、緑色でマークされます。

  • 選択したブランチと現在のブランチの違いを含むファイルは、青色でマークされています。

  ブランチを入れ替えリンクをクリックして、他のブランチと比較するベースと見なされるブランチを変更できます。

  • 特定のファイル内の違いを確認するには、ファイルを選択してツールバーの をクリックするか、Ctrl+D を押します。

  • ファイルの内容全体を現在のブランチに適用するには、 をクリックします。詳細については、個別のファイルを適用するを参照してください。

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

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

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

1. Git ツールウィンドウ Alt+9 を開きます。

2. コミットペインで、ブランチ | 選択に移動します。

   

3. 比較するブランチを次のように指定します: branch1..branch2 は、branch1 に含まれていない branch2 のすべてのコミットを一覧表示します。

4. Ctrl+Enter を押します。

   この例では、リストにはブランチ feature1 に含まれ、ブランチ main に含まれないコミットが含まれています。

   

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

1. 今後の作業に使用するブランチを確認してください。

2. ブランチポップアップまたは Git ツールウィンドウのブランチペインで、削除するブランチを右クリックし、削除を選択します。

ブランチを削除すると、削除されたブランチを元に戻すことができる通知が右下隅に表示されます。

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

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

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

1. Ctrl+Alt+S を押して設定を開き、バージョン管理 | Git を選択します。

2. すべてのルートに対してブランチ操作を実行するオプションを選択します（このオプションは、プロジェクトに複数のルートがある場合にのみ使用できることに注意してください）。

少なくとも 1 つのリポジトリで操作が失敗した場合、PyCharm は、成功したリポジトリでこの操作をロールバックすることを提案することで、ブランチの分岐を防ぎます。