Git 提交后如何修改用户名#
当提交 commit 后发现本地 git 配置中的 name 和 github 的用户名不一致，应该如何修改
需求情景#
在日常开发中，我们常遇到这样的场景：
本地 Git 初始化时配置了临时用户名（如
OldName），提交代码并推送到 fork 仓库的功能分支（如fix_typo），甚至发起了 PR 后，才发现该用户名与 GitHub 账号用户名（如muzimu）不一致；不一致的问题会导致：GitHub 上的 commit 作者名显示混乱，无法正常关联个人账号贡献统计，或不符合团队代码提交规范；
核心诉求：在PR 未合并、已提交多个 commit的前提下，批量修改历史 commit 的作者名，且不影响 PR 状态、无需重建 PR。
完整教程#
前提准备#
确认当前分支：执行
git branch，确保处于需要修改的功能分支（如fix_typo，即发起 PR 的分支）；确认远程仓库：执行
git remote -v，验证origin指向自己的 fork 仓库（而非原仓库），输出类似：
origin git@github.com:你的GitHub用户名/仓库名.git (fetch)
origin git@github.com:你的GitHub用户名/仓库名.git (push)
- 记录关键信息：
- 旧用户名：执行
git log，查看 commit 中Author:后的名称（如OldName）； - 新用户名：目标 GitHub 用户名（如
muzimu）； - 绑定邮箱：GitHub 账号绑定的邮箱
步骤 1：批量修改历史 commit 的作者名#
针对已提交多个 commit的场景，使用git filter-branch批量改写当前分支的所有 commit 作者信息，命令直接复制执行（仅需修改 3 个参数）：
# 批量修改当前分支所有commit的作者名和邮箱
git filter-branch --env-filter '
# 需修改的3个参数
OLD_NAME="你的旧Git名称"
NEW_NAME="你的GitHub用户名"
NEW_EMAIL="你的GitHub绑定邮箱"
# 无需修改以下内容
if [ "$GIT_COMMITTER_NAME" = "$OLD_NAME" ]; then
export GIT_COMMITTER_NAME="$NEW_NAME"
export GIT_COMMITTER_EMAIL="$NEW_EMAIL"
fi
if [ "$GIT_AUTHOR_NAME" = "$OLD_NAME" ]; then
export GIT_AUTHOR_NAME="$NEW_NAME"
export GIT_AUTHOR_EMAIL="$NEW_EMAIL"
fi
' -- --all
执行后终端显示
Rewrite xxx (x/x)代表正在改写 commit，最终提示Ref 'refs/heads/你的分支名' was rewritten即修改成功；若提示缓存冲突，先执行
rm -rf .git/refs/original/清除缓存，再重新运行上述命令。
步骤 2：安全强制推送到远程分支#
修改本地 commit 历史后，本地与远程分支记录不一致，需通过强制推送覆盖远程分支（PR 会自动同步）：
# 第一步：刷新本地缓存的远程分支信息（避免stale info错误）
git fetch origin 你的功能分支名 # 如git fetch origin fix_typo
# 第二步：安全强制推送（优先推荐，防止误覆盖）
git push --force-with-lease origin 你的功能分支名 # 如git push --force-with-lease origin fix_typo
# 备用方案：若上述命令仍报错，直接强制推送（仅自己开发的分支可用）
# git push -f origin 你的功能分支名
- 推送成功后，终端会提示
rewriting history或Total 0 (delta 0)。
步骤 3：验证修改效果#
本地验证：执行
git log，查看所有 commit 的Author:是否已更新为新用户名；远程验证：打开 GitHub 的 PR 页面，刷新后所有 commit 的作者名会同步更新，且能正常关联你的 GitHub 账号头像。
步骤 4：配置后续新提交默认用新用户名#
为避免后续新提交再次使用旧用户名，配置当前仓库或全局 Git 信息：
# 仅当前仓库生效（推荐，不影响其他仓库）
git config user.name "你的GitHub用户名"
git config user.email "你的GitHub绑定邮箱"
# 全局生效（所有本地仓库新提交均用此配置）
# git config --global user.name "你的GitHub用户名"
# git config --global user.email "你的GitHub绑定邮箱"
容易踩坑#
1. 强制推送报错「stale info」#
原因：本地缓存的远程分支信息与 GitHub 实际状态不一致，
--force-with-lease的安全机制拒绝推送；解决：先执行
git fetch origin 你的分支名刷新缓存，再重新推送。
2. 修改后 commit 无法关联 GitHub 账号#
原因：新配置的
user.email未绑定 GitHub 账号；解决：在 GitHub「Settings → Emails」中添加并验证该邮箱。