平时最烦的git操作是什么？不是合并冲突，也不是rebase，而是打开终端一看，本地分支列表密密麻麻一大片。feature/login-v2、hotfix/20240111、test/xxx，有些分支早就在远程合并删除了，本地还赖着不走。一次两次手动git branch -d还行，架不住二三十个分支排着队等着清理。所以“git批量删除本地多余分支”基本上是每个开发者在项目中期都会撞上的需求，这篇文章就把我实际用过的方案、踩过的坑、该避开的雷一次讲清楚。
如果你正被本地分支堆积困扰，或者只是想把git命令玩得更溜一点，这篇文章适合你。我会从分支安全判断开始，到批量删除命令的写法，再到误删恢复和常见报错处理，完整过一遍。不夸张地说，看完你就能像我一样，三十秒内清掉十几个没用分支，而且不手抖。
1. 先搞清楚你仓库里到底有多少“垃圾分支”
批量删除本地分支之前，最忌讳的是直接上手敲命令。我先说说为什么会攒下这么多分支，以及什么样的分支值得删、什么样的分支千万别碰。
1.1 本地分支堆积的典型场景
很多团队走的是“功能分支 + 合并删除”流程：每做一个需求就新建一个分支，比如从develop拉出feature/order-export，开发完合并回develop，然后远程分支删除。问题在于，远程分支删了，本地这个分支还留在仓库里。你后来checkout到别的分支，再切回来，这个分支依然存在。
还有一种常见场景是临时验证。比如线上出bug，你紧急从master拉了一个hotfix/xxx修完并推送，后面所有人都忘了它。或者你在本地做实验，随手建了test/refactor、deploy/test，实验结束也没删。这种分支堆积到一定量，每次git branch输出都要滚好几屏，找分支变成一场眼力较量。
不少人的git branch -a输出能有几十行，真正有意义的可能就两三个。这些多余分支占不了多少磁盘，但它们干扰注意力，还容易让你切错分支、合并错对象，甚至有人会对着一个早已废弃的分支继续开发，造成后续合并冲突。
1.2 哪些分支可以删，哪些不能删——先学会判断
判断一个本地分支是否能删，核心标准就两条：一是它是否已经合并进当前分支（或主干分支），二是你是否还需要它上面的历史提交。如果分支上的所有修改都已经合入主干，那删掉它是完全安全的，因为提交记录仍然留在合并目标分支的历史里。如果分支没有被完全合并，那上面一定存在某些“独有提交”，直接删掉这些提交会丢失，除非你确定它们已经没有价值。
具体来说，以下几种情况可以放心删：
- 已经合并到
develop或master的功能分支 - 远程分支已经删除，本地分支也确认没有独立开发内容的
- 临时验证用，验证完成后确认不需要保留的分支
- 旧版本的hotfix分支，修复代码已经进入主干
以下几种情况打死也别删：
- 你当前正处在这个分支上（删除会失败，除非用
-D强制，但那就更危险了） - 分支上有未合并的提交，而这些提交是你辛苦写了好几天还没备份的代码
- 分支被用于持续集成或部署流水线触发（比如某些CI配置里指定了分支名）
- 团队里其他人还在依赖你本地这个分支上的独有提交（虽然少见，但协作时可能发生）
在动手批量删除前，我强烈建议你先用git branch --merged看一眼哪些分支已经合并，再用git branch --no-merged看一眼哪些没有合并。这条命令就像给分支做了一次“体检”，先把健康状况摸清楚了，后面的批量清理才不容易误伤。
2. 删除分支的核心原理与基础命令回顾
说批量之前，得先确认你对单个删除命令的机制有数。很多人只会死记-d和-D，但这两个参数背后的逻辑完全不同。
2.1 git branch -d 与 git branch -D 的本质区别
git branch -d <branch-name>是“安全删除模式”，git 会检查你要删除的分支是否已经合并到当前分支（HEAD 指向的分支）。如果已经合并，删除成功；如果还有未合并的提交，git 会拒绝删除，并给出类似error: The branch 'xxx' is not fully merged.的提示。这个设计是为了保护你，避免误删未合并的工作。
git branch -D <branch-name>是“强制删除模式”，大写D会跳过合并检查，直接删除分支引用。使用它意味着你明确知道这个分支的独有提交不再需要，或者你已经通过git cherry-pick、git merge等方式保留了你关心的提交。强制删除不会自动帮你备份，一旦执行，那些孤立提交就成了“无主”对象，虽然还能用git reflog或者git fsck找回，但过程很麻烦。
我见过不少新手图省事，批量删除时全用-D，结果把没合并的分支也删了。等发现代码丢了才追悔莫及。所以我的原则是：默认用-d，只有在确认分支无用后，才对未合并分支单独用-D。
2.2 删除前的安全检查：当前分支、工作区状态、远程同步
批量删除前，有三个安全检查必须做，缺一个都可能惹麻烦。
第一，确认当前在哪个分支上。你不能删除当前所在分支，而批量脚本一旦包含当前分支，很可能报错或误操作。所以批量操作前先git checkout master或切到你想要保留的某个主干分支上，确保要删除的列表里不包含当前分支。
第二，确认工作区是干净的。如果你还有未提交的修改或未跟踪的文件，删除分支本身不影响这些文件（因为工作区内容并不属于某个分支引用），但如果你接下来要用git clean之类的操作，风险会飙升。建议在删除分支前，至少git status看一眼，确认你没有处于“准备提交”的半路状态。
第三，确认远程分支状态。如果远程分支还活着，你删掉本地分支后，下次git fetch --prune或git pull可能又会因为远程引用而重新出现在某些操作中，或者造成本地与远程状态不一致的混乱。通常的流程是：先确认远程分支已合并已删除（或在远端删除），再清理本地分支。当然，如果你只想清理本地、保留远程分支，也是可以的，只要后续记得别因为误操作去创建同名冲突分支就行。
这三项检查不会花多少时间，但能避免九成以上的误删事故。我在批量删除前总是习惯敲一遍git status和git branch，不为别的，就是图个心安。
3. 批量删除已合并分支的实用方案
现在我们进入正题：怎样一键批量删除那些已经合并进主干的多余分支。这里的核心思路是“先筛选，再删除”，而不是盲目把所有分支都删了。
3.1 用 git branch --merged 筛选目标
git 提供了一个非常方便的参数：git branch --merged。这个命令会列出所有已经合并到当前分支（或指定分支）的本地分支。举个例子：
git checkout master git branch --merged输出会包含master自己，以及所有已经合并进master的分支。因为当前分支自身必然被算作“已合并”，所以在筛选时记得排除它，或者用git branch --merged | grep -v '^\*'排除当前分支。
如果你想把某个目标分支作为合并基准，也可以指定，比如git branch --merged develop，它列出的是已经合并到develop的分支。但这里有个容易搞混的点：--merged是“可以合并到目标分支”还是“已经被目标分支合并”？从git文档来看，它的含义是“分支的tip可以从目标分支tip到达”，也就是“目标分支包含该分支的所有提交”。换句话说，git branch --merged develop列出的分支，其所有提交都已经在develop里了，删除这些分支不会丢失任何独有提交。
与之对应的git branch --no-merged则列出那些“目标分支还未包含其所有提交”的分支，也就是还有独有提交、删除有风险的分支。这两个参数结合起来，能给你一个非常清晰的分支清理地图。
3.2 配合 grep、xargs 实现批量清理
筛选出目标列表后，剩下的事情就是把这串列表传给git branch -d。最经典的一行命令是：
git checkout master git branch --merged | grep -v "master" | grep -v "develop" | xargs git branch -d拆开来看：
git branch --merged列出所有已合并分支grep -v "master"排除主干分支（也可以再加grep -v "develop"排除必要分支）xargs git branch -d把每一行分支名作为参数传给git branch -d
这样执行后，git 会逐个删除这些已合并分支。因为它们是已合并状态，用-d是安全的，万一有遗漏的未合并分支，git 还会自动拒绝删除，避免事故。
不过这条命令有个小坑：如果git branch --merged的输出为空，xargs会直接调用git branch -d而不带参数，导致报错。虽然无伤大雅，但为了优雅，可以加-r参数让 xargs 在无输入时不执行命令：
git branch --merged | grep -v "master" | xargs -r git branch -d另外，如果你用grep筛选分支名时，需要排除的分支名带有特殊字符或前缀，比如feature/，那grep -v "feature/"就能排除所有带该前缀的分支。但如果排除规则太多，命令会变得很长。这时候我建议把要保留的分支写进一个数组文件，或者用下面的进阶写法。
3.3 排除保护分支的进阶写法
常规的grep -v连用能排除两三个分支，但如果保护分支很多，或者你想根据分支名前缀排除（例如排除所有release/*分支），可以使用egrep配合正则表达式：
git branch --merged | egrep -v "(^\*|master|develop|release/)" | xargs -r git branch -d这行的意思是：列出所有已合并分支，然后排除当前分支标记（*）、排除master、排除develop、排除所有以release/开头的分支，剩下的全部删除。
注意^\*这个正则：git branch输出当前分支时，行首会有一个星号，比如* master。如果只排除master是够的，但如果你当前不在 master 上，当前分支可能排在列表里，所以最好用正则排除行首星号的那一行。这样能保证你不会试图删除当前分支。
如果你需要更复杂的判断，比如只保留最近N天内更新过的分支，或者排除包含特定关键字的分支，纯命令行的grep就有点费劲了。此时可以用一段小的 shell 脚本循环处理，例如：
git branch --merged > /tmp/merged_branches.txt while read branch; do case "$branch" in master|develop) continue ;; release/*) continue ;; esac git branch -d "$branch" done < /tmp/merged_branches.txt这样做的好处是逻辑清晰，想加什么筛选规则都方便，而且能避免xargs带空格分支名的问题。虽然在分支名一般不会有空格，但用while read循环会稳妥不少。
4. 批量删除未合并分支的谨慎操作
前面那些命令只针对“已合并分支”，安全又省心。但你可能遇到这样的情况：某个分支还没合并，但上面的改动确实不要了，比如一个实验分支或者废弃的临时分支。这时候就要考虑强制批量删除。
4.1 什么时候需要强制删除
需要-D的情况主要有三种：
- 分支上的提交是你自己实验性的修改，确认不再需要
- 分支上的代码已经通过其他方式保存（比如你手动复制到了别的分支或者压缩包）
- 分支长期无人使用，且其独有提交的内容属于历史遗留垃圾
如果你不确定分支上的提交是否被别的分支包含，可以用git branch --contains <commit-hash>来检查哪些分支包含了某个提交。或者更简单一点：先用git branch --no-merged master看看所有未合并分支，然后逐个git log下去看提交时间、提交说明，再决定要不要删。
千万不要因为“看起来没用”就直接批量-D。我见过同事一个周末写的代码放在temp/xxx分支上，后来被别人当垃圾清理掉了，结果代码还没合并，重写花了好几天。强制删除之前，务必给自己的“可能有用”留一点缓冲空间。
4.2 一键清理所有本地分支的脚本写法
如果你确定仓库里除了主干分支，其他分支一概不需要保留，可以用下面这个思路：
git checkout master git branch | grep -v "master" | grep -v "develop" | xargs -r git branch -D或者更“暴力”一点，把除当前分支以外的所有本地分支都删掉：
git branch | grep -v "^\*" | xargs -r git branch -D这行命令会删除除了当前分支外的所有本地分支，包括已合并和未合并的。它的风险非常高，只适合你明确知道所有分支都没用时操作。我虽然写过这种命令，但极少使用，因为一旦里面混入了某个未合并分支，代码直接人间蒸发。
更稳妥的做法是分两步走：先删除所有已合并分支（用-d），再手动确认未合并分支列表，逐个删除。比如：
git checkout master # 第一步：安全删除已合并分支 git branch --merged | grep -v "^\*" | grep -v "master" | grep -v "develop" | xargs -r git branch -d # 第二步：列出所有未合并分支，人工检查 git branch --no-merged这样先安全清理，再人工干预，既高效又不冒险。对我来说，批量删除的“批量”主要体现在第一步，第二步则是精装修，慢一点没关系。
4.3 搭配 PowerShell、cmd 与 Bash 的差异处理
很多 Windows 用户在 Git Bash 或者 CMD、PowerShell 里操作，命令写法有差异。Git Bash 环境（模拟Linux）可以直接用上述grep、xargs组合。但纯 CMD 或 PowerShell 并不直接支持grep、xargs，所以需要换一种方式。
以 PowerShell 为例，批量删除已合并分支可以这样写：
git branch --merged | Where-Object { $_ -notmatch '^\*' -and $_ -notmatch 'master' -and $_ -notmatch 'develop' } | ForEach-Object { git branch -d $_.Trim() }解释一下：git branch --merged输出的每一行字符串会被 PowerShell 捕获，Where-Object用正则过滤掉当前分支、master、develop，然后ForEach-Object对每个分支名执行git branch -d。注意.Trim()是为了去掉可能存在的空格。
在 CMD 里，因为没有管道对象，最简单的做法是把分支列表输出到文件，再用for /f循环：
git branch --merged > merged.txt for /f "delims=* " %i in (merged.txt) do git branch -d %i这个批处理的delims=*是表示按星号和空格作为分隔符，从而去掉行首星号。不过要注意，如果分支名包含空格，这个方案也会出错。实际git分支名一般不建议包含空格，所以问题不大。
如果你常用图形化工具，比如 SourceTree、TortoiseGit，它们也提供分支管理界面，可以多选批量删除。但这篇文章主要讲命令行，图形化就不展开了。
5. 常见问题与排查技巧实录
用了这么多年git，批量删除分支的过程中，我也踩过不少坑。这里把最高频的几个问题整理出来，希望你能跳过这些坑。
5.1 提示“branch not fully merged”怎么办
当你执行git branch -d <branch>，如果提示error: The branch 'xxx' is not fully merged.，说明该分支还有未合并的提交。这时需要你先判断这些提交是否还需要。如果不需要，就用-D强制删除；如果需要，就得先切换过去合并或把需要的提交保存到其他方式，再删除。
我见过有人遇到这个提示后直接-D删了，结果发现分支里有自己没合并的 bug 修复。所以我建议，遇到这个提示先执行git log <branch> --not master看看这个分支独有的提交内容。如果提交记录显示是“fix typo”之类的琐碎改动，那删了就删了；如果显示是“feat: 报表新功能”这种，你就要慎重了。
5.2 删除后如何恢复误删分支
误删分支后，第一时间能救回来的方法有两个：git reflog和git fsck。
git reflog记录了本地仓库 HEAD 的每一次变动，包括分支的创建、切换、合并等。如果你刚才用git branch -D删除了分支，你可以在终端输入：
git reflog输出里会有一行类似abc1234 HEAD@{0}: branch -D feature/xxx的记录。那个abc1234就是被删除分支最新提交的哈希。你可以基于这个哈希创建一个新分支：
git checkout -b feature/xxx abc1234这样就恢复了分支。需要注意的是，reflog 会有过期清理机制，默认90天，所以误删后越早处理越好。
另一种方法是git fsck --lost-found，用于查找仓库中仍然存在但没有引用指向的悬空提交。
git fsck --lost-found运行后可能列出很多dangling commit，你需要逐个用git show <hash>查看提交内容，找到你要恢复的那个提交，然后用同样方式创建分支。这个方法在 reflog 被刷新后也能用，但需要花费更多时间辨别。
我个人的经验是：误删后先不要执行任何其他 git 命令，立刻用git reflog找最近的哈希，因为其他操作可能把关键记录冲掉。
5.3 远程分支还留着，本地删了会有什么影响
你可以只删除本地分支而保留远程分支，这种情况很常见。比如你想清理本地工作区，但远程分支还需要保留给同事拉取。删除本地分支后，对你的远程仓库不会有任何影响，你可以在以后需要时再次从远程分支创建本地分支：
git checkout -b feature/xxx origin/feature/xxx但这里有个容易让新手迷惑的点：如果你之后执行git fetch --prune（或git pull --prune），git 会按照远程引用清理本地的“远程跟踪分支”。这些远程跟踪分支通常显示为origin/feature/xxx，它们和本地分支不同。git branch -d只删本地分支，不影响origin/feature/xxx。如果你想连远程跟踪分支也清理，需要用git branch -r -d origin/feature/xxx或等git fetch --prune自动清理。
如果你本意是想“本地分支和远程分支一起删”，那是另一套流程：先git push origin --delete <branch>删远程分支，再git branch -d <branch>删本地分支。批量删除远程分支的命令是：
git branch -r | grep origin/feature | sed 's/origin\///' | xargs -r -n 1 git push origin --delete这个命令危险性很高，执行前务必确认输出列表准确。
5.4 批量操作时避免误删当前分支的坑
在 Bash 命令里，git branch输出当前分支时行首有星号，但如果你用git branch | grep -v "master"来过滤，恰好当前分支是feature/test，没过滤掉，就会在xargs git branch -D时试图删除当前分支。git 会拒绝删除当前分支，所以不会立刻造成灾难，但如果你用了循环脚本并强制-D，说不定就会出错或误删。
更安全的方式是用git branch --show-current获取当前分支名，然后在筛选时排除它：
current=$(git branch --show-current) git branch | grep -v "$current" | xargs -r git branch -D或者直接先 checkout 到一个确定的分支，再用grep -v "^\*"过滤。养成“先切到安全分支再批量清理”的习惯，能从根本上避免这类问题。
6. 几条我一直沿用的实战习惯
批量删除本地分支这件事，做得多了，我慢慢总结出一些能让自己更省心的习惯。分享出来供你参考。
我习惯把常见的清理命令写成小脚本，放在.bashrc或者单独的git-clean-branches.sh里。脚本内容大概是这样：
#!/bin/bash # 清理本地已合并分支，保留主干分支 set -e git checkout master 2>/dev/null || git checkout main 2>/dev/null echo "当前分支：$(git branch --show-current)" echo "待删除的已合并分支：" git branch --merged | grep -v "^\*" | grep -v "master" | grep -v "develop" | grep -v "main" read -p "确认清理以上分支？(y/n): " confirm if [ "$confirm" = "y" ]; then git branch --merged | grep -v "^\*" | grep -v "master" | grep -v "develop" | grep -v "main" | xargs -r git branch -d echo "清理完成。" else echo "已取消。" fi脚本里加了确认步骤，避免手滑。我个人觉得，即使批量操作再快，也要加一层确认，因为人的注意力总会有瞬间走神的时候。
另外，我会定期执行git fetch --prune来同步远程删除的跟踪分支。很多人只知道清理本地分支，忽略了远程跟踪分支，导致git branch -a里显示一堆失效的origin/xxx。执行git fetch --prune后，那些远程不存在的跟踪分支会被自动清除，整个分支列表会清爽很多。
最后，如果你用 VS Code、JetBrains 这类 IDE，它们的 git 插件也提供了分支删除操作。但命令行批量处理在效率上还是明显领先的。我通常是在终端里完成清理，顺带看一眼哪些分支最近还在活跃，心里有数。
批量删除本地多余分支，说到底是“安全筛选 + 精准执行”的组合。先借助--merged、--no-merged搞清楚哪些分支能删，再用-d或-D配合管道批量执行，最后别忘了定期同步远程。我自己每次清理完，看到git branch只列出几行简洁的分支名，心情都会好很多。这个操作不复杂，掌握好细节，你也能轻松hold住仓库里那堆“历史包袱”。
