Git修改commit作者信息的完整指南

一、修改最新commit的作者信息

1.1 仅修改最后一次提交

git commit --amend --author="NewAuthor <new.email@example.com>"

1.2 同时修改日期

git commit --amend --author="NewAuthor <new.email@example.com>" \
--date="$(date -R)"

二、批量修改历史commit作者信息

2.1 使用filter-branch（适用于简单项目）

git filter-branch --env-filter '
OLD_EMAIL="old.email@example.com"
CORRECT_NAME="NewAuthor"
CORRECT_EMAIL="new.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 -- --all

2.2 使用git-filter-repo（推荐方式）

# 先安装git-filter-repo
pip install git-filter-repo

# 执行批量修改
git filter-repo --mailmap my-mailmap-file

my-mailmap-file内容示例：

# 格式：正确姓名 <正确邮箱> <旧邮箱>
NewAuthor <new.email@example.com> <old.email@example.com>

三、交互式修改特定commit

3.1 使用rebase交互模式

git rebase -i HEAD~5  # 修改最近5个提交

在编辑器中将要修改的commit前的pick改为edit，保存退出后执行：

git commit --amend --author="NewAuthor <new.email@example.com>"
git rebase --continue

四、验证修改结果

4.1 检查特定commit

git show --pretty=fuller COMMIT_HASH

4.2 查看所有作者信息

git log --format="%h %an <%ae> %ad" --date=iso

五、强制推送到远程仓库

git push --force  # 适用于个人分支
git push --force-with-lease  # 更安全的强制推送

六、团队协作注意事项

6.1 风险提示

pie
    title 修改历史commit的风险
    "代码丢失" : 35
    "协作混乱" : 45
    "构建中断" : 20

6.2 最佳实践

1. ​个人分支​：可自由修改未合并的commit
2. ​共享分支​：需团队协商后操作
3. ​公共历史​：避免修改已推送的主干分支

七、自动化脚本方案

7.1 批量修改脚本

#!/bin/bash
# change-authors.sh

OLD_EMAIL="old.email@example.com"
NEW_NAME="NewAuthor"
NEW_EMAIL="new.email@example.com"

git filter-branch -f --env-filter "
if [ \"\$GIT_COMMITTER_EMAIL\" = \"$OLD_EMAIL\" ]
then
    export GIT_COMMITTER_NAME=\"$NEW_NAME\"
    export GIT_COMMITTER_EMAIL=\"$NEW_EMAIL\"
fi
if [ \"\$GIT_AUTHOR_EMAIL\" = \"$OLD_EMAIL\" ]
then
    export GIT_AUTHOR_NAME=\"$NEW_NAME\"
    export GIT_AUTHOR_EMAIL=\"$NEW_EMAIL\"
fi
" --tag-name-filter cat -- --all

八、特殊情况处理

8.1 仅修改特定时间段的commit

git filter-branch --env-filter '
if [ "$GIT_COMMITTER_EMAIL" = "old.email@example.com" ] && 
   [ "$GIT_COMMITTER_DATE" > "2020-01-01" ]
then
    export GIT_COMMITTER_NAME="NewAuthor"
    export GIT_COMMITTER_EMAIL="new.email@example.com"
fi
' -- --all

8.2 修改合并commit的作者

git filter-branch --commit-filter '
if [ "$GIT_AUTHOR_EMAIL" = "old.email@example.com" ];
then
    git commit-tree "$@" \
        -p <父commit1> -p <父commit2> \
        --author="NewAuthor <new.email@example.com>";
else
    git commit-tree "$@";
fi' HEAD

九、恢复误操作

9.1 找回原始引用

git reflog  # 查找操作前的HEAD位置
git reset --hard HEAD@{n}  # 回退到指定位置

9.2 从备份恢复

git clone file:///path/to/backup/.git  # 使用备份仓库恢复

十、企业级解决方案

10.1 使用pre-receive钩子校验

#!/usr/bin/env python3
# .git/hooks/pre-receive

import sys
import re

allowed_domains = ['company.com', 'corp.com']

for line in sys.stdin:
    old, new, ref = line.strip().split()
    commits = os.popen(f"git rev-list {old}..{new}").read().splitlines()
    
    for commit in commits:
        author = os.popen(f"git show -s --format='%ae' {commit}").read().strip()
        if not any(author.endswith(domain) for domain in allowed_domains):
            print(f"拒绝包含非法作者邮箱({author})的提交")
            sys.exit(1)

10.2 Git服务器集成方案

方案	功能特点	适用场景
GitLab CI	提交时自动校验作者信息	全平台企业部署
GitHub Actions	PR时检查作者邮箱域名	云端托管项目
Gerrit	代码审核时强制验证	大型代码审查系统

关键注意事项：

1. ​修改公共历史的风险​：会改变commit hash值，影响所有协作者
2. ​备份的重要性​：操作前务必git clone --mirror备份仓库
3. ​法律合规性​：某些开源项目要求签名提交(Signed-off-by)不可更改
4. ​审计要求​：金融等行业可能需要保留原始作者信息

对于团队项目，建议采用.mailmap文件实现显示名称的映射，而不实际修改历史记录：

# .mailmap文件示例
NewAuthor <new.email@example.com> <old.email@example.com>

这种方式可以在git log中显示正确的作者信息，同时保留原始提交元数据。