GitLab迁移至GitHub后，如何映射用户代码贡献？

一、如何手动映射GitLab与GitHub用户名？ #

GitHub没有提供直接的跨平台用户名手动映射工具，但可以通过修改仓库提交历史里的作者/提交者信息，让提交关联到对应的GitHub用户。操作步骤如下：

1. 确保本地安装了git filter-repo（这是GitHub推荐的替代git filter-branch的工具，更安全高效）
2. 构造mailmap规则，格式为：

   原GitLab用户名 <原GitLab提交邮箱> 目标GitHub用户名 <目标GitHub邮箱>
   

3. 执行命令重写提交历史：

   git filter-repo --mailmap <(echo "OldGitLabUser <old@company.com> NewGitHubUser <new@company.com>")
   

4. 强制推送到GitHub仓库：

   git push --force
   

注意： 重写仓库历史会覆盖远程仓库的提交记录，必须提前和团队成员沟通，让所有人重新克隆仓库，避免代码冲突。

二、GitHub自动映射用户的机制是什么？是否基于邮箱？ #

GitHub的自动映射完全基于提交中的邮箱地址：

• 仓库迁移到GitHub后，系统会遍历所有提交的作者/提交者邮箱
• 如果该邮箱已经被添加到某个GitHub账号的邮箱列表（包括公开或私密邮箱，且已验证），GitHub就会自动将该提交关联到对应的账号，显示账号的用户名和头像
• 如果提交里的邮箱未在任何GitHub账号中注册或验证，就会显示提交里的原始用户名（比如GitLab的用户名），无法关联到具体用户

三、添加工作邮箱到GitHub后是否会触发贡献映射更新？ #

会自动触发更新，但需要满足两个前提：

1. 提交里的邮箱和添加到GitHub的邮箱完全一致（包括大小写、拼写，不能有任何差异）
2. 该邮箱已经在GitHub账号中完成验证
   满足条件后，GitHub会在几分钟到几小时内自动重新扫描仓库提交历史，把对应的贡献关联到用户账号，不需要额外操作。如果长时间未更新，可以尝试刷新仓库的提交页面，或者检查邮箱是否正确关联。

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