如何补录未记录的GitHub贡献？过往提交能否关联至仓库贡献列表？

核心结论 #

可以把过往贡献关联到你的邮箱，但需要重写仓库的提交历史——这是破坏性操作，必须先和团队沟通确认再执行。

具体操作步骤 #

1. 先备份仓库
   先克隆仓库到本地，同时远程仓库也要做好备份，避免操作失误丢数据：

   git clone <仓库地址>
   cd <仓库目录>
   

2. 批量修改提交的身份信息
   在仓库目录下运行以下脚本，把空邮箱的提交替换成你正确的GitHub身份信息（替换脚本里的用户名和邮箱）：

   git filter-branch --env-filter '
   OLD_EMAIL=""
   CORRECT_NAME="你的GitHub用户名"
   CORRECT_EMAIL="你的GitHub绑定邮箱"
   if [ "$GIT_COMMITTER_EMAIL" = "$OLD_EMAIL" ]
   then
       export GIT_COMMITTER_NAME="$CORRECT_NAME"
       export GIT_COMMITTER_EMAIL="$CORRECT_EMAIL"
   fi
   if [ "$GIT_AUTHOR_EMAIL" = "$OLD_EMAIL" ]
   then
       export GIT_AUTHOR_NAME="$CORRECT_NAME"
       export GIT_AUTHOR_EMAIL="$CORRECT_EMAIL"
   fi
   ' --tag-name-filter cat -- --branches --tags
   

   这个脚本会遍历所有分支和标签的提交，把作者、提交者为空的邮箱统一替换成你正确的信息。

3. 强制推送到远程仓库
   因为修改了历史记录，需要强制覆盖远程仓库的内容：

   git push --force --tags origin 'refs/heads/*'
   

   注意：强制推送会完全覆盖远程仓库的历史，团队里所有人都得重新克隆仓库，不能拉取旧历史合并，否则会触发大量冲突。

4. 验证结果
   操作完成后等GitHub重新统计贡献，一般几个小时后，仓库的贡献者列表里就会显示你的过往提交。

补充说明 #

• 个人主页贡献图显示绿色，是因为GitHub识别了提交的本地用户信息，但仓库贡献者列表只统计和GitHub账号绑定邮箱匹配的提交，所以之前没显示。
• 如果是公司组织的私有仓库，操作前一定要和管理员、团队成员沟通好，确认不会打乱现有工作流程。

内容的提问来源于stack exchange，提问作者Mr.Nivek