如何替换Git历史及合著者消息中的邮箱，不新建仓库且保留Issue/PR链接？

既然所有维护者都同意修改提交历史，完全可以通过Git的git filter-repo工具实现需求，且不会丢失Issue/PR关联，也无需新建仓库，具体步骤如下：

1. 克隆仓库完整镜像 #

先拉取仓库的镜像版本（包含所有分支、标签的完整历史）：

git clone --mirror <你的仓库远程URL>
cd <仓库名称>.git

2. 创建邮箱替换脚本 #

在镜像目录下创建一个脚本文件（比如replace-email.sh），同时处理提交的作者/提交者邮箱，以及提交消息中合著者字段里的邮箱：

#!/bin/sh
# 替换提交记录中的作者/提交者邮箱
git filter-repo --mailmap <<'EOF'
旧个人邮箱地址 新邮箱地址
EOF

# 替换提交消息中（比如Co-authored-by字段）的旧邮箱
git filter-repo --message-callback '
return msg.replace(b"旧个人邮箱地址", b"新邮箱地址")
'

把上面的旧个人邮箱地址和新邮箱地址替换成实际内容，保存后给脚本加执行权限：chmod +x replace-email.sh

3. 执行替换并验证 #

运行脚本执行替换：

./replace-email.sh

替换完成后，检查历史是否修改正确：

git log --all --pretty=format:"%h %an %ae %s"
# 也可以检查提交消息里的合著者字段
git log --all --grep="Co-authored-by"

4. 强制推送修改到远程仓库 #

因为修改了提交历史，必须强制推送覆盖远程的历史记录：

git push --force --all
git push --force --tags

5. 通知所有维护者同步本地仓库 #

所有协作的维护者需要更新他们的本地仓库，避免历史冲突：

• 先备份本地未提交的修改：git stash（或临时提交到分支）
• 拉取远程最新历史：git fetch origin
• 重置本地分支到远程最新版本（以main分支为例）：git reset --hard origin/main
• 若有stash的内容，恢复后重新提交：git stash pop

关键说明 #

• Issue/PR的关联不会丢失：GitHub会自动识别修改后的提交历史与原Issue/PR的关联，无需额外操作。
• 必须确保所有维护者完成本地仓库同步，否则后续提交会引发严重的历史冲突。
• 优先使用git filter-repo而非已废弃的git filter-branch，前者更高效且不易破坏仓库结构。

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