できない.dev

git branch -d でブランチを削除できない(not fully merged)

git branch -d が not fully merged で止まるのは、削除対象のコミットが上流ブランチ(未設定なら現在のブランチ)へ未マージのときだ。
マージ済みか確かめ、本当に捨ててよいときだけ -D で強制削除する。

公開: 更新:

症状できない · exit 1
git branch -d feature
error: the branch 'feature' is not fully merged
hint: If you are sure you want to delete it, run 'git branch -D feature'
hint: Disable this message with "git config set advice.forceDeleteBranch false"
解決後できた · exit 0
git branch -D feature
Deleted branch feature (was f20acd0).

2026-08-02 に alpine/git で実際に打って取った出力。検証環境の詳細

要約

error: the branch 'feature' is not fully merged(Git 2.42 以前は error: The branch 'feature' is not fully merged.)は、削除対象ブランチのコミットが、上流ブランチ(未設定なら現在チェックアウト中のブランチ)へ取り込まれていないときに出る安全装置である。
未マージの作業を失わないための警告なので、まずマージ状況を確認し、破棄してよいと判断したときだけ強制削除する。

実行例

alpine/git 環境(Git 2.52.0)で上記の手順を走らせると、git branch -d feature は未マージを検知し、終了コード 1 で削除を拒否した。
続く git branch -D feature では、強制削除が終了コード 0 で完了した。

$ git branch --merged
* master
$ git branch -d feature
error: the branch 'feature' is not fully merged
hint: If you are sure you want to delete it, run 'git branch -D feature'
hint: Disable this message with "git config set advice.forceDeleteBranch false"
$ echo $?
1
$ git log --oneline master..feature
f20acd0 feature work
$ git branch -D feature
Deleted branch feature (was f20acd0).
$ echo $?
0
$ git branch
* master

— 2026-08-02 時点の出力

検証環境2026-08-02 検証
検証日
実行環境
alpine/git

この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。

解決策

1. マージ済みか確認する

まず削除して安全かを確かめる。

git checkout main
git branch --merged       # ここに出れば main へマージ済み
git log main..feature     # 空ならコミットは取り込み済み

git branch --merged の挙動は公式ドキュメント(新しいタブで開く)に定義されている。

2. マージしてから通常削除する

未マージで内容が必要なら、先にマージする。

git checkout main
git merge feature
git branch -d feature     # マージ済みなので -d で消える

3. 破棄してよいなら強制削除する

squash マージ後など、変更が反映済みでブランチだけ残っている場合は強制削除する。

git branch -D feature

-D は --delete --force の短縮で、未マージのコミットも消える。
実行前に git log feature を見て、失って困る作業が無いかを必ず確かめる。

よくある原因

① 本当に取り込んでいない

ABmainHEADCDfeatureC・D が main に無い → -d は拒否

② HEAD が別のブランチにいる

ABCmainfeatureEdevelopHEADdevelop から C が辿れない → 拒否main に切り替えれば -d で消せる

③ squash マージで取り込んだ

ABSmainHEAD中身は C+D と同じCDfeatureS は別のコミット → -d は拒否
git branch -d は、消すブランチのコミットが今いるブランチ(HEAD)から辿れないと削除を拒否する。① feature の C・D がまだ main に無い ② main には取り込んだが HEAD が別のブランチにいる ③ squash マージで中身だけを新しいコミット S にまとめた、のどれでも C・D は辿れない。③ は git log main..feature で中身を確かめてから -D で消す。
  1. feature の変更が本当に main に取り込まれていない。
    このときは -d が誤削除を防いでいる。
  2. 比較の対象がずれている。
    現在のブランチが main でなく別のブランチだと、そこから見て未マージに見える。
    上流を設定したブランチは上流と比べられるので、main へマージ済みでも、push していないコミットがあれば not yet merged to 'refs/remotes/origin/feature' の警告とともに拒否される。
  3. PR を squash / rebase でマージした。
    squash マージするとコミット ID が変わるので、Git はマージ済みと判定できない。