使用git filter-branch命令修改历史提交_git-filter-repo如何修改提交账号-优快云博客

本文介绍了修改Git仓库用户信息的三种方法，同时列举了修改提交人信息的常见场景，包括团队协作、误配置修正、企业合规、开源贡献规范以及仓库合并迁移等情况。文中特别强调修改历史提交可能带来的风险，建议操作前备份仓库并与团队沟通。

1、修改本地仓库的用户名信息

2、修改远程仓库的用户名信息

3、修改已经提交的代码中的作者信息

运行环境：

Windows-10-BusinessEditions-22h2-x64、CentOS-7.9-x64
Git for Windows 2.25.0.1-x64

1、修改本地仓库的用户名信息

修改本地仓库的用户名信息（如：提交作者名、邮箱地址），可以使用 git config 命令。

全局修改（注：影响所有仓库）：

git config --global user.name "新的用户名"
git config --global user.email "新的邮箱地址"

局部修改（注：仅影响当前仓库）：

git config user.name "新的用户名"
git config user.email "新的邮箱地址"

2、修改远程仓库的用户名信息

修改远程仓库的用户名（如在GitHub、GitLab等平台上的用户名），你需要做的是：更改远程仓库的URL，实际上是更改你本地仓库与远程仓库的连接信息。

使用以下命令：

git remote set-url origin https://新用户名@github.com/新用户名/仓库名.git

3、修改已经提交的代码中的作者信息

通常不推荐更改已经提交的代码的作者信息，因为这会破坏代码的历史记录。但如果确实需要这样做，可以使用 git filter-branch 或 git rebase 命令。

使用以下命令：

# 修改已提交的git用户名
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

执行过程：

WARNING: git filter-branch has a glut of gotchas generating mangled history
rewrites. Hit Ctrl-C before proceeding to abort, then use an
alternative filtering tool such as 'git filter-repo'
(https://github.com/newren/git-filter-repo/) instead. See the
filter-branch manual page for more details; to squelch this warning,
set FILTER_BRANCH_SQUELCH_WARNING=1.

警告：

使用 git filter-branch 会重写历史，建议在执行前备份的仓库。而且，如果你的仓库已经被其他人拉取或合并了，这种方法可能会导致问题。建议，最好先与团队成员沟通，并考虑

其他方法（如添加一个贡献者说明）。