Git 提交后发现作者信息错了，如何安全修复已 push 的历史？

前言

提交并 push 完代码后，发现 Git 的 author name / email 设置错了，导致贡献记录、头像显示异常。

修复思路与步骤（已验证可行）

1. 永久修正本地配置（防后续出错）

   git config user.name "正确用户名"
   git config user.email "正确邮箱@example.com"
   

2. 修改最近几个 commit 的作者（小范围修复首选）

   git rebase -i HEAD~3   # 将要改的 commit 前 pick 改为 edit，保存退出
   

   Git 停在 edit commit 上：

   git commit --amend --author="正确用户名 <正确邮箱@example.com>" --no-edit
   git rebase --continue   # 重复直到完成
   

   完成后，git status 应显示在分支上（非 detached HEAD）。

3. 推送更新历史

   git push --force-with-lease origin main   # 优先用这个，更安全
   

常见坑与解决

• Detached HEAD 状态：amend 后若未 git rebase --continue，会卡住。
  直接运行 git rebase --continue 即可回到分支。

• 推送失败：protected branch 拒绝 force push
  最常见错误：
  GitLab: You are not allowed to force push code to a protected branch on this project
  或 pre-receive hook declined（钩子拒绝非 fast-forward 推送）。

  推荐处理方式（GitLab 13.5+ 支持）：

  1. 项目 → Settings → Repository → Protected branches（或 Branch rules）。
  2. 找到 main 分支（或匹配规则），点击编辑 / View details。
  3. 在 Allowed to force push 处开启开关（通常针对 Allowed to push 的角色，如 Maintainers）。
  4. 保存后立即推送：

     git push --force-with-lease origin main
     

  5. 推送成功后，立刻关闭该开关，恢复保护（避免误操作风险）。

  备选方式（如果无 “Allowed to force push” 选项，或版本较旧）：

  • 临时 Unprotect main 分支 → 推送 → 再 Protect 回来。
  • 或 push 到新分支：

    git push origin main:fix-author-branch
    

    然后创建 Merge Request，让 Maintainer 合并（更合规，但历史不会被重写成同一 commit）。

  权限不足时：找 Maintainer/Owner 帮忙临时调整规则或直接推送。

• 其他：多人协作时，优先避免 force push 改历史；只需头像/贡献正确，可把邮箱加到平台账号的 Emails 设置（平台主要认邮箱）。