如何修改Git历史合并提交标题中的旧用户名

你要修改的内容是合并提交的提交说明（commit message）文本，之前使用的filter-branch脚本仅修改了提交元数据中的作者、提交者名称与邮箱字段，没有处理提交说明内的文本内容，因此会残留旧用户名。

以下两种方法都可以在完整保留提交历史的前提下批量替换所有提交（包括PR合并提交）说明中的旧用户名，操作前务必备份本地仓库，避免历史改写出错无法回滚。

方法1：使用git-filter-repo（官方推荐） #

git-filter-repo是Git官方目前推荐的历史改写工具，相比老旧的filter-branch执行效率更高、出错概率更低，适合这类批量历史修改场景：

• 先备份本地仓库：
  cp -r 你的仓库本地路径 仓库备份路径
• 安装git-filter-repo，大部分系统的软件源可直接安装，也可直接将官方脚本放入系统PATH目录使用。
• 在仓库根目录新建文本文件replace-rule.txt，写入替换规则，格式为旧内容==>新内容：

OLD-USER-NAME==>你的新用户名

如果担心误匹配其他内容，可以把规则写得更精准，只匹配PR合并记录里的固定片段：

from OLD-USER-NAME/==>from 你的新用户名/

• 在仓库根目录执行过滤命令：
  git filter-repo --replace-message replace-rule.txt
  命令会遍历所有提交记录，自动替换提交说明中匹配规则的文本，不会改动你之前已经修正过的作者、提交者信息，完整保留所有提交链路。
• 检查本地提交历史确认替换无误后，强制推送所有分支和标签到远程即可：
  git push origin --force --all --tags

方法2：扩展原有filter-branch脚本 #

如果你不想额外安装工具，可以在你原来的脚本基础上增加--msg-filter参数，通过sed批量替换提交说明中的旧用户名，修改后的完整脚本如下：

#!/bin/sh

git filter-branch --env-filter '
OLD_EMAIL="你的旧邮箱@example.com"
CORRECT_NAME="你的正确用户名"
CORRECT_EMAIL="你的正确邮箱@example.com"

if [ "$GIT_COMMITTER_EMAIL" = "$OLD_EMAIL" ]
then
    export GIT_COMMITTER_NAME="$CORRECT_NAME"
    export GIT_COMMITTER_EMAIL="$CORRECT_EMAIL"
fi
if [ "$GIT_AUTHOR_EMAIL" = "$OLD_EMAIL" ]
then
    export GIT_AUTHOR_NAME="$CORRECT_NAME"
    export GIT_AUTHOR_EMAIL="$CORRECT_EMAIL"
fi
' --msg-filter 'sed "s/OLD-USER-NAME/你的新用户名/g"' --tag-name-filter cat -- --branches --tags

脚本中新增的--msg-filter配置会对每一条提交的说明文本执行sed替换，覆盖所有普通提交和合并提交的commit message，执行完成后检查历史无误同样强制推送到远程即可。

注意事项 #

• 历史改写操作会变更所有受影响提交的哈希值，如果仓库有其他协作者，需要通知对方重新拉取改写后的历史，避免出现历史分叉。个人作品集仓库无协作者的话无需额外处理。
• 替换规则建议尽量精准，避免误改提交说明中其他和旧用户名重名的无关内容。

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