git remote prune origin 不会删除本地分支，只清理 .git/refs/remotes/origin/ 下的远程追踪引用（如 origin/feat-x）；本地分支（如 feat-x）需手动用 git branch -d 或脚本安全清理。
git remote prune origin 为什么没删掉本地分支
它根本不会动本地分支，只清理 .git/refs/remotes/origin/ 下的远程追踪引用（比如 origin/feat-x）。那些已经从远程删除、但你还留着的本地分支（比如 feat-x），git remote prune 视而不见。
常见错误现象：执行完 git remote prune origin 后，git branch -a 依然显示一堆带 origin/ 前缀的“幽灵分支”，甚至 git branch 还能看到早已合并并被远程删掉的本地分支。
- 真正要清理的是两类东西：过期的远程追踪引用（用
prune）、和你不再需要的本地分支（得手动或脚本删） -
git remote prune等价于git fetch --prune，只是不拉新代码，只做“剪枝” - 执行前建议先
git fetch --all，确保本地知道远程最新状态，否则 prune 可能漏删
如何安全批量删除已合并且远程不存在的本地分支
别直接 git branch -D 批量删——容易误伤。稳妥做法是先筛选出「已合并到 main（或 master）」且「远程对应分支已不存在」的本地分支。
一个可靠的一行命令：
git branch --merged main | grep -v "main\|master" | while read branch; do git ls-remote --heads origin $(echo $branch | xargs) >/dev/null || echo $branch; done | xargs -r git branch -d
说明：
-
git branch --merged main列出所有已合并进main的本地分支（不含main自身） -
git ls-remote --heads origin <branch></branch>检查该分支是否还在远程存在；返回空则说明已被删 -
xargs -r避免传空参数导致报错 - 用
git branch -d（非-D）保证只删已合并的，防丢未 push 的提交
git branch -r 显示的 origin/xxx 分支怎么彻底消失
这些是远程追踪引用，不是真实分支，但残留会干扰 git branch -a 输出、影响自动补全、甚至让某些 CI 脚本误判。它们藏在 .git/refs/remotes/origin/ 目录下。
除了 git remote prune origin，还可以手动清理：
- 确认远程状态同步：
git fetch --all --prune - 检查残留：
git ls-remote --heads origin | cut -f2 | sed 's@refs/heads/@@'对比git branch -r输出 - 强制刷新全部追踪引用：
git remote update origin --prune（比单独 prune 更彻底） - 极端情况可删目录：
rm -rf .git/refs/remotes/origin/*，然后立刻git fetch origin，但慎用
CI/CD 或自动化脚本里怎么避免这类问题
很多部署脚本用 git checkout -b 创建临时分支，跑完不清理，久而久之仓库越来越臃肿。关键不是事后清理，而是从源头控制。
- CI 中 checkout 后加清理逻辑：
git branch --format='%(refname:short)' | grep -E '^ci-|^tmp-' | xargs -r git branch -d - 禁止直接
git clone --depth=1后不做fetch --prune就长期复用仓库，浅克隆+远程删分支极易积累 stale refs - Git 2.37+ 支持配置自动 prune：
git config --global fetch.prune true，之后每次git fetch都默认剪枝 - 团队约定：PR 合并后，作者负责删自己的远程分支，并提醒协作者运行
git fetch --prune
最麻烦的不是删分支，而是某天发现 git log --oneline -n 20 origin/main...feature-y 报错说找不到 origin/feature-y，但 git branch -a 里还列着它——这时候你就得翻 reflog、查 HEAD 指针，而不是指望一条 prune 命令解决。
