git branch -d 删除失败因分支未合并，需用 -d 强制删除；删本地后须显式删远程分支并 prune 追踪引用，否则残留；可批量删已合并分支，但需谨慎；fetch --prune 不自动删除过期远程引用。
git branch -d 删除失败：提示“分支未合并”
直接用 git branch -d <branch-name></branch-name> 删不掉，是因为 Git 默认拒绝删除尚未合并到当前分支的本地分支——哪怕你确定它没用，Git 也怕你手滑丢代码。
这时候有两个选择：
- 确认分支确实无用，用
git branch -D <branch-name></branch-name>强制删除（-D等价于--delete --force） - 先切过去看看提交历史：
git checkout <branch-name></branch-name>，再运行git log --oneline -n 5，确认最后几条提交是否已在main或develop中存在 - 如果只是怕漏合，可以临时合并验证：
git checkout main && git merge --no-ff --no-commit <branch-name></branch-name>，检查完git merge --abort撤销
删了本地分支，远程还在：git push origin --delete
本地删干净 ≠ 远程消失。远程分支是独立对象，必须显式通知远端删除。常见错误是只跑 git branch -D 就以为完事了，结果下次 git fetch 又把旧分支拉回来。
正确操作分两步：
- 删远程分支：
git push origin --delete <branch-name></branch-name>（Git 2.0+ 推荐写法）或等价的git push origin :<branch-name></branch-name> - 清理本地对远程分支的追踪引用：
git remote prune origin，否则git branch -a仍会显示remotes/origin/<branch-name></branch-name> - 如果团队多人协作，提醒同事也执行
git fetch --prune，避免他们本地残留过期追踪分支
一键清理所有已合并的本地分支（慎用）
想批量删掉所有已合并进 main 的本地功能分支？可以用这条命令，但务必先确认当前不在要删的分支上：
git branch --merged main | grep -v "main\|develop" | xargs git branch -d
说明：
-
git branch --merged main列出所有能被main“看到”的本地分支（即已合并） -
grep -v排除保护分支，防止误删main或develop -
xargs git branch -d安全逐个删除；若想跳过提示直接强删，把-d换成-D - 注意：该命令不处理远程分支，删完还得手动跑
git push origin --delete对应分支
git fetch --prune 不等于自动同步远程状态
很多人以为只要加了 --prune，git fetch 就会自动删掉本地过期的 remotes/origin/* 引用——其实不会。它只在 fetch 完成后，对比远端当前分支列表，把本地多出来的 remotes/origin/xxx 标记为“可删”，但真正删除要靠后续的 git remote prune origin 或显式 git fetch --prune（等价于 git remote prune origin 后再 fetch）。
更稳妥的做法是：
- 日常开发中，在
git pull前先执行git fetch --prune - 或者配置自动修剪：
git config --global fetch.prune true，此后所有git fetch（包括git pull内部调用）都会默认 prune - 但注意：该配置不影响
git branch -a的输出延迟，刚删完远程分支时，本地remotes/origin/xxx仍会残留一两次 fetch，这是正常缓存行为
最易忽略的一点：远程分支删除后，GitHub/GitLab 页面上对应 PR 会变成“merged but not deleted”，这时分支虽不可推拉，但 Git 仍把它当有效引用。除非手动点页面上的 Delete branch 按钮，或确保 CI 流水线配置了自动清理（如 GitHub Actions 的 delete-branch action），否则它可能在远端悄悄活很久。
