私のような積極的なGitユーザーであれば、おそらく古いブランチが山積みになっていることでしょう。マージ済みのもの、放置されたもの、作成したことさえ覚えていないものもあるかもしれません。これらのブランチを保持しておくことはさほど大きな問題には思えませんが、時間の経過と共にリポジトリを雑然とさせ、アクティブな作業を追跡するのが難しくなります。
このガイドでは、Gitブランチをローカルおよびリモートで削除する方法について説明し、それを行う最も安全な方法や注意すべきポイントについてカバーします。
Gitブランチを削除すると何が起こるのか？
Gitブランチは設計上一時的なものです。これにより、新機能、バグ修正、実験を行うスペースが与えられ、メインのコードベースに干渉することなく作業できます。しかし、ブランチが目的を果たしたら、そのまま保持することは不要な雑然とした状態を招くだけです。ブランチを削除することは、Gitワークフローをきれいで管理しやすく保つための良い掃除だと考えています。
「削除」は作業を「消去」することと同じではないことを強調したいと思います。Gitでブランチを削除すると、コミット自体を消去するのではなく、それらへの参照を削除することになります。動作の仕組みは次の通りです:
- ローカルブランチを削除すると、そのブランチが個人のリポジトリから削除されます。他のブランチやタグがそれらのコミットを参照していない場合、Gitのガベージコレクションによって最終的にクリーンアップされる可能性があります。
- リモートブランチを削除すると、共有リポジトリ（例：GitHub、GitLab、Bitbucket）からそのブランチが削除され、コラボレーターがアクセスできなくなります。ただし、他のマシンにあるそのブランチのローカルコピーは、手動で削除または更新されるまで残ります。
なぜブランチを削除するのか？
ブランチを削除することは、シンプルに言えば整理整頓です。重複した写真、古いダウンロード、不要なフォルダーを削除するのが良い習慣であるのと同じように、使用が終わったブランチを削除するにはいくつかの良い理由があります：
- リポジトリを清潔に保ちます。 特に古いブランチが多すぎると、アクティブな作業を追跡するのが難しくなります。
- 混乱を防ぎます。 もはや関連がないブランチを保持すると、それがまだ使用されているかどうかについての不確実性を引き起こす可能性があります。
- 協力を促進します。 チーム環境では、完了した機能ブランチを削除することで、作業が完了したことを示し、古いコードに不必要な作業をさせるのを防ぎます。
- リモートリポジトリの膨れを減らします。リモートリポジトリは古いブランチでごちゃごちゃしてしまい、プロジェクトの履歴をたどるのが難しくなります。
Gitが初めての方やブランチを管理する前に設定が必要な方は、ステップバイステップの手順に従って、Gitインストールチュートリアルをご覧ください。
ローカルGitブランチの削除
ローカルブランチを削除するのは難しくありません。幸い、それはより簡単なGitのタスクの1つです。安全な方法と注意点について見ていきましょう。
ローカルブランチを削除する基本的なコマンド
ローカルブランチを削除する最も安全な方法は、-dフラグを使用することです。
git branch -d <branch_name>
このコマンドは、ブランチが現在のブランチ（通常はmainまたはmaster）に完全にマージされている場合にのみ機能することに注意してください。未マージの変更がある場合、Gitは誤ったデータの損失を防ぐために停止します。
ローカルブランチを強制的に削除する
まだマージされていない変更があるブランチを削除しようとすると、Gitはそれを強制しない限り許可しません:
git branch -D <branch_name>
-Dフラグ（大文字に注意）は安全チェックをスキップして即座にブランチを削除し、マージされているかどうかに関係なく削除します。これには注意してください。未マージの作業は、バックアップがあるか、同じコミットを指す別のブランチがある場合を除いて失われます。
削除前に未マージの変更を確認する
ブランチを削除する前に、そのブランチに未マージの変更があるかどうかを確認するのは良い考えです。次のように行うことができます:
git branch --no-merged
上記のコマンドは、現在のブランチにマージされていないすべてのブランチをリストアップします。削除しようとしているブランチがこのリストに表示される場合は、続行する前にその変更が必要かどうかを再確認してください。
Gitコマンドのクイックリファレンス、ブランチの削除を含むものをお探しですか？便利な Git チートシートをダウンロードしてください。
リモートGitブランチの削除
リモートブランチを削除するのは、ローカルのものとは少し異なります。リモートブランチは共有リポジトリに存在するため、それらを削除することで組織を維持し、古いブランチがチームのワークフローを混乱させるのを防ぎます。
リモートブランチを削除する基本コマンド
GitHub、GitLab、またはBitbucketなどのリモートリポジトリからブランチを削除するには、次のコマンドを使用してください:
git push origin --delete <branch_name>
このコマンドはリモートリポジトリからブランチの参照を削除し、他の人がアクセスできなくします。ただし、他のマシンにあるブランチのローカルコピーには影響しないため、それらは別途クリーンアップする必要があります。
リモートブランチ削除の確認
リモートブランチを削除した後、実際に削除されたことを確認する必要があります。まず、リモートリポジトリから最新の更新を取得します：
git fetch --prune
これにより、古くなったリモートトラッキング参照が削除されます。ブランチがもうリストに表示されていないことを再確認するために、次のコマンドを実行します：
git branch -r
上記のコマンドは、残っているリモートブランチをすべて表示します。削除したブランチがまだ表示される場合は、別の git fetch --prune を実行するか、削除コマンドが正しいリモートで実行されたことを確認してください。
Gitブランチ削除のベストプラクティス
ブランチを削除することは、Gitを使う上での日常的な作業ですが、適切な方法で行うことで不要な問題を回避できます。リポジトリを整理し、潜在的なミスを避けるためのベストプラクティスをご紹介します。
未マージのブランチを早めに削除しないように注意してください。
ブランチを削除する前に、まだ必要な未マージの作業が含まれていないか確認してください。不明な場合は、次のコマンドで状態を確認できます：
git branch --no-merged
マージされていない貴重な変更が含まれている場合は、すぐに削除する代わりに、まずマージまたはアーカイブ化を検討してください。
マージ後に削除する
機能や修正がメインブランチ（mainまたはmaster）にマージされたら、古いブランチを保持する理由はありません。マージされたブランチを削除することで、ごちゃごちゃを防ぎ、まだアクティブなブランチがどれかが見やすくなります。
チームとのコミュニケーション
協力プロジェクトで作業をしているときは、チームに警告せずにブランチを削除しないようにするのがプロフェッショナルな常識です。これは混乱を引き起こすか、さらには他の誰かの作業を妨害する可能性があります。リモートブランチを削除する前に、チームと確認して、誰もそれをまだ使用していないことを確認してください。私は、イライラを防ぐためにシンプルなSlackメッセージやノートを好んで使います。
ブランチを削除する前に、コミット履歴を整理してコミットをスカッシュすることを検討してみてください。当社のGit Squash Commits チュートリアルで学んでください。
Gitブランチを削除する際の一般的な問題
Gitでブランチを削除することは通常問題ありませんが、いくつかの一般的な落とし穴があります。何に注意すべきか、そしてこれらの問題が発生した場合にどのように対処すべきかを以下に示します。
完全にマージされていないブランチを削除
再度、マージされていない変更があるブランチを git branch -d を使用して削除しようとすると、Gitはデータ損失の可能性を防ぐためにあなたを止めます。これはフェイルセーフです。-D を使って強制的に削除すると、マージされていない作業は失われます。
すでにブランチを削除してしまい、再度必要だと気づいた場合、Gitの reflog を使用して復元できるかもしれません：
git reflog git checkout -b <branch_name> <commit_hash>
これにより、ブランチが完全にガーベッジコレクションに失われていない限り、最後に知られているコミットからブランチを復元できます。
現在のブランチの削除
Gitは、現在いるブランチを削除することを許可しません。そうでなければ、アクティブなブランチがなくなってしまいます。ブランチを削除しようとしたときにエラーが表示された場合は、まず別のブランチに切り替えてください：
git checkout main
または、Git 2.23+を使用している場合：
git switch main
別のブランチに移動したら、削除する意図のあるブランチを安全に削除できます。
削除する前にブランチを切り替える必要がありますか？ Gitでリモートブランチをチェックアウトする方法に関するガイドは、このプロセスを案内します。
リモートブランチを間違って削除した
リモートブランチを間違って削除した場合、（ローカルコピーがまだあると仮定して）それを再度リモートにプッシュすることで復元できます：
git push origin <deleted_branch_name>
これにより、リモートリポジトリでブランチが再作成され、共同作業者のアクセス権が復元されます。ローカルコピーが存在しない場合は、手動でコミット履歴をチェックしてブランチを再作成する必要があります。
なぜGitブランチを削除できないのですか？
Gitでブランチを削除するのに問題がある場合は、一般的な問題を再確認してください。ブランチが完全にマージされているか、現在そのブランチにいるか、リモートブランチであるかを確認してください。ここからは、設定や権限の問題かもしれません。
- 最初に確認するべきことは、現在そのブランチにいるかどうかです。Gitは、作業中のブランチを削除することを許可しないため、まず別のブランチに切り替える必要があります。
- それが問題でない場合、ブランチに未マージの変更が残っている可能性があります。Gitは未マージの作業があるブランチを保護するため、変更が必要ないと絶対に確信が持てない限り、ブランチをマージするか、
git branch -D branch-nameを使用して強制削除する必要があります。 - リモートブランチを削除しようとしている場合、単純に
git branch -dではうまくいきません。代わりに、git push origin --delete branch-nameを実行する必要があります。また、古い参照をクリーンアップするには、git fetch --pruneを使用できます。 - 特にGitHubやGitLabのようなプラットフォームでホストされているリポジトリには、設定を変更しない限り削除できない保護されたブランチがあります。共有リポジトリで作業している場合、ブランチを削除するための適切な権限が必要な場合もあります。
それでも詰まっていますか？git branch -vを実行すると、ブランチの状態に関する詳細情報が得られ、再試行する前に何が起こっているのかを理解するのに役立ちます。
Gitによるブランチクリーンアップの自動化
私は自動化が好きです。ブランチを手動で削除することもできますが、それを行う方法を理解しておくべきです。もう一つの方法もあります。多くのブランチを扱う場合（チーム設定など）、自動化は時間を節約し、整理を保つことができます。Gitには、手間をかけずに整理を行うためのいくつかの方法があります。
リモートブランチの自動クリーンアップ
リモートブランチが削除されると、ローカルGitは手動で更新するまでそれに対する参照を保持し続けます。一つ一つをきれいにする代わりに、次のコマンドを使用できます：
git fetch --prune
上記のコマンドは、存在しないブランチへのローカル参照を自動的に削除し、すべてを同期させます。定期的に実行することで、古くなったブランチがローカルリポジトリに溜まるのを防ぎます。
クリーンアップのためにGitフックを使用
チームや大規模なプロジェクト向けに、Gitフックを使用してブランチのクリーンアップを自動化することができます。フックは、Gitワークフローの特定のポイントで実行されるカスタムスクリプトであり、例えばブランチをマージした後などに実行されます。ポストマージフックを設定して、一定期間経過後にマージされたブランチを自動的に削除するようにすることで、古いブランチが不必要に残らないようにします。
結論
時間の経過とともにブランチは乱雑になりますが、「整理」を少し行うことでリポジトリを清潔に保ち、ワークフローを効率的に保つことができます。マージされたブランチを削除する習慣を身につけたり、未マージのブランチをダブルチェックしたり、チームプロジェクトでコミュニケーションを維持することで、これらの問題を回避することができます。さらに一歩進んで、git fetch --pruneやGitフックなどの自動化ツールを使うことで、追加の手間をかけることなくリポジトリを清潔に保つことができます。
ブランチの削除は、Gitをマスターするための一歩に過ぎません。バージョン管理の理解を深めるためには、Gitの中級コースをチェックしてください。GitHubリポジトリで作業している場合、GitHubの基本的な概念をしっかりと理解することが重要です。詳細はGitHubコンセプト入門コースで学んでください！