如何批量修改 Git 提交记录中的作者名称和邮箱

适用场景：

已经提交了N个commit才发现用的配置(user.name 和 user.email)错了，比如要用个人邮箱的，用成了公司邮箱。基于隐私考虑，我们需要把公司邮箱和昵称替换掉。

主要是用到git-filter-repo的CALLBACKS功能

参考文档 https://htmlpreview.github.io/?https://github.com/newren/git-filter-repo/blob/docs/html/git-filter-repo.html#CALLBACKS

方法很简单：

#将所有用户名中包含的foo替换成ttys3 （注意，不支持中文)
git filter-repo --name-callback 'return name.replace(b"foo", b"ttys3")'

#将所有commit信息的email中包含的 [email protected] 替换成 [email protected]
git filter-repo --email-callback 'return email.replace(b"[email protected]", b"[email protected]")'

如果是中文，则不能用 bytes, 要用 string 然后再 encode, 如:

#将所有用户名中包含的 "旧名称" 替换成 "新名称"
git filter-repo --name-callback 'return name.replace("旧名称".encode(), "新名称".encode())'

你不能直接对 CJK 字符使用 b"xxxxxxx" , 不然你会收到 git-filter-repo 提示 "SyntaxError: bytes can only contain ASCII literal characters" 的 python 语法错误

注意：

替换是部分匹配的，因此注意使用尽可能长的子串
操作会重写所有被匹配到的commit, 因此，如果repo已经push到了远程仓库时，操作要慎重

refs

https://github.com/newren/git-filter-repo/issues/383#issuecomment-1189511149