GitHub贡献图表不显示求助：历史提交未关联账户

核心原因 #

GitHub匹配Commit和账号的依据是Commit里的邮箱地址，必须和你GitHub账号绑定的邮箱完全一致。历史Commit用了不匹配的邮箱，就不会关联到你的账号，自然不显示头像和贡献记录。

修复步骤 #

1. 确认GitHub绑定的邮箱 #

先去GitHub账号设置里，查看已绑定的所有邮箱，确保你要用来关联Commit的邮箱在列表里（包括公开/私有邮箱）。

2. 同步本地Git配置 #

确保本地Git的用户名和邮箱与GitHub绑定的一致：

• 全局配置（所有仓库生效）：

  git config --global user.name "你的GitHub用户名"
  git config --global user.email "你绑定的GitHub邮箱"
  

• 单个仓库配置（仅当前仓库生效，优先级高于全局）：

  git config user.name "你的GitHub用户名"
  git config user.email "你绑定的GitHub邮箱"
  

3. 重写历史Commit的邮箱（关键） #

如果历史Commit用了错误的邮箱，需要批量修改所有历史记录的邮箱信息：

1. 在目标仓库根目录运行以下脚本（替换成你的旧邮箱、新邮箱和用户名）：

   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
   

2. 强制推送到远程仓库（注意：这会覆盖远程历史记录，若和他人协作需提前沟通）：

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

4. 验证结果 #

推送完成后等待几分钟，刷新GitHub页面，查看历史Commit是否显示头像，贡献图表是否更新。

额外注意事项 #

• 若Commit用了多个旧邮箱，需多次运行脚本逐一替换，或修改脚本批量处理。
• 私有邮箱也可关联Commit，GitHub会自动匹配，无需设置为公开。
• 首次莫名恢复大概率是之前的Commit邮箱偶然匹配到账号，或是GitHub缓存刷新导致。

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