git过滤器分支的一个更安全的替代方案是git文档建议的过滤器回购工具。

git filter-repo --commit-callback '
  old_email = b"your-old-email@example.com"
  correct_name = b"Your Correct Name"
  correct_email = b"your-correct-email@example.com"
  
  if commit.committer_email == old_email :
    commit.committer_name = correct_name
    commit.committer_email = correct_email

  if commit.author_email == old_email : 
    commit.author_name = correct_name
    commit.author_email = correct_email
  '

上述命令反映了此脚本中使用的逻辑，但使用过滤器repo而不是过滤器分支。

提交后回调选项的代码体基本上是用于处理提交的python代码。您可以在这里用python编写自己的逻辑。请在此处查看有关提交对象及其属性的更多信息。

由于filter repo工具未与git捆绑，您需要单独安装它。

请参阅先决条件和安装指南

如果您有一个python-env>=3.5，可以使用pip来安装它。

pip3 install git-filter-repo

注意：强烈建议在新克隆上尝试使用过滤器回购工具。操作完成后，也会移除遥控器。阅读更多有关为什么删除遥控器的信息。另请阅读INTERNALS部分中此工具的限制。

一个带过滤器的衬里：

您可以使用gitfilter repo的回调功能（推荐替换过滤器分支）来更改与所有提交相关的名称和电子邮件：

git filter-repo --name-callback 'return b"New Name"' --email-callback 'return b"newemail@gmail.com"'

这比使用过滤器分支的解决方案性能更高，可能更可靠。

请注意，上面的命令会更改所有提交的作者（和提交者），如果您想有效地“编辑”某个作者，并且只修改该特定作者的提交，请使用--commit回调选项，如下所示：

git filter-repo --commit-callback '
old_email = b"oldemail@gmail.com"
new_email = b"newemail@gmail.com"
new_name = b"New Author"

if commit.author_email == old_email:
    commit.author_email = new_email
    commit.author_name = new_name

if commit.committer_email == old_email:
    commit.committer_email = new_email
    commit.committer_name = new_name
'

（只需将上面命令中的old_email、new_email和new_name变量更改为正确的值。）

我已经尝试了上面的脚本，但它不适合我，这解决了我的问题：

使用Git的“filter branch”命令。它允许您使用脚本批量处理（可能大量）提交。您可以在存储库中运行以下示例脚本（填写新旧电子邮件和名称的真实值）：

git filter-branch --env-filter '
WRONG_EMAIL="wrong@example.com"
NEW_NAME="New Name Value"
NEW_EMAIL="correct@example.com"

if [ "$GIT_COMMITTER_EMAIL" = "$WRONG_EMAIL" ]
then
    export GIT_COMMITTER_NAME="$NEW_NAME"
    export GIT_COMMITTER_EMAIL="$NEW_EMAIL"
fi
if [ "$GIT_AUTHOR_EMAIL" = "$WRONG_EMAIL" ]
then
    export GIT_AUTHOR_NAME="$NEW_NAME"
    export GIT_AUTHOR_EMAIL="$NEW_EMAIL"
fi
' --tag-name-filter cat -- --branches --tags

在此处查看更多详细信息

我们今天遇到了一个问题，作者名中的UTF8字符在构建服务器上造成了麻烦，因此我们必须重写历史记录来纠正这个问题。所采取的步骤包括：

步骤1：按照此处的说明，更改所有未来提交的git用户名：https://help.github.com/articles/setting-your-username-in-git/

步骤2：运行以下bash脚本：

#!/bin/sh

REPO_URL=ssh://path/to/your.git
REPO_DIR=rewrite.tmp

# Clone the repository
git clone ${REPO_URL} ${REPO_DIR}

# Change to the cloned repository
cd ${REPO_DIR}

# Checkout all the remote branches as local tracking branches
git branch --list -r origin/* | cut -c10- | xargs -n1 git checkout

# Rewrite the history, use a system that will preseve the eol (or lack of in commit messages) - preferably Linux not OSX
git filter-branch --env-filter '
OLD_EMAIL="me@something.com"
CORRECT_NAME="New Me"

if [ "$GIT_COMMITTER_EMAIL" = "$OLD_EMAIL" ]
then
    export GIT_COMMITTER_NAME="$CORRECT_NAME"
fi
if [ "$GIT_AUTHOR_EMAIL" = "$OLD_EMAIL" ]
then
    export GIT_AUTHOR_NAME="$CORRECT_NAME"
fi
' --tag-name-filter cat -- --branches --tags

# Force push the rewritten branches + tags to the remote
git push -f

# Remove all knowledge that we did something
rm -rf ${REPO_DIR}

# Tell your colleagues to `git pull --rebase` on all their local remote tracking branches

快速概述：将存储库签出到临时文件，签出所有远程分支，运行将重写历史记录的脚本，强制推送新状态，并告诉所有同事重新启动数据库以获取更改。

我们在OS X上运行它时遇到了问题，因为它在提交消息中以某种方式打乱了行结尾，所以我们不得不在Linux机器上重新运行它。

这个答案使用gitfilter分支，文档现在给出了这个警告：gitfilter分支有太多的缺陷，可能会对预期的历史重写造成不明显的影响（而且由于它的性能非常糟糕，因此几乎没有时间调查这些问题）。这些安全和性能问题不能向后兼容地解决，因此不建议使用。请使用其他历史筛选工具，如git filter repo。如果您仍然需要使用git过滤器分支，请仔细阅读安全（和性能）以了解过滤器分支的地雷，然后尽可能小心地避免列出的危险。

更改作者（或提交人）需要重写所有历史。如果您对此感到满意，并认为这是值得的，那么您应该查看gitfilter分支。手册页面包括几个示例，可帮助您入门。还要注意，您可以使用环境变量来更改作者、提交人、日期等的名称——请参阅git手册页面的“环境变量”部分。

具体来说，您可以使用以下命令修复所有分支和标记的所有错误作者名称和电子邮件（来源：GitHub帮助）：

#!/bin/sh

git filter-branch --env-filter '
OLD_EMAIL="your-old-email@example.com"
CORRECT_NAME="Your Correct Name"
CORRECT_EMAIL="your-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
' --tag-name-filter cat -- --branches --tags

对于使用替代历史过滤工具gitfilter repo，您可以首先安装它并根据gitmailmap的格式构造gitmailmap。

Proper Name <proper@email.xx> Commit Name <commit@email.xx>

然后使用创建的mailmap运行过滤器repo：

git filter-repo --mailmap git-mailmap

使用交互式rebase，您可以在每次提交后放置一个修改命令。例如：

pick a07cb86 Project tile template with full details and styling
x git commit --amend --reset-author -Chead