git branch -d 失败是因为分支未完全合并到当前分支或正被检出；删远程分支后 git branch -r 仍显示是因本地远程跟踪引用未更新，需执行 git fetch --prune 清理。
安全删除分支的前提是：分支已完全合并到当前所在分支，且你不在该分支上操作。否则 Git 会拒绝 git branch -d，或导致误删、残留引用、后续 git pull 报错等问题。
为什么 git branch -d 有时失败？
它只允许删除「已完全合并」的分支——即该分支的所有提交都存在于当前检出分支的提交历史中。Git 通过比较提交图谱判断，不是看文件内容是否一样。
- 常见错误信息：
error: The branch 'feature/x' is not fully merged. - 如果你刚合入 PR 但还没
git pull拉取远程最新main，本地main可能还不包含那个合并提交，-d就会报错 - 用
git merge-base --is-ancestor feature/x main可脚本化验证是否已合并（返回 0 表示是） - 别依赖
git log --oneline feature/x ^main是否为空来判断——它可能漏掉 merge commit 的父提交
删远程分支后，为什么 git branch -r 还显示它？
因为 git push origin --delete branch-name 只影响远程仓库，不自动更新你本地的远程跟踪引用（remote-tracking refs），比如 origin/branch-name。
- 必须紧接着执行
git fetch --prune或git remote prune origin - 如果团队多人协作，其他人也得各自运行
git fetch --prune，没人会自动同步这个状态 - 配置
fetch.prune=true可让每次git fetch默认修剪（git config --global fetch.prune true）
删完分支，git pull 仍报 fatal: couldn't find remote ref 怎么办？
这是本地分支还保留着已失效的上游配置（upstream），比如 branch.feature/x.merge 指向已删除的 origin/feature/x。
- 检查：运行
git config --get branch.feature/x.merge，若输出refs/heads/feature/x，就说明问题在此 - 解除追踪：
git branch --unset-upstream feature/x - 或者直接删本地分支：
git branch -d feature/x（如果不再需要） - 不要用
git branch -D强删来绕过这个问题——它不解决 upstream 配置残留
最易被忽略的是「上游配置残留」和「本地远程引用未修剪」这两点。它们不会立刻报错，但会在几天后某次 git pull 或 git checkout 时突然暴露，且错误信息不指向根源。动手前先 git branch -vv 看一眼状态，比事后排查快得多。
