能安全批量删除已合并分支，但须严格区分本地/远程、基准分支（如main）、保护分支（如master/develop）三类边界；默认git branch --merged仅查当前HEAD所在分支的合并情况，需显式指定基准如--merged main，并注意fast-forward合并外的squash等不被识别。
能安全批量删已合并分支，但必须分清本地/远程、基准分支、保护分支三类边界，否则容易误删或报错。
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）必须显式推送删除指令：
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。重点在于：
- 交互确认环节不可省——哪怕脚本再严谨，分支名冲突、网络延迟、权限变化都可能导致意外
- 不自动删远程分支，避免一次误操作波及协作环境
- 输出预览列表，方便人工快速核对是否包含敏感分支（如
hotfix/类）
真正麻烦的从来不是命令怎么写，而是删之前没看清楚 git branch -vv 输出里那个 [gone] 标记，或者忘了某人上周刚推了个 release/v2.3.0 到远端但还没合入 main ——这些细节，脚本帮不了你。
