# 【Git】 修改历史 commits 中的用户名和邮箱
> 如何批量修改 git 历史提交记录中的 username 和 email。
> 原文：https://www.thexqf.top/article/2023/3/16/96.html
## 一、作用

- 修改某个仓库历史 commit 的用户 name 和 email 信息。
- 将历史提交记录中的指定 name/email 修改为新的 name/email。

## 二、步骤

- 确认本地全局邮箱/用户名
- 查看仓库的历史提交信息
- 批量修改历史记录中的信息
- 将修改结果推送到远程

### 1. 确认本地全局邮箱/用户名

使用下面两个命令查看 git 在本地的全局邮箱和用户名。

`git config user.name git config user.email`

如果需要修改 git 在本地的全局邮箱和用户名，执行下面的命令。

git config --global user.name "输入你的用户名" 
git config --global user.email "输入你的邮箱"

现在我们已经设置好了本地 git 的 user.name 和 user.email 信息。

### 2. 查看仓库的历史提交信息

`git clone` 你要修改的仓库，进入该仓库目录，打开 git bash 界面，执行 `git log` 命令查看历史提交信息（重点关注 Author）。

### 3. 批量修改历史记录中的信息

打开一个文本编辑器，粘贴下面代码。
然后把 OLD_EMAIL，CORRECT_NAME，CORRECT_EMAIL 改成自己的新旧邮箱用户名。

git filter-branch -f --env-filter '
OLD_EMAIL="原来的邮箱"
CORRECT_NAME="现在的名字"
CORRECT_EMAIL="现在的邮箱"
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

回到 git bash 界面，复制粘贴上面的代码并按回车执行。
等待执行完成后，再查看 `git log` 可以看到已经修改成功。

特殊情况：
如果上面的批量修改命令执行失败的话，执行一下这段命令：

`git filter-branch -f --index-filter 'git rm --cached --ignore-unmatch Rakefile' HEAD`

再次复制粘贴批量修改的代码并按回车执行。

### 4. 将修改结果推送到远程

这时候虽然本地修改成功了，但是你还没有推送到远程。
所以再执行一下命令：

`git push origin --force --all`

去看一下 Github 你就会发现之前的提交记录中，name 和 email 信息都更新了。

## 三、Linux/Mac下可以写个脚本

在项目根目录下创建 `git-email.sh`，写入下面这段代码：

#!/bin/sh
git filter-branch --env-filter '
OLD_EMAIL="原来的邮箱"
CORRECT_NAME="现在的名字"
CORRECT_EMAIL="现在的邮箱"
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

然后需要赋予执行权限：

`chmod +x git-email.sh`

执行一下这个 `.sh` 文件：

`./git-email.sh`

`git log` 检查修改成功后，最后别忘了推送到远程仓库。