【Git】ブランチが削除できないときの原因と対処法完全ガイド｜12エラー診断・worktree/protected branch/タグ衝突・reflog復旧まで

Q1: そのブランチは今いる場所（current branch）？
   YES → Q2
   NO  → Q3

Q2: まず別のブランチへ切り替える
   git switch main
   → Q3へ

Q3: そのブランチは worktree で開かれている？
   YES → git worktree remove <path> で解除
   NO  → Q4へ

Q4: ローカル削除 or リモート削除？
   ローカル → Q5へ
   リモート → Q7へ

Q5: main/currentブランチにマージ済み？
   YES → git branch -d <name>
   NO  → Q6へ

Q6: 本当に不要？（コミット失う覚悟がある？）
   YES → git branch -D <name>（強制）
   NO  → まずマージ or cherry-pick で救出

Q7: リモート側はBranch protectionで保護されている？
   YES → Settings→Rules→Allow deletions を許可
   NO  → git push origin --delete <name>

$ git branch -d feature/login
error: Cannot delete branch 'feature/login' checked out at '/home/user/repo'

# 自分が対象ブランチにいる場合
git switch main           # 別ブランチへ移動
git branch -d feature/login

# worktree一覧を確認
git worktree list
# /home/user/repo              a1b2c3d [main]
# /home/user/repo-feature      d4e5f6c [feature/login]  ← これが原因

# 該当worktreeを削除（作業ファイルも消えるので注意）
git worktree remove /home/user/repo-feature

# その上でブランチ削除
git branch -d feature/login

$ git branch -d feature/experiment
error: The branch 'feature/experiment' is not fully merged.
If you are sure you want to delete it, run 'git branch -D feature/experiment'.

# 失われるコミットを一覧（空なら実は安全）
git log feature/experiment --not $(git for-each-ref --format="%(refname)" refs/heads/) --oneline

# もっとシンプルに：mainに対して未マージ分を見る
git log feature/experiment --not main --oneline

# 結果が空 → 安全に削除可（squash/rebase経由で取り込まれている）
git branch -D feature/experiment

# 結果あり → 本当に失ってよいか判断
#   必要なら cherry-pick で救出
git checkout main
git cherry-pick a1b2c3d
git branch -D feature/experiment

$ git branch -d feature/Login
error: branch 'feature/Login' not found.

# ローカルブランチ一覧（大小文字もそのまま）
git branch

# リモート含む全ブランチ
git branch -a

# パターン検索
git branch --list "feature/*"

# タブ補完で確実に
git branch -d feature/<Tab>

$ git push origin --delete feature/old
error: unable to delete 'feature/old': remote ref does not exist

# リモートに存在しないローカル参照を一括削除
git fetch --prune

# 以降、自動でpruneしたい場合
git config --global fetch.prune true

# タグもpruneしたい場合
git fetch --prune --prune-tags

$ git push origin --delete release/v1
remote: error: GH006: Protected branch update failed for refs/heads/release/v1.
remote: error: Cannot delete a protected branch
To github.com:org/repo.git
 ! [remote rejected] release/v1 (protected branch hook declined)

# Webでの設定変更
1. Repository Settings を開く
2. Branches or Rules を選択
3. 該当ルールの "Edit"
4. "Allow deletions" にチェック or ルールから該当パターンを外す
5. Save changes

# もしくはgh CLIで（Admin権限必須）
gh api -X DELETE repos/:owner/:repo/branches/release%2Fv1/protection

# 削除後にルールを戻すのを忘れずに（パターン/masterや/main/を再保護）

# GitLab Protected Branches
1. Settings → Repository → Protected branches
2. 該当ブランチで "Unprotect"
3. 削除 → 再設定

$ git push origin --delete main
remote: error: refusing to delete the current branch: refs/heads/main
To github.com:org/repo.git
 ! [remote rejected] main (deletion of the current branch prohibited)

# GitHub Web UI で変更
1. Settings → Branches
2. Default branch を main など別のブランチに変更
3. 警告を読んで確認
4. その後 git push origin --delete master

# 現在のdefault branch確認
gh repo view --json defaultBranchRef -q .defaultBranchRef.name

# 変更
gh repo edit --default-branch main

# 旧default branchを削除
git push origin --delete master

$ git branch -d v1.0
warning: refname 'v1.0' is ambiguous.
error: branch 'v1.0' not found.

# どちらが存在するか確認
git show-ref v1.0
# refs/heads/v1.0    ← ブランチ
# refs/tags/v1.0     ← タグ

# ブランチだけ削除するには refs/heads/ を使う
git update-ref -d refs/heads/v1.0

