分支清理技术流程（项目：智能家居网关）
1. 清理概述
- 清理触发事件：功能合并完成
- 清理范围：特性分支、实验性分支
- 目标分支数量：通过预处理命令自动统计（见预处理检查与步骤），按命名约定与合并状态筛选后确定
- 预计影响范围：
- 代码仓库分支命名空间（feature/、feat/、experiment/、exp/ 等）
- 关联的未关闭合并请求（PR/MR）
- 引用分支名称的CI/CD配置、部署环境脚本、文档链接
- 开发者本地跟踪分支与远程跟踪引用
说明：整个流程以“验证已集成且可回滚”为原则，执行前创建归档标记（tag），禁用强制删除，确保全程可逆。
2. 预处理检查清单
- 仓库同步与健康检查
- 已执行 git fetch --all --prune，同步远程最新状态
- 基线分支存在且最新（如 develop、main）
- 合并状态验证（功能已集成）
- 祖先关系验证：确认候选分支为基线分支的祖先（fast-forward/rebase合并场景）
- 内容等价验证：确认候选分支相对基线无有效差异（squash 合并场景）
- 依赖关系检测
- 无未关闭/未合并的PR/MR指向候选分支
- CI/CD、部署配置、环境变量、脚本中不存在对候选分支名的显式依赖
- 无其他长期分支或子模块将候选分支作为上游
- 风险评估
- 候选分支最近提交时间已超过团队定义的缓冲期（如≥48小时，无新提交）
- 分支未被设置为受保护分支（Remote保护策略可能阻止删除）
- 候选分支无活跃里程碑/发布标记引用
- 回滚保障
- 为每个待删分支创建唯一的归档标签（annotated tag），包含原HEAD提交与时间戳
- 记录清单（分支名、HEAD SHA、归档tag、对应PR/MR、责任人/工单）
3. 分步骤操作指令
说明：
- 以下命令基于 Git 标准命令。删除操作均使用安全模式（本地 -d，远程 --delete），不使用强制删除。
- 将 TARGET_BASE 设置为功能最终合入的基线分支（示例给出 develop 和 main 双基线检测，择其一满足即可）。
步骤 0：环境准备
- 确认在主仓库根目录执行，Git 版本满足 2.20+。
- 建议在只读/只删除最小权限账户下执行远程删除（遵循最小权限原则）。
步骤 1：同步远程与定义变量
git fetch --all --prune
# 可能的基线（按项目实际确定）：
BASE_CANDIDATES=("develop" "main")
# 归档标签命名前缀（可按团队规范调整）
ARCHIVE_PREFIX="archive/branch"
# 日期戳
TS=$(date +%Y%m%d)
步骤 2：枚举候选分支（特性/实验性）
# 根据常见命名约定收集远程候选
git branch -r --list \
"origin/feature/*" \
"origin/feat/*" \
"origin/experiment/*" \
"origin/exp/*" > .candidates.txt
说明：若无统一命名，可结合组件目录、团队规则调整通配符；最终以内容校验为准。
步骤 3：基线存在性检查
> .bases.txt
for b in "${BASE_CANDIDATES[@]}"; do
if git show-ref --verify --quiet "refs/remotes/origin/$b"; then
echo "origin/$b" >> .bases.txt
fi
done
# 至少应存在一个基线
test -s .bases.txt
步骤 4：合并状态与内容等价验证（自动筛选可删清单）
> .deletable.txt
> .needs_review.txt
while read -r rb; do
# 远程分支短名，如 origin/feature/x -> feature/x
short="${rb#origin/}"
# 跳过无效引用
git show-ref --verify --quiet "refs/remotes/$rb" || continue
integrated=0
while read -r base; do
# 方式A：祖先关系（适用于FF/rebase合并）
if git merge-base --is-ancestor "refs/remotes/$rb" "$base"; then
integrated=1
break
fi
# 方式B：内容等价（适用于squash合并）
# 无差异则认为功能已集成
if git diff --quiet "$base...refs/remotes/$rb"; then
integrated=1
break
fi
done < .bases.txt
if [ $integrated -eq 1 ]; then
echo "$rb" >> .deletable.txt
else
echo "$rb" >> .needs_review.txt
fi
done < .candidates.txt
说明：
- .deletable.txt 为“已确认集成、可删除”列表。
- .needs_review.txt 为“存在差异或无法确认”的分支，需人工复核对应PR/MR与需求状态。
步骤 5：依赖与PR状态人工复核（必选）
- 对 .deletable.txt 中的每个分支：
- 确认无打开的 PR/MR 指向该分支，且相关PR状态为已合并/已关闭。
- 检查CI/CD、部署脚本、环境变量、文档等是否引用该分支名。
- 若有依赖，移除依赖或将该分支移入 .needs_review.txt 暂缓处理。
步骤 6：为每个可删分支创建归档标签（可回滚保障）
while read -r rb; do
short="${rb#origin/}"
head_sha=$(git rev-parse "refs/remotes/$rb")
# 创建带注解的归档标签，包含分支、来源、时间戳
tag="${ARCHIVE_PREFIX}/${short//\//_}-$TS"
git tag -a "$tag" "$head_sha" -m "Archive before deletion: $short at $head_sha on $TS (project: smart-home-gateway)"
# 推送单个归档标签
git push origin "refs/tags/$tag"
done < .deletable.txt
步骤 7：删除远程分支（安全删除）
while read -r rb; do
short="${rb#origin/}"
# 远程删除（非强制）。若远程保护启用，平台将拒绝，需按变更流程解除保护后再执行。
git push origin --delete "$short"
done < .deletable.txt
步骤 8：清理本地与远程跟踪引用
# 清理已失效的远程跟踪引用
git fetch --prune
git remote prune origin
# 可选：删除本地对应分支（若存在且已合并）
# 注：-d 为安全删除，未合并将被拒绝；不使用 -D。
while read -r rb; do
short="${rb#origin/}"
if git show-ref --verify --quiet "refs/heads/$short"; then
git branch -d "$short" || true
fi
done < .deletable.txt
步骤 9：产出统计与记录
echo "Candidates: $(wc -l < .candidates.txt)"
echo "Deletable: $(wc -l < .deletable.txt)"
echo "Review: $(wc -l < .needs_review.txt)"
- 记录项（建议写入变更单/仓库维护日志）：
- 分支名、原HEAD SHA、归档tag名、对应PR/MR链接、删除人、删除时间、审核人
4. 验证方案
成功标准
- 远程验证
- 对每个已删分支：git ls-remote --heads origin "<branch_name>" 返回空
- 归档tag存在：git ls-remote --tags origin "<ARCHIVE_PREFIX>/*" 可检索到对应标签
- 集成验证
- 使用与步骤4相同的内容等价校验，对应基线分支与被删分支 tip 的三点差异检查无差异：
- git diff --quiet origin/...<archived_sha> 结果为无差异
- CI/CD与部署
- 主干（develop/main）流水线运行成功
- 关键环境不出现因分支缺失导致的构建/部署失败
- 本地与远程引用清理
- git fetch --prune 后无“gone”分支残留
- git branch -r 不再显示已删除的远程分支
异常处理
- 远程删除被保护阻塞
- 按平台合规流程取消该分支的保护或通过变更审批后再执行步骤7
- 内容不等价或存在差异
- 将分支加入 .needs_review.txt，保留分支；由开发确认差异是否应保留或合并修复后再清理
- 误删或需恢复
- 通过归档标签恢复：
- git checkout -b <branch_name> <archive_tag>
- git push -u origin <branch_name>
- 本地分支删除被拒绝
- 保留本地分支，避免使用强制删除；待后续合并完成或人工确认后再删除
5. 注意事项（风险提示与最佳实践）
- 严禁使用强制删除命令（如 git branch -D、强推删除）。本流程仅使用安全删除选项。
- 使用归档标签进行快照保留，确保可逆；避免使用普通归档分支污染分支命名空间。
- 对采用 squash 合并的团队，必须以“内容等价”作为集成判断依据，不能仅依赖祖先关系。
- 在删除前完成PR/MR、CI/CD、部署脚本、环境变量的依赖核查，防止因分支名引用导致流程失败。
- 删除操作应具备审核与记录（变更单/维护日志），包含分支、SHA、tag、责任人、时间与关联工作项。
- 建议在低峰时段执行，并在执行后立即进行流水线与关键环境的健康检查。
- 多仓库/子模块场景需检查子模块引用的 commit 与分支不受影响；若有子模块引用分支名，先调整为固定 commit 再清理。
- 若团队采用受保护分支策略，应通过合规流程临时调整策略后再删除，避免权限绕过。
以上流程严格遵循Git常见工作流与安全删除原则，确保特性分支、实验性分支在“功能合并完成”后进行可控、可回滚的清理。
