清理Git分支全流程：从查看无效分支到批量删除

在团队协作开发中，Git仓库会随着时间积累大量无效分支（如已合并的开发分支、临时测试分支等）。这些分支不仅占用仓库空间，还会降低分支管理的效率。下面我将详细介绍从查看无效分支到批量删除的全流程操作，涵盖本地与远程分支的清理方法。

一、查看无效分支：识别需要清理的目标

1. 查看所有本地分支

git branch

作用：列出当前仓库的所有本地分支。
输出示例： * main # 当前所在分支（带*标记） dev-2023 feature/login hotfix-bug-123 temp-test

2. 查看所有远程分支

git branch -r

作用：列出所有远程分支（如GitHub/GitLab上的分支）。
输出示例： origin/main origin/dev-2023 origin/feature/login origin/temp-test

3. 查看所有分支（本地+远程）

git branch -a

作用：同时显示本地和远程分支，远程分支会以 remotes/origin/分支名 格式显示。

二、筛选无效分支：明确清理范围

1. 什么是无效分支？

已合并到主分支（如main/master）的分支：功能已上线且不再需要保留。
长期未更新的分支：例如超过3个月无提交记录的分支。
临时测试分支：如 temp-*、test-* 等明确为临时用途的分支。
冲突或损坏的分支：无法正常拉取或合并的分支。

2. 筛选已合并到主分支的分支（重点）

目标：找出所有已合并到 main（或 master）分支的分支，这些分支通常可以安全删除。

操作步骤：

# 切换到主分支（确保基准正确）
git checkout main

# 拉取主分支最新代码（避免本地主分支落后）
git pull origin main

# 查看所有已合并到main的分支（不包括main本身）
git branch --merged main

输出示例： dev-2023 feature/login temp-test 这些分支的代码已经全部合并到 main，删除后不会影响主分支功能。

排除主分支和当前分支：

git branch --merged main | grep -vE '^\*|main'

grep -vE '^\*|main'：过滤掉当前分支（带*标记）和 main 分支本身。

三、批量删除无效分支

1. 删除本地无效分支

删除单个本地分支：

git branch -d 分支名  # 安全删除（会检查是否已合并，未合并会报错）
git branch -D 分支名  # 强制删除（未合并也会删除，慎用！）

批量删除已合并到main的本地分支：

git branch --merged main | grep -vE '^\*|main' | xargs git branch -d

命令解析：
1. git branch --merged main：列出已合并到main的分支。
2. grep -vE '^\*|main'：过滤掉当前分支和main分支。
3. xargs git branch -d：将筛选出的分支名传递给 git branch -d 执行删除。

强制删除本地分支（未合并也删除）：

git branch --merged main | grep -vE '^\*|main' | xargs git branch -D

⚠️ 仅建议删除明确无用的分支（如临时测试分支），避免误删未合并的重要代码！

2. 删除远程无效分支

删除单个远程分支：

git push origin --delete 远程分支名
# 或旧版语法（等效）：
git push origin :远程分支名

示例：删除远程的 dev-2023 分支 git push origin --delete dev-2023

批量删除远程已合并分支（推荐）：

git branch -r --merged main | grep -vE '^\*|main|origin/' | sed 's/origin\///' | xargs -I {} git push origin --delete {}

命令解析：
1. git branch -r --merged main：列出远程已合并到main的分支（如 origin/dev-2023）。
2. grep -vE '^\*|main|origin/'：过滤掉当前分支、main分支和多余的 origin/ 前缀干扰（根据实际输出调整）。
3. sed 's/origin\///'：移除分支名前的 origin/ 前缀（得到纯分支名，如 dev-2023）。
4. xargs -I {} git push origin --delete {}：逐个删除远程分支。

更简单的远程批量删除方法（直接匹配分支名）：

如果远程分支命名有规律（如所有 dev-* 分支都可删除）：

git branch -r | grep 'origin/dev-' | sed 's/origin\///' | xargs -I {} git push origin --delete {}

注意：执行前务必通过 git branch -r 确认匹配的分支列表，避免误删！

四、清理本地缓存的远程分支引用

删除远程分支后，本地仓库仍会缓存这些远程分支的引用（显示为 origin/已删除分支名）。需要同步清理：

git fetch --prune
# 或简写：
git fetch -p

作用：从远程仓库获取最新分支状态，并自动删除本地缓存的已不存在的远程分支引用（如 origin/dev-2023）。

五、完整操作流程总结

1. 查看所有分支

git branch       # 本地分支
git branch -r    # 远程分支
git branch -a    # 全部分支

2. 筛选无效分支（以已合并到main为例）

git checkout main
git pull origin main
git branch --merged main | grep -vE '^\*|main'  # 本地已合并分支
git branch -r --merged main | grep -vE '^\*|main'  # 远程已合并分支

3. 批量删除本地无效分支

git branch --merged main | grep -vE '^\*|main' | xargs git branch -d
# 强制删除（未合并也删）：
# git branch --merged main | grep -vE '^\*|main' | xargs git branch -D

4. 批量删除远程无效分支

git branch -r --merged main | grep -vE '^\*|main|origin/' | sed 's/origin\///' | xargs -I {} git push origin --delete {}
# 或直接按命名规则删除（如dev-*分支）：
# git branch -r | grep 'origin/dev-' | sed 's/origin\///' | xargs -I {} git push origin --delete {}

5. 清理本地缓存的远程分支引用

git fetch --prune

六、注意事项

谨慎使用强制删除：git branch -D 或 git push origin --delete 会永久删除分支，确保分支代码已备份或不再需要！
备份重要分支：删除前可通过 git checkout 分支名 切换到分支，确认代码无用后再操作。
团队协作：如果是共享分支（如团队成员正在使用的分支），删除前需与团队沟通确认。
定期清理：建议每次迭代完成后（如发布新版本），清理本次迭代相关的临时分支。