误删关联GitHub的邮箱后，如何恢复提交贡献记录？

核心逻辑 #

GitHub贡献墙是通过提交里的邮箱地址，匹配账号关联邮箱来统计的。重新注册邮箱后，需要让GitHub识别旧提交的邮箱属于你的账号，或者修正提交中的邮箱地址。

具体操作步骤 #

1. 确认旧提交使用的邮箱
   在本地仓库的终端运行命令，查看所有提交的作者邮箱：

   git log --pretty=format:"%h %an %ae"
   

   从中找到你之前用来提交代码的旧邮箱地址。

2. 把旧邮箱添加到GitHub账号关联列表
   进入GitHub账号设置的「Emails」页面，点击「Add email address」，输入旧邮箱并完成验证。添加后，GitHub会自动重新扫描你的所有提交，将匹配旧邮箱的贡献记录关联到你的账号，这个过程可能需要等几分钟。

3. 若旧邮箱无法验证，修改仓库历史中的邮箱地址
   如果旧邮箱已被他人注册无法验证，就需要把仓库历史里的旧邮箱替换成当前GitHub关联的邮箱：

   • 先安装git filter-repo（替代已弃用的git filter-branch）：
     • Linux：sudo apt install git-filter-repo
     • macOS：brew install git-filter-repo
     • Windows：通过Chocolatey安装choco install git-filter-repo
   • 在本地仓库终端运行替换命令，将旧邮箱地址和新邮箱地址替换为实际值：

     git filter-repo --email-callback 'return email if email != b"旧邮箱地址" else b"新邮箱地址"'
     

   • 强制推送到远程仓库（注意：此操作会覆盖远程仓库的提交历史，若为协作仓库请提前告知队友）：

     git push --force origin main
     

   推送完成后，GitHub会重新统计你的贡献记录。

注意事项 #

• 强制推送会修改远程仓库的历史，其他协作者需要重新拉取并同步本地仓库。
• 若操作的是fork的仓库，修改后可能需要重新提交PR或联系原仓库维护者。

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