git branch -d 安全删除已合并分支，拒绝未合并分支以防数据丢失；git branch -D 强制删除，跳过校验，可能永久丢失未合并提交。
git branch -d 和 git branch -D 到底该用哪个
安全删除和强制删除的区别，不是风格问题，是数据是否可逆的问题。git branch -d 只允许删已合并到当前分支的本地分支；一旦它拒绝操作并报错 error: The branch 'xxx' is not fully merged.，说明该分支还有未合入的提交——此时别急着换 -D，先确认那些提交是否真不需要。
常见错误现象：在 main 分支上执行 git branch -d feature/login 失败，就直接 -D 强删。结果发现那个分支里有还没提 PR 的 UI 调整，或者 CI 配置变更，彻底丢失。
- 日常清理建议始终先试
git branch -d branch-name - 删之前快速验证是否已合并：
git merge-base --is-ancestor feature/login main返回 0 表示已合并 - CI/CD 脚本中可用
-D，但必须确保分支生命周期由流程控制（如 PR 合并后自动触发销毁） - 别在游离头（detached HEAD）状态下删分支——
git branch -d会报错，且容易误判“当前分支”
git push origin --delete 后为什么 git branch -r 还显示旧分支
因为 git push origin --delete branch-name 只动了远程服务器，你本地的 refs/remotes/origin/branch-name 引用还躺在 .git/refs/remotes/ 里没更新。这不是 bug，是 Git 的设计：远程状态不会自动同步到本地缓存。
典型表现：删完远程分支，再跑 git branch -r，仍看到 origin/feature/login；甚至 git checkout feature/login 还能切进去，但 git pull 直接报 fatal: couldn't find remote ref refs/heads/feature/login。
- 正确清理命令是
git fetch --prune（等价于git fetch -p），不是git remote prune origin单独用——后者不拉新引用，只删旧的，容易漏 - 想预览将删哪些远程跟踪分支，加
--dry-run：git fetch --prune --dry-run origin - 如果长期没
fetch，本地 FETCH_HEAD 过期，--prune可能误判或跳过刚删的分支，所以务必先 fetch 再 prune，一步到位更稳
怎么批量清理所有 “gone” 状态的本地分支
所谓 “gone”，是指本地有分支（比如 feature/login），但它追踪的远程分支（origin/feature/login）已被删掉。这种分支在 git branch -vv 输出里会标成 [origin/feature/login: gone]，它们既不指向远程、也没被合并，纯属残留。
手动一个一个删太慢，尤其当 git branch 输出上百行时。但别用模糊匹配硬删（比如 git branch | grep -v main | xargs git branch -D），容易误伤正在开发的分支。
- 精准识别 gone 分支：
git branch -vv | grep ': gone]' | awk '{print $1}' - 安全批量删（先检查输出是否合理）：
git branch -vv | grep ': gone]' | awk '{print $1}' | xargs git branch -d - 如果有些 gone 分支未合并又确实要清，改用
-D，但建议加--force提示：git branch -vv | grep ': gone]' | awk '{print $1}' | xargs -r git branch -D - 注意：这个操作不碰
main、develop等主干分支，因为它们通常不设为追踪远程同名分支，也不会标为 “gone”
删完远程分支，本地同名分支的 upstream 配置还在
即使你删了远程分支、也删了本地分支，只要曾经执行过 git branch --set-upstream-to=origin/feature/login feature/login，那个上游配置就会留在 .git/config 里。下次在别的分支上 git pull 倒没事，但一旦切回那个已删分支名（比如通过 tab 补全误输），git pull 就会尝试去 fetch 已不存在的远程引用，报错且阻断流程。
更隐蔽的问题是：某些 IDE 或 CLI 工具（如 lazygit）会读取这些 stale upstream 配置，持续显示灰色“已失效远程分支”，误导判断。
- 查当前分支 upstream：
git config --get branch.feature/login.merge和git config --get branch.feature/login.remote - 清除单个分支 upstream：
git branch --unset-upstream feature/login - 批量清理所有分支的无效 upstream（谨慎）：
git config --remove-section branch.feature/login 2>/dev/null || true需配合脚本遍历 - 最省事的办法：删本地分支时顺手清 upstream，即
git branch -d feature/login && git config --remove-section branch.feature/login 2>/dev/null
真正难清理的从来不是分支本身，而是那些隐式依赖：上游配置、bash 补全缓存、IDE 的本地索引、CI 脚本里硬编码的分支名。删分支只是表象，关键是理清“谁还在引用它”。
