如何修改GitLab贡献者用户名且不丢失提交记录？

一、直接修改GitLab用户名（核心步骤） #

直接进入GitLab个人设置→「账户」页面，把用户名改成「姓名」格式即可。GitLab会自动处理旧用户名的重定向：

• 贡献者页面不会出现两个独立账号，所有指向旧用户名的链接都会跳转到新账号；
• 项目权限、群组归属会自动同步到新用户名，无需手动重新配置。

二、确保提交记录归属新用户名 #

GitLab关联提交记录的核心是邮箱地址，而非用户名，分两种情况处理：

1. 旧提交用的邮箱已绑定当前账号：无需额外操作，所有旧提交会自动归到新用户名名下，贡献统计也会合并计算。
2. 旧提交用了未绑定的邮箱：在GitLab个人设置→「邮箱」页面，添加该邮箱为关联邮箱（验证后生效），旧提交会自动关联到你的新账号。

注意：除非公司强制要求修改提交历史里的用户名显示，否则不要用git filter-branch这类工具改写提交历史——会破坏仓库的历史一致性，影响协作。

三、解决Git命令认证问题 #

1. 更新本地仓库的远程地址：
   如果之前用HTTPS方式克隆仓库，远程地址可能包含旧用户名，执行以下命令替换（替换成你的新用户名和仓库地址）：

   git remote set-url origin https://新用户名@gitlab.company.com/项目路径.git
   

   用SSH方式的话，只要SSH密钥已添加到新账号，无需修改地址，认证会自动生效。

2. 更新本地Git配置的用户名：
   避免新提交显示旧用户名，执行全局配置（单个仓库去掉--global）：

   git config --global user.name "你的新用户名"
   

3. 清理本地认证缓存：

   • Windows：打开「凭据管理器」，找到GitLab相关的旧凭据并删除；
   • macOS：打开「钥匙串访问」，搜索GitLab并删除旧的登录项；
   • Linux：删除~/.git-credentials文件里的旧记录。

四、额外注意事项 #

• 通知团队成员你的用户名变更，避免他们@错人或分享旧链接；
• 核对一下项目的权限、群组的成员身份，确认GitLab已完成自动同步（大概率不会出问题，但保险起见检查一遍）。

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