如何在 Git 中批量删除本地已合并到 master 的旧分支

最稳妥的做法是先用 git branch `--merged` 确认列表，再通过管道命令配合 git branch -d 批量删除，避免误删未合并代码。

先说结论：该方案适合定期清理本地仓库，降低分支列表杂乱度，但需确保当前不在待删除分支上。

• 适合：本地开发环境分支过多，且确认功能已合并的场景
• 先看：执行删除前务必通过列表命令二次确认分支名称
• 建议：优先使用 -d 参数而非 -D，防止丢失未合并提交；Windows 用户请使用 PowerShell 方案

命令速用版

Linux / Git Bash 环境：

git branch `--merged` master | grep -v -E '^\*|master|main' | xargs -r -n 1 git branch -d

Windows PowerShell 环境：

git branch `--merged` master | Where-Object { $_ -notmatch '^\*|master|main' } | ForEach-Object { git branch -d $_.Trim() }

原理简述

Git 的分支本质上是指向提交的指针。当某个分支的 tip 提交可以通过历史追溯到达 master 分支时，Git 认为该分支已合并。清理这些分支不会影响主分支的历史记录。

分步处理

1. 切换回主分支：执行 git checkout master 或 git switch main，确保不在待删除分支上。

2. 列出已合并分支：运行 git branch `--merged`，检查输出是否符合预期。

3. 过滤保护分支：使用 grep 或 Where-Object 排除当前分支（带 * 号）及主分支名称（master/main）。

4. 执行删除：通过管道将过滤后的分支名逐个传给 git branch -d 命令。

验证方法

运行 git branch 命令查看本地分支列表，确认已合并的旧分支不再显示。若需确认远程状态，可配合 git branch -r 查看。

常见坑

1. 当前分支保护：Git 不允许删除当前检出的分支，必须先切换走。

2. 主分支命名差异：新版仓库可能使用 main 而非 master，命令中的分支名需对应调整。

3. 空列表报错：如果没有可删除的分支，Linux 下 xargs 缺少 -r 参数会报错执行一次空命令；Windows 下 PowerShell 管道天然支持空处理。

4. 远程分支不受影响：该命令仅删除本地分支，远程仓库的分支需单独使用 git push `--delete` 清理。

5. 未合并代码丢失：若误用 -D 参数，未合并的提交将无法通过常规手段找回。

原文链接：https://www.zjcp.cc/ask/11164.html