如何清理远程已删除的本地跟踪分支
清理失效的远程跟踪引用:git fetch --prune(或 git remote prune origin)删除远程已不存在的 origin/ 引用;本地残留的对应分支用 git branch -vv 找 ": gone]" 标记后核对引用和提交,再逐个删除。
两步清理:① git fetch --prune——删除远程已经不存在的 origin/* 跟踪引用;② 清理对应的本地分支——git branch -vv 里标记 : gone] 的表示本地找不到其上游引用,未必证明服务器刚删除了分支;应列候选并核对后逐个删除。
第一步:清理远程跟踪引用
git fetch --prune
# 或只清理不拉取
git remote prune origin
# 让以后每次 fetch 自动清理
git config --global fetch.prune true
第二步:清理本地分支
git for-each-ref --format='%(refname:short) %(upstream:short) %(upstream:track)' refs/heads/
# 人工核实 gone 候选、当前工作树占用和提交后,再逐个执行
git branch -d branch-to-remove
git branch -vv里[origin/feature-x: gone]表示本地上游引用缺失,仍需核实远端状态;- -d 按可用上游或 HEAD 判断是否已合并,也拒绝其他工作树正检出的分支;它不是“所有工作都已发布”的证明。
预防堆积
- GitHub 仓库设置开启 Automatically delete head branches——PR 合并后自动删远程分支;
- 本地养成
fetch --prune习惯(设成默认后一劳永逸); - 定期
git branch --merged清理已合并的本地分支。
常见问题(FAQ)
Q:prune 会删我本地分支吗?
默认远程跟踪映射下通常不会。fetch --prune 按该远程 fetch refspec 清理跟踪引用;自定义 refspec 或 prune-tags 也可能影响其他命名空间,先检查配置。本地分支要靠第二步的命令删,而且 -d 有未合并保护。
Q:": gone]" 的分支还有未推送提交怎么办?
不能只依赖 -d:上游缺失时判断可能回退到 HEAD,需显式检查要保留的提交。确认这些提交没用后 git branch -D;想保留先把它推到别的远程或打 tag。
Q:fetch --prune 每次都执行会不会慢?
不会,prune 只是比对引用列表,开销可忽略。设 fetch.prune=true 全局开启最省心。