【技术复盘】Git 分支污染与提交污染事故排查与解法

标签：Git 分支管理 事故复盘 最佳实践

1. 现象与问题

在进行需求 A 开发时，从本地切出分支 feature/demand-a 提交代码。但在推送远程及后续排查时发现异常：

远程推送被拒 ：执行 git push 提示 upstream 绑定到了无关分支 origin/feature/demand-b。
提交历史被污染 ：推送后，日志中掺杂了此前需求 B（未合并主干）的多个无关 Commit。
多出 Merge Commit ：提交树中生成了 Merge remote-tracking branch 'origin/feature/demand-a' into feature/demand-a，历史记录变得错综复杂。

2. 事故根因分析

本次事故是由于 "创建分支基线错误" + "Upstream 继承" + "不当 Merge" 叠加导致的连锁反应：

复制代码

[ master 主干 ]
      │
      ├───> [ feature/demand-b ] (需求 B 改动)
      │           │
      │           └───> [ 本地切出 feature/demand-a ] (错误基线！继承了需求 B 的改动与 Upstream)
      │                       │
      │                       ├──> 提交 1：e5f6a7b (需求 A 接口定义)
      │                       ├──> 提交 2：9b8c7d6 (需求 A 逻辑实现)
      │                       │
      │                       └───> 执行 git merge origin/feature/demand-a
      │                                   ↓
      │                             产生 Merge 包，打包带入需求 B 全部改动并强推远程！

分支基线选错 ：切新分支时未退回 master，直接在未合并的需求 B 分支上切出新分支，继承了其历史提交。
Upstream 错位 ：默认继承了上游分支映射，导致直接 git push 时因分支名不一致被拒绝。
不当 Merge 扩大污染：为解决推送问题强行合并远程分支，将"本地继承的污染提交"、"新需求提交"与"远程已有提交"打包合并，导致远程分支彻底被污染。

3. 挽救方案（分支重构）

核心思路："新建干净分支，精准拣选（Cherry-pick）目标提交，重置并强推覆盖"。

步骤 1：备份当前分支

bash 复制代码

git branch backup/feature-demand-a

步骤 2：基于主干拉取干净分支

bash 复制代码

git checkout master
git pull origin master
git checkout -b feature/demand-a-clean

步骤 3：Cherry-pick 目标提交

按时间顺序将属于需求 A 的两条 Commit 拣入干净分支（注意：Hash 不要带 <>）：

bash 复制代码

git cherry-pick e5f6a7b
git cherry-pick 9b8c7d6

步骤 4：重置本地分支并强制覆盖远程

bash 复制代码

# 重置原分支到干净状态
git checkout feature/demand-a
git reset --hard feature/demand-a-clean

# 强制推送覆盖远程并重新绑定 upstream
git push -f -u origin feature/demand-a

# 清理临时分支
git branch -D feature/demand-a-clean

4. 预防措施与最佳实践

切新分支必先回归干净主干 ：

bash 复制代码

git checkout master && git pull origin master && git checkout -b feature/xxx

首次推送显式绑定远程分支 ：
bash 复制代码
```
git push -u origin feature/xxx
```
慎用 git merge 解决推送冲突 ：特性分支优先使用 git pull --rebase，保持提交历史线性干净。
Push 前养成自检习惯 ：习惯使用 git log -n 5 或 git log --oneline --graph 确认即将推送的 commit 范围。

5. 常用速查命令

场景	命令	说明
退出 log 页面	`q`	退出 `git log` / `less` 视图
查看提交关系图	`git log --oneline --graph -n 10`	简洁查看近期提交树
精准拣选提交	`git cherry-pick <commit_hash>`	将指定 commit 复制到当前分支
强推覆盖远程	`git push -f -u origin <branch>`	用当前分支强制覆盖远程

复制代码