# タグだけ削除するなら
git tag -d v1.0

# 現在のsubmodule参照を確認
git config -f .gitmodules --get submodule.libs/utils.branch
# feature/old

# 参照ブランチを変更（例：main）
git config -f .gitmodules submodule.libs/utils.branch main
git submodule sync
git add .gitmodules
git commit -m "chore: bump submodule to main"

# その上でsubmodule側のブランチを削除
cd libs/utils
git push origin --delete feature/old
git branch -d feature/old

$ git init
$ git branch -d master
fatal: You are on a branch yet to be born

# 方法A：初回コミットを作って正規削除
git commit --allow-empty -m "Initial commit"
git switch -c main
git branch -D master

# 方法B：参照ファイルを直接削除（低レベル）
rm .git/refs/heads/master
# HEADファイルも確認
cat .git/HEAD
# ref: refs/heads/master ← masterを指している場合
echo "ref: refs/heads/main" > .git/HEAD

$ git push origin --delete release/v1
remote: Permission to org/repo.git denied to username.
fatal: unable to access ...: The requested URL returned error: 403

# 認証情報の確認
gh auth status
# 現在どのユーザー・スコープでログインしているか確認

# PATのscope: repo, delete_repo 等を見直す
# → 新しいPAT発行: https://github.com/settings/tokens

# SSHキーで接続している場合
ssh -T git@github.com
# → 接続できるユーザーが正しいか確認

# 他の開発者がリモートのbranch/Xを削除済み
# しかし自分のローカルでは:
$ git branch -r | grep X
origin/feature/X    ← まだ見える！

# 一回だけprune
git fetch --prune

# 特定リモートだけ
git fetch origin --prune

# 以降自動化（全remote共通）
git config --global fetch.prune true

# 個別のstale参照を強制削除
git branch -dr origin/feature/X

$ git push origin --delete feature/old
remote: error: refusing to delete ...
To github.com:org/repo.git
 ! [remote rejected] feature/old (refusing to update checked out branch)
error: failed to push some refs to 'github.com:org/repo.git'

# 詳細出力（GIT_TRACE）
GIT_TRACE=1 GIT_CURL_VERBOSE=1 git push origin --delete feature/old 2>&1 | less

# pre-receive hookに阻まれている場合
# → サーバー管理者（GitHubの場合はorg admin）に確認

# 保護ブランチ以外の原因候補:
# - CODEOWNERSで所有者レビュー必須
# - Requires signed commits が有効
# - Rulesetで削除禁止

# リモート追跡参照のstale掃除
git fetch --prune --prune-tags

# 古いreflogエントリを強制期限切れ（90日→30日など）
git reflog expire --expire=30.days --all
git reflog expire --expire-unreachable=7.days --all

# 孤児オブジェクトをGC（通常は自動実行されるが手動も可）
git gc --prune=now

# マージ済みローカルブランチを一括削除
git branch --merged main | grep -vE "^\*|main$|develop$" | xargs -n 1 git branch -d

# 削除直前のHEADを探す
git reflog
# a1b2c3d HEAD@{0}: checkout: moving from feature/X to main
# d4e5f6c HEAD@{1}: commit: feat: 機能X実装          ← これが削除対象の最後のcommit

# 新しいブランチとして復旧
git branch feature/X d4e5f6c

# または直接checkout
git checkout -b feature/X d4e5f6c

# 到達不可能なオブジェクトを探す
git fsck --lost-found
# dangling commit a1b2c3d...
# dangling commit d4e5f6c...

# コミット内容を確認
git show d4e5f6c

# 使えるものを復旧
git branch restored/feature-X d4e5f6c

## ブランチ削除ルール

### 削除OKなブランチ
- feature/* : PR marge後に自動削除（GitHub Auto-delete branch有効化）
- fix/*     : PR merge後に自動削除
- tmp/*     : 個人の一時ブランチ、自由に削除可

### 削除NGなブランチ
- main / master : 保護ブランチ、削除不可
- release/*    : Branch protectionでdelete禁止、代わりにタグでアーカイブ
- hotfix/*     : PR merge後に Admin判断で削除

### 削除前チェックリスト
1. git log <branch> --not main --oneline で未マージコミット有無を確認
2. GitHub/GitLab の Open PR にまだ残っていないかチェック
3. CIビルドが完了してから削除（実行中のCIが失敗する可能性）
4. 他メンバーが参照していないか Slack等で確認

### Branch protection 推奨設定（mainブランチ）
- Restrict deletions: ON
- Require pull request reviews: 1+
- Require status checks: CI green必須
- Include administrators: ON（Adminでも保護対象）