git批量删除已合并分支的脚本【实战】-git-PHP中文网

能安全批量删除已合并分支，但须严格区分本地/远程、基准分支（如main）、保护分支（如master/develop）三类边界；默认git branch --merged仅查当前head所在分支的合并情况，需显式指定基准如--merged main，并注意fast-forward合并外的squash等不被识别。

git批量删除已合并分支的脚本【实战】

能安全批量删已合并分支，但必须分清本地/远程、基准分支、保护分支三类边界，否则容易误删或报错。

git branch --merged 为什么常漏掉某些已合并分支

默认 git branch --merged 只显示已合并到 HEAD（当前所在分支）的本地分支，不是自动对齐 main 或 master。如果你在 develop 上执行，它列出的是“已合并进 develop”的分支，而非“已合并进主干”的分支。

正确做法是显式指定基准：比如用 git branch --merged main（Git 2.22+）或 git branch --merged origin/main（兼容旧版）
注意 origin/main 是远程追踪分支，需先 git fetch 同步最新状态，否则可能漏掉刚合并但本地未拉取的记录
--merged 不识别 Fast-forward 合并以外的“逻辑合并”（如 squash merge），这类分支不会出现在结果里

本地分支批量删除命令及避坑点

最常用的一行命令是：

git branch --merged main | grep -v "^[[:space:]]*main$" | xargs -r git branch -d

关键细节：

grep -v "^[[:space:]]*main$" 比简单 grep -v "main" 更安全——避免误删含 main 字样的分支（如 feature-main-fix）
xargs -r 防止输入为空时执行 git branch -d 报错（GNU xargs 支持，macOS 默认不带，可用 brew install findutils 补齐）
遇到 error: The branch 'xxx' is not fully merged 说明该分支未真正合并，-d 会跳过；若确定要删，得单独用 git branch -D xxx
别忘了排除保护分支：手动加 | grep -vE "^(master|develop|release/)" 这类过滤

远程分支不能靠本地命令自动同步删

git branch -d 只删本地引用，远程分支（如 origin/feat/login）必须显式推送删除指令：

Github Auto

管PR、盯Issue、跑CI、发Release——GitHub仓库日常运维扔给它。少开几个Chrome标签页。

下载

git branch -r --merged origin/main | sed 's/origin\///' | grep -vE '^(main|master|develop)$' | xargs -r -I {} git push origin --delete {}

注意几个硬性限制：

git branch -r --merged 的基准只能是远程追踪分支（如 origin/main），不能写 main
sed 's/origin\///' 是为提取纯分支名，否则 git push origin --delete origin/feat/login 会失败
部分 Git 服务器（如私有 GitLab）可能禁用 --delete 权限，需检查用户权限或改用 API 调用
删除远程分支后，本地仍保留 origin/xxx 引用，后续 git fetch --prune 或 git remote prune origin 才能清理

用 shell 函数封装成可复用命令

把高频操作固化为函数，比记长命令更可靠。例如加到 ~/.zshrc：

gbclean() {
  local base=${1:-main}
  echo "? 查找已合并到 $base 的本地分支..."
  git branch --merged "$base" | grep -v "^[[:space:]]*$base$" | grep -v "^*" | sed 's/^[[:space:]]*//'
  echo -n "⚠️  确认删除？[y/N] "
  read -r confirm
  [ "$confirm" = "y" ] || [ "$confirm" = "Y" ] && \
    git branch --merged "$base" | grep -v "^[[:space:]]*$base$" | grep -v "^*" | sed 's/^[[:space:]]*//' | xargs -r git branch -d
}

调用方式：gbclean main 或 gbclean develop。重点在于：