GitLab提交贡献显示个人邮箱，如何修改为校园邮箱？

Git提交记录中展示的作者邮箱，并不直接关联你的GitLab账号登录邮箱，而是读取本地Git客户端配置的用户身份信息，这就是使用校园邮箱登录GitLab后，推送commit仍展示个人邮箱的根本原因。可按以下步骤完成调整：

1. 配置本地Git的提交身份（对后续新提交生效） #

• 先查看当前本地Git的全局邮箱配置，确认是否为个人邮箱：
  执行命令：git config --global user.email
• 全局替换为你的校园邮箱，所有本地新建仓库的提交都会使用该身份：
  执行命令：git config --global user.email "你的完整校园邮箱"
• 如果仅想对当前操作的单个仓库生效，可在仓库根目录执行不带全局参数的配置命令：
  git config user.email "你的完整校园邮箱"
• 配置完成后可重新执行查看命令，确认输出的地址和你的校园邮箱完全一致。
  注意：设置的校园邮箱必须和GitLab账号下已完成验证的邮箱地址完全匹配，才会被GitLab关联到你的账号，正常计入贡献统计。

2. 批量修正历史已提交的邮箱信息 #

仅修改本地配置不会改变已经推送过的历史commit绑定的个人邮箱，如果需要把历史提交的关联邮箱也替换为校园邮箱，可按以下步骤操作：

• 先在GitLab个人设置的邮箱列表中，确认你的校园邮箱已经完成所有权验证
• 在本地仓库根目录执行批量重写脚本，将所有历史提交里绑定的旧个人邮箱替换为校园邮箱：

  git filter-branch --env-filter '
  OLD_EMAIL="你的旧个人邮箱地址"
  CORRECT_NAME="你的GitLab账号显示名称"
  CORRECT_EMAIL="你的校园邮箱地址"
  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
  

• 脚本执行完成后，强制推送重写后的提交历史到远程仓库，覆盖原有记录：
  执行命令：git push --force --tags origin 'refs/heads/*'
  注意：强制推送会重写远程仓库的提交历史，如果仓库存在其他协作成员，需要提前同步操作，避免引发代码合并冲突。

3. GitLab侧的关联配置 #

• 不要随意删除GitLab账号下已关联的个人邮箱，保留该邮箱在已验证列表中，GitLab会自动把绑定该邮箱的所有历史提交都关联到你的个人账号，不会将这些贡献展示为未归属的个人提交。
• 可在个人设置的贡献统计页面，确认所有已验证邮箱对应的提交都已被纳入你的贡献计数范围。

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