GitHub贡献者识别机制及TFS Git仓库迁移后协作者自动添加方法

关于GitHub显示TFS迁移贡献者的原因 #

你的推测完全正确。GitHub识别仓库贡献者的核心逻辑是匹配Git提交历史里的user.email字段——它会把提交记录中的邮箱和GitHub平台已注册的用户账号做关联，如果该邮箱对应到某个GitHub用户（且用户属于你的组织），就会自动将其纳入仓库的贡献者列表。

而协作者是GitHub仓库的权限角色，需要明确授予仓库读写/管理权限，和提交历史里的贡献者没有自动绑定关系，这就是为什么贡献者不会直接成为协作者的原因。目前GitHub官方文档确实没有单独针对TFS迁移场景的这条说明，但这是Git仓库在GitHub上的通用规则。

自动将贡献者添加为协作者的方法 #

完成git clone和git push迁移后，GitHub没有内置的一键自动添加功能，但可以通过GitHub CLI或API脚本批量处理：

方法1：使用GitHub CLI（gh） #

1. 先确保已安装并登录GitHub CLI：

   gh auth login
   

2. 从Git提交历史提取所有唯一贡献者的邮箱：

   git log --format='%ae' | sort | uniq > contributors_emails.txt
   

3. 遍历邮箱列表，逐个添加为协作者（需仓库管理员权限）：

   while read email; do
     # 通过邮箱查找GitHub用户名
     username=$(gh api search/users -q "email:${email}" --jq '.items[0].login')
     if [ -n "$username" ]; then
       gh repo collaborator add <你的GitHub仓库路径> $username --permission push
       echo "已添加 $username 为协作者"
     else
       echo "未找到邮箱 $email 对应的GitHub用户"
     fi
   done < contributors_emails.txt
   

   提示：将<你的GitHub仓库路径>替换为实际路径（如org-name/repo-name），--permission push可根据需求改为pull或admin。

方法2：使用GitHub API编写Python脚本 #

1. 先获取带repo权限的GitHub个人访问令牌
2. 编写脚本批量处理：

   import subprocess
   import requests
   
   # 配置参数
   REPO = "org-name/repo-name"
   TOKEN = "你的GitHub令牌"
   PERMISSION = "push"  # 可选值：pull, push, admin
   
   # 提取唯一贡献者邮箱
   result = subprocess.run(
       ["git", "log", "--format='%ae'"],
       capture_output=True,
       text=True
   )
   emails = sorted(list(set(result.stdout.replace("'", "").splitlines())))
   
   # 遍历添加协作者
   headers = {"Authorization": f"token {TOKEN}"}
   for email in emails:
       # 查找对应GitHub用户
       search_url = f"https://api.github.com/search/users?q=email:{email}"
       response = requests.get(search_url, headers=headers)
       if response.status_code == 200 and response.json()["total_count"] > 0:
           username = response.json()["items"][0]["login"]
           # 添加协作者
           add_url = f"https://api.github.com/repos/{REPO}/collaborators/{username}"
           data = {"permission": PERMISSION}
           add_response = requests.put(add_url, json=data, headers=headers)
           if add_response.status_code == 201:
               print(f"成功添加 {username} 为协作者")
           else:
               print(f"添加 {username} 失败: {add_response.json()['message']}")
       else:
           print(f"未找到邮箱 {email} 对应的GitHub用户")
   

   提示：替换REPO、TOKEN和PERMISSION为实际值。

注意事项 #

• 只有拥有仓库管理员权限的账号才能执行添加协作者操作
• 部分贡献者的邮箱可能未在GitHub注册，这类用户无法被添加，脚本会自动跳过
• 如果是组织仓库，需确保用户已加入组织（否则需先邀请加入组织，再添加为协作者）

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