如何修改已推送Git提交历史的作者邮箱及注意事项

交互式rebase操作已推送分支的核心风险 #

• 历史重写会变更所有受影响提交的哈希值：从第一个被修改的提交开始，后续所有子提交（含合并提交）的哈希都会重新计算，和原有远端分支历史完全不兼容
• 团队不同步会直接导致修复失效：如果成员基于本地旧的分支副本继续开发推送，会把已经修复的无效邮箱提交重新合并进分支，所有修复操作作废
• 参数错误会丢失合并历史：如果rebase时不加保留合并提交的参数，原有分支的合并拓扑会被打平，甚至出现代码丢失、重复冲突的问题，操作前必须做分支备份

前置准备（必须全部完成后再操作） #

• 通知全员暂停team_branch_a的所有推送、拉取操作，修复期间禁止任何针对该分支的操作
• 本地拉取最新远端分支代码，创建备份分支兜底：

  git checkout team_branch_a
  git pull origin team_branch_a
  git branch backup/team_branch_a_pre_fix
  

• 定位第一笔无效邮箱提交的哈希，记为<first_bad_commit>，再找到它的前一个正常提交哈希，记为<last_good_base_commit>

具体修复操作 #

因为分支里包含5笔合并提交，必须加--rebase-merges参数启动交互式rebase，否则合并历史会丢失：

1. 启动交互式rebase：

   git rebase -i --rebase-merges <last_good_base_commit>
   

2. 弹出的编辑界面里，找到所有8笔作者邮箱无效的提交，把提交前的pick改成edit，合并提交如果邮箱无效也按同样方式标记，确认其他提交保持pick状态后，保存退出编辑器
3. 流程会逐个停在你标记为edit的提交上，每停一次就执行命令修正当前提交的作者信息，把名称和邮箱替换为正确值：

   git commit --amend --author="正确作者名 <your_valid_email@company.com>" --no-edit
   

   修正完成后执行git rebase --continue，直到所有标记的提交全部处理完成
   如果过程中遇到冲突，正常解决冲突后执行git add <冲突文件路径>，再执行git rebase --continue即可，不要额外执行commit操作

批量修改技巧：如果8笔无效提交都是同一个错误邮箱，不需要逐个标记edit，可以直接用批量替换命令一次性修正所有匹配的提交，效率更高：

git filter-branch --env-filter '
if [ "$GIT_AUTHOR_EMAIL" = "你的错误无效邮箱地址" ];
then
    GIT_AUTHOR_NAME="正确作者名"
    GIT_AUTHOR_EMAIL="your_valid_email@company.com"
fi
export GIT_AUTHOR_NAME
export GIT_AUTHOR_EMAIL
' -- <last_good_base_commit>..HEAD

4. 修复完成后校验所有提交的作者信息，执行命令查看区间内所有提交的作者名和邮箱，确认没有无效邮箱：

   git log --pretty=format:"%h | %an | %ae" <last_good_base_commit>..HEAD
   

5. 本地触发一次sanity校验，确认所有提交校验通过后，执行安全强推覆盖远端分支：

   git push --force-with-lease origin team_branch_a
   

   不要直接用--force强推，--force-with-lease会自动检查远端分支是否和你最后拉取的版本一致，如果有人没收到通知偷偷推了代码会直接拒绝推送，避免代码意外丢失

修复后团队同步规则 #

重写远端历史后，禁止成员直接执行普通git pull同步，普通pull会把本地旧历史和远端新历史做合并，把无效邮箱的旧提交重新带回分支，必须按以下方式同步：

• 所有本地存有旧team_branch_a副本的成员，执行以下命令重置本地分支：

  git fetch origin
  git checkout team_branch_a
  git reset --hard origin/team_branch_a
  

• 如果有成员本地在旧分支上存有未推送的新提交，先把提交导出为补丁，切到重置后的最新分支上再应用补丁，不要直接在旧分支上做合并操作
• 确认全员同步完成后，再恢复team_branch_a的正常推送权限

方案对比说明 #

之前考虑的切新分支全量复制代码的方案，会把20笔提交的所有变更压缩成1个新提交，完全丢失提交溯源、变更记录，后续排查问题、回滚特定提交都无法进行；上述rebase/批量filter的方案可以100%保留原有提交的代码变更、合并拓扑关系，仅修正错误的作者邮箱字段，不会损失任何历史信息。

内容的提问来源于stack exchange，提问作者Vespene Gas