Github仓库转移后贡献不显示？两种解决方法详解

2025-01-06 03:55:54

Github 仓库转移后贡献不显示的问题

仓库从一个 Github 账户转移到另一个账户后，之前的贡献没有正确显示，这是个常见的问题。这通常是因为贡献提交时使用的邮箱地址和新账户关联的邮箱地址不一致所致。Github 根据提交邮箱来识别用户，而不是根据 Github 用户名。因此，即使你转移了仓库，之前的提交仍然与旧账户的邮箱相关联。

为什么会出现这种情况？

当用户提交代码时，Git 会记录提交者的信息，包括姓名和电子邮件地址。这个电子邮件地址会影响 Github 如何识别和展示提交贡献。如果转移前的仓库使用了一个非 Github 关联的私人邮箱或 Github 生成的 <user>@users.noreply.github.com 隐私邮箱地址提交，就会导致新的账户看不到这些贡献。

解决方案

要解决这个问题，你需要采取以下方法，将历史提交的电子邮件地址更改为新的 Github 账户相关联的邮箱。

1. 使用 `git filter-branch` （有风险，需谨慎）

git filter-branch 可以重写提交历史，允许我们批量修改提交信息。但需要注意，这个命令会改写历史，可能会导致协作困难，如果多个协作者共享该分支。如果只有一个用户，或团队可以协作删除并重建受影响的提交和分支，那么使用该方案也未尝不可。建议在操作前做好备份。

操作步骤:

首先，进入本地仓库：

git clone <仓库URL>
cd <仓库目录>

接着，执行 git filter-branch 命令。假设旧的邮箱是old-email@example.com，新的邮箱是 new-email@example.com，需要替换 old-email@example.com 以及 New Name <new-email@example.com> 两个部分:

git filter-branch -f --env-filter '
OLD_EMAIL="old-email@example.com"
NEW_NAME="New Name"
NEW_EMAIL="new-email@example.com"
if [ "$GIT_AUTHOR_EMAIL" = "$OLD_EMAIL" ];
then
    export GIT_AUTHOR_NAME="$NEW_NAME"
    export GIT_AUTHOR_EMAIL="$NEW_EMAIL"
fi
if [ "$GIT_COMMITTER_EMAIL" = "$OLD_EMAIL" ];
then
    export GIT_COMMITTER_NAME="$NEW_NAME"
    export GIT_COMMITTER_EMAIL="$NEW_EMAIL"
fi
' -- --all

这段命令查找所有使用old-email@example.com 的提交，并将作者姓名、作者邮箱，提交者姓名和提交者邮箱修改成新的邮箱地址，最后参数 all 代表会影响所有分支的提交历史。

然后，将修改推送到 Github 。因为提交历史已经被改写，必须使用--force --all 参数强制推送，必须确保理解并执行了这个步骤的意义和后果：
```
 git push --force --all
```

原理:

这个命令会遍历仓库的每一次提交，检查提交者和作者的邮箱。如果发现匹配旧邮箱的提交，就会将其替换为新的信息。这种方法会永久改变你的仓库历史，需要小心操作，确保提前做好备份，并在了解影响之后操作。

安全提示:

执行前必须做好备份，确保本地代码以及远程仓库的提交可以恢复。
团队协作时，一定要通知所有协作者，因为改写历史会导致后续合作非常困难，需要清理其他成员的提交历史才能统一到更新后的分支。
使用强制推送，这会重写远程分支历史，务必在确定影响并能承担后果的情况下使用。

2. 添加旧邮箱到 Github 账户

这个方法不改写提交历史，而是简单地将旧的邮箱地址添加到新的 Github 账户上。这样，Github 会识别到这个旧邮箱的提交是你的贡献。这是一个安全且低风险的选项。

操作步骤:

登录你的新 Github 账户。
进入 Settings > Emails.
在“Add email address”处，输入旧的电子邮件地址 (old-email@example.com).
点击 “Add”按钮。 Github 通常会要求你验证该邮箱。
根据提示验证新的邮箱，通常需要访问邮箱收取并点击验证链接。
等待 Github 处理完毕，几分钟或几个小时后应该可以在仓库的贡献列表中看到相关提交。

原理：

这个方法的工作原理很简单。当 Github 发现一个未知的提交邮箱时，它不会将其贡献展示。当你将这个邮箱关联到你的新账户后，Github 会认为该邮箱对应的所有提交也都是你的贡献。

安全提示:

确认旧邮箱是你本人可以访问和控制的邮箱。
任何可以控制此邮箱的人都可以修改仓库里的内容，所以应该做好保护措施，如果旧邮箱有安全隐患，应该使用第一个方法彻底替换历史提交记录。
这个方案通常需要一段时间才能更新 Github 的贡献显示，不必着急。

选择哪种方法？

如果旧邮箱可以被你控制并且可以添加到新 Github 账户，那么添加旧邮箱到 Github 账户可能是最安全简单的选项。它的优点是不修改提交历史，不会对其他协作者造成影响。
如果你无法访问旧邮箱，或者想要彻底替换历史中的邮箱地址，git filter-branch 就是一个替代方案，但是风险较高，需要谨慎使用，理解潜在影响，以及做好备份措施。