はじめに
GitHub 上でブランチを削除したのに、git branch をすると ローカルにまだブランチが残っているという経験はありませんか？
この記事では、その理由と根本的な解決方法を Mermaid でわかりやすく説明します。
1. 現象の例
GitHub 上で次のブランチを削除したとします。
feature/xx
feature/yy
feature/zz
しかしローカルではまだ残っています。
$ git branch
feature/xx
feature/yy
feature/zz
* main
2. 図解：Git のブランチは 2 種類ある
Git には以下の 2 種類のブランチがあります。
| 種類 | 例 | 説明 |
|---|---|---|
| ローカルブランチ | feature/foo |
あなたの PC に実体として存在 |
| リモート追跡ブランチ | origin/feature/foo |
GitHub の状態を記録したキャッシュ |
ローカル・origin・GitHub の関係
3. git fetch --prune で不要な追跡ブランチを削除
GitHub で削除されたブランチは、以下でローカルの追跡ブランチを消せます。
$ git fetch --prune
From github.com:xxxx/xxxx
- [deleted] (none) -> origin/feature/xx
- [deleted] (none) -> origin/feature/yy
- [deleted] (none) -> origin/feature/zz
prune の図解
4. それでもローカルに残る理由
理由はとてもシンプルで、
git fetch --pruneはorigin/xxxしか消さず、ローカルブランチfeature/xxxは消さない
からです。
Mermaid 図
5. 解決方法：ローカルブランチを削除する
不要なブランチは手動で削除します。
$ git branch -d feature/xx
$ git branch -d feature/yy
$ git branch -d feature/zz
未マージでどうしても消したい場合は強制削除：
$ git branch -D feature/ww
6. 自動 prune を有効にする（おすすめ）
$ git config --global fetch.prune true
これで今後、git fetch や git pull のたびに自動で不要な追跡ブランチが整理されます。
7. 全体の流れ
まとめ
| 状況 | 原因 | 解決 |
|---|---|---|
| リモートで削除したのに残る | ローカルブランチが残っている | git branch -d |
origin/xxx が残る |
prune をしていない | git fetch --prune |
| 今後自動で prune したい | 設定がオフ | git config --global fetch.prune true |
Git は便利ですが、ブランチ管理は慣れるまで混乱しがちです。
この記事が理解の助けになれば幸いです。