如何高效批量删除Git仓库中的多个远程分支？

本文共计725个文字，预计阅读时间需要3分钟。

Git的`git push origin --delete`命令每次只能接受一个分支名，如果传入多个参数会报错：

怎么安全批量删远程分支（带预览+过滤）

必须分两步：先生成待删列表并人工核对，再执行删除。直接管道删风险极高，尤其当分支名含空格、换行或特殊字符时，xargs 容易截断或误判。

• 先预览将删哪些分支（以已合并到 main 的为例）：
  git branch -r --merged origin/main | sed 's/origin\///' | grep -vE '^(main|develop|master)$'
• 确认无误后，用 echo 检查命令是否生成正确：
  git branch -r --merged origin/main | sed 's/origin\///' | grep -vE '^(main|develop|master)$' | xargs -I {} echo git push origin --delete {}
• 真正执行时，把 echo 换成 git：
  git branch -r --merged origin/main | sed 's/origin\///' | grep -vE '^(main|develop|master)$' | xargs -I {} git push origin --delete {}

注意：grep -vE '^(main|develop|master)$' 是关键过滤，避免误删主干分支；sed 's/origin\///' 是为了提取干净分支名，否则 git push origin --delete origin/xxx 会失败。

删完远程分支，为什么 git branch -r 还显示它

因为 git branch -r 显示的是本地缓存的远程跟踪引用（remote-tracking refs），不是实时从服务器拉取的。远程分支已被删，但你的本地仓库还不知道。

• 必须手动清理缓存：git fetch --prune 或等价的 git remote prune origin
• 如果团队多人共用同一远程，别人不会自动同步这个状态——他们得各自运行 git fetch --prune
• 不清理会导致后续 git checkout 或 git switch 尝试基于已不存在的远程分支创建本地分支，报错 fatal: couldn't find remote ref refs/heads/xxx

Windows PowerShell 用户别用 xargs

PowerShell 默认不支持 Unix 风格的 xargs，直接复制 shell 脚本会报错或静默失效。

• 替代写法（安全、跨行兼容）：
  git branch -r --merged origin/main | ForEach-Object { $_ -replace 'origin/', '' } | Where-Object { $_ -notin @('main', 'develop', 'master') } | ForEach-Object { git push origin --delete $_ }
• 关键点：-replace 替代 sed，Where-Object 替代 grep -v，每步都做字符串清洗，避免空格断裂

真正麻烦的从来不是“怎么删”，而是删完之后没人记得去 fetch --prune，或者在没确认 --merged origin/main 是否真代表“功能已上线”就批量清掉——有些分支 merge commit 是手工 cherry-pick 上去的，Git 的 DAG 判定会漏掉这部分历史。