如何通过GitLab Python API获取项目用户新旧用户名以关联提交记录

核心逻辑：放弃可变的author_name作为匹配依据，改用GitLab用户唯一不变的属性进行关联，具体实现方案如下：

方案1：邮箱匹配（首选，兼容性最高） #

• GitLab账号的邮箱为用户核心固定标识，修改用户名不会变更邮箱，且所有Git提交都会携带提交者邮箱，对应提交对象的.author_email属性
• 注意：如果项目用户设置了邮箱隐私，你需要确保调用GitLab接口的账号拥有读取用户邮箱的权限，否则无法获取完整邮箱列表
• 实现逻辑示例：

# 预构建「邮箱: 用户ID」映射字典
user_email_map = {}
for user in self.project.users.list(all=True):
    # 统一转小写避免大小写不匹配问题
    user_email_map[user.email.lower()] = user.id
    # 可选扩展：如果用户绑定了多个邮箱，可遍历user.emails.list()将所有邮箱加入映射

• 遍历提交时直接匹配即可：

for c in self.project.commits.list(all=True):
    commit_email = c.author_email.lower()
    # 匹配到则关联对应用户ID，未匹配到可标记为待后续人工补录
    related_user_id = user_email_map.get(commit_email)
    # 其余提交记录存储逻辑

方案2：直接调用GitLab提交自带的用户ID字段（适配平台内提交场景） #

• 所有通过GitLab网页、绑定了账号的客户端提交的记录，提交对象会自带.author_id属性，该值直接对应用户表的用户ID，无需额外字段匹配
• 可优先用该字段做匹配，匹配不到时再回退到邮箱匹配逻辑，进一步降低匹配误差

兜底兼容方案 #

• 提交表新增raw_author_name、raw_author_email字段，存储提交原始的作者名、邮箱信息，遇到匹配失败的记录先存储再定期人工核对补全关联
• 如果需要覆盖所有历史用户名匹配场景，可给用户表新增history_usernames字段，存储用户所有曾用名，匹配时增加曾用名的遍历逻辑即可

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