Git 历史提交修复：3步批量修改作者信息，找回 GitHub 绿格子贡献

Git历史提交修复3步批量修改作者信息找回GitHub贡献记录看着GitHub个人主页上那些空白的贡献格子就像日历上被撕掉的页面——明明付出了努力却无法被世界看见。这种挫败感每个开发者都深有体会。但别担心那些丢失的绿格子完全可以找回来。1. 为什么GitHub不统计我的贡献GitHub的贡献统计系统远比想象中复杂。当你的提交没有显示为绿色格子时通常意味着GitHub无法将这些提交与你的账户关联起来。以下是几种常见原因邮箱不匹配本地Git配置的邮箱未添加到GitHub账户默认分支外提交只在非默认分支非main/master工作Fork仓库提交在fork的仓库而非原始仓库提交协作仓库权限没有该仓库的push权限最隐蔽的问题往往出在邮箱配置上。Git提交包含两个关键身份信息Author: Your Name your.emailexample.com Committer: Your Name your.emailexample.comGitHub只会统计符合以下条件的提交提交邮箱必须与GitHub账户验证邮箱之一匹配提交必须在独立仓库非fork的默认分支提交时间在最近一年内2. 三步骤修复历史提交2.1 准备工作确认问题范围首先检查哪些提交未被统计git log --pretty%h - %an, %ae : %ad --dateshort输出示例a1b2c3d - John Doe, wrong.emailold.com : 2023-05-01 e4f5g6h - John Doe, correct.emailgithub.com : 2023-05-02记录下错误邮箱和正确邮箱OLD_EMAILwrong.emailold.com CORRECT_NAMEYour GitHub Username CORRECT_EMAILyour.githubemail.com提示在GitHub设置 → Emails页面可以查看所有已验证邮箱2.2 核心操作重写历史使用git filter-branch批量修改作者信息git filter-branch --env-filter 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参数说明--env-filter修改环境变量作者信息--tag-name-filter同时更新标签--branches --tags处理所有分支和标签2.3 验证与推送检查修改结果git log --prettyformat:%h %an %ae -5强制推送到远程仓库git push --force --tags origin refs/heads/*警告此操作会重写历史确保你是唯一使用该仓库的人或已通知所有协作者3. 高级场景处理方案3.1 多邮箱批量替换当存在多个错误邮箱时使用脚本批量处理#!/bin/bash declare -A email_map( [old1email.com]new1github.com [old2email.com]new2github.com ) for old_email in ${!email_map[]}; do new_email${email_map[$old_email]} git filter-branch --env-filter if [ $GIT_COMMITTER_EMAIL $old_email ] then export GIT_COMMITTER_EMAIL$new_email fi if [ $GIT_AUTHOR_EMAIL $old_email ] then export GIT_AUTHOR_EMAIL$new_email fi --tag-name-filter cat -- --branches --tags done3.2 仅修改特定时间段的提交添加时间范围限制git filter-branch --env-filter if [ $GIT_COMMITTER_EMAIL $OLD_EMAIL ] [ $(date -d $GIT_COMMITTER_DATE %s) -ge $(date -d 2022-01-01 %s) ] [ $(date -d $GIT_COMMITTER_DATE %s) -le $(date -d 2022-12-31 %s) ] then export GIT_COMMITTER_NAME$CORRECT_NAME export GIT_COMMITTER_EMAIL$CORRECT_EMAIL fi --tag-name-filter cat -- --branches --tags3.3 处理大型仓库的优化技巧对于大型仓库使用git replace和git filter-repo更高效# 安装git-filter-repo pip install git-filter-repo # 创建替换引用 git replace --graft $(git commit-tree -p HEAD^{tree} -m 修正作者信息 \ --author$CORRECT_NAME $CORRECT_EMAIL) HEAD # 永久化修改 git filter-repo --force --replace-refs delete-and-add4. 贡献恢复效果验证操作完成后GitHub通常需要24小时更新统计。可以通过以下方式验证访问https://github.com/users/[username]/contributions检查个人主页的贡献图表使用GitHub API查询curl -s https://api.github.com/users/[username]/events | grep -A5 -i push常见问题解决问题现象可能原因解决方案部分提交仍未显示邮箱未验证在GitHub设置中添加邮箱所有提交消失强制推送冲突协调团队重新克隆仓库贡献图表闪烁缓存未更新等待24小时或联系GitHub支持记得在项目README中添加维护者说明## 贡献者须知 本仓库使用以下规范维护提交历史 - 作者邮箱必须使用GitHub验证邮箱 - 非main分支的提交需通过PR合并 - 禁止直接修改已推送的历史记录那些曾经丢失的代码贡献现在应该已经重新点亮了你的GitHub日历。每当看到整齐的绿色格子都会想起这段修复历史的经历——它不仅找回了统计数字更找回了开发者应有的荣誉感。