如何从 git 存储库中删除作者？

Question

如果我创建一个 Git 存储库并公开发布它（例如在 GitHub 等上），并且我收到存储库贡献者的请求，无论出于何种原因删除或隐藏他们的名字，有没有一种方法可以轻松做到这一点？

基本上，我有过这样的请求，可能希望将他们的姓名和电子邮件地址替换为“匿名贡献者”之类的内容，或者可能是他们电子邮件地址的 SHA-1 哈希值或类似的内容。

Answer 1

Jeff 说得很对，正确的路线是 git filter-branch。它需要一个处理环境变量的脚本。对于您的用例，您可能想要这样的东西：

git filter-branch --env-filter '
    if [ "$GIT_AUTHOR_NAME" = "Niko Schwarz" ]; then \
        export GIT_AUTHOR_NAME="Jon Doe" GIT_AUTHOR_EMAIL="[email protected]"; \
    fi
    '

您可以测试它是否像这样工作：

$ cd /tmp
$ mkdir filter-branch && cd filter-branch
$ git init
Initialized empty Git repository in /private/tmp/filter-branch/.git/
$ 
$ touch hi && git add . && git commit -m bla
[master (root-commit) 081f7f5] bla
 0 files changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 hi
$ echo howdi >> hi && git commit -a -m bla
[master a466a18] bla
 1 files changed, 1 insertions(+), 0 deletions(-)
$ git log
commit a466a18e4dc48908f7ba52f8a373dab49a6cfee4
Author: Niko Schwarz <[email protected]>
Date:   Thu Aug 12 09:43:44 2010 +0200

    bla

commit 081f7f50921edc703b55c04654218fe95d09dc3c
Author: Niko Schwarz <[email protected]>
Date:   Thu Aug 12 09:43:34 2010 +0200

    bla
$ 
$ git filter-branch --env-filter '
> if [ "$GIT_AUTHOR_NAME" = "Niko Schwarz" ]; then \    
> export GIT_AUTHOR_NAME="Jon Doe" GIT_AUTHOR_EMAIL="[email protected]"; \
> fi
> '
Rewrite a466a18e4dc48908f7ba52f8a373dab49a6cfee4 (2/2)
Ref 'refs/heads/master' was rewritten
$ git log
commit 5f0dfc0dc9a325a3f3aaf4575369f15b0fb21fe9
Author: Jon Doe <[email protected]>
Date:   Thu Aug 12 09:43:44 2010 +0200

    bla

commit 3cf865fa0a43d2343b4fb6c679c12fc23f7c6015
Author: Jon Doe <[email protected]>
Date:   Thu Aug 12 09:43:34 2010 +0200

    bla

Answer 2

如果您不仅需要对某个用户，而且还需要对所有用户“匿名”git 存储库，Git 2.2（2014 年 11 月）提供了一项有趣的功能，其中改进和增强了 git fast-export：

参见 提交 a872275 和 提交 75d3d65 by Jeff King (peff)：

教学快速导出一个--anonymize选项：

有时，用户想要报告他们在存储库中遇到的错误，但他们无权共享存储库的内容。
如果他们能够生成一个与其历史和树具有相似形状的存储库，但不会泄漏任何信息，那将非常有用。
然后可以与开发人员共享这个“匿名”存储库（假设它仍然复制原始问题）。

此补丁为 fast-export 实现了“--anonymize”选项，该选项生成可以重新创建此类存储库的流。
生成单个流使调用者可以轻松验证他们没有泄漏任何有用的信息。您可以通过运行如下命令来概述将共享的内容：

git fast-export --anonymize --all |
perl -pe 's/\d+/X/g' |
sort -u |
less

这将显示我们生成的每个唯一行，对任何数字取模（每个匿名令牌都分配一个数字，例如“User 0”，并且我们在输出中一致地替换它）。

除了匿名化之外，这会生成相对较小（与原始存储库相比）且生成速度较快的测试用例（与使用 filter-branch 相比，或修改快速导出自己）

文档：

如果给出了--anonymize选项，git将尝试从存储库中删除所有标识信息，同时仍然保留足够的原始树和历史模式来重现一些错误。

使用此选项，git 将使用匿名数据替换输出中的所有引用名称、路径、blob 内容、提交和标记消息、名称和电子邮件地址。
同一字符串的两个实例将被等效替换（例如，同一作者的两次提交将在输出中具有相同的匿名作者，但与原始作者字符串没有相似之处）。
提交、分支和标签之间的关系以及提交时间戳是+保留的（但提交消息和引用名称与原始消息没有相似之处）。
树的相对组成将被保留（例如，如果您有一个包含 10 个文件和 3 棵树的根树，那么输出也会如此），但它们的名称和文件内容将被替换。

---

另请参阅 Git 2.28（2020 年第 3 季度），“git fast-export --anonymize” 学会了采用自定义映射，以允许用户调整其输出，使其更可用于调试。

请参阅提交f39ad38、提交 8a49495, 提交 d5bf91f，提交 6416a86，提交 55b0145, 提交 a0f6564、提交 7f40759、提交 750bb32, 提交 b897bf5，提交 b8c0689（2020 年 6 月 23 日），作者：杰夫·金 (peff)。
^{（由 Junio C Hamano -- gitster -- 合并于 提交 0a23331，2020 年 7 月 6 日）}

快速导出：允许播种匿名映射

^{帮助者：Eric Sunshine
签字人：杰夫·金}

对存储库进行匿名化后，可能很难找到原始版本和结果之间对应的提交，因此很难重现触发原始版本中错误的命令。

让我们能够播种匿名化映射。
这让用户可以：

• 如果他们不认为名称是秘密的，则将名称标记为按原样保留（在这种情况下，他们的原始命令将起作用）
• 将名称映射到新值，这使他们可以在不泄露原始名称的情况下将复制配方调整为新名称

实现相当简单。
我们已经将每个匿名令牌存储在哈希图中（以便出现两次的相同令牌将转换为相同的结果）。我们可以引入一个新的“种子”哈希图，首先会参考该哈希图。

这确实向用户做出了更多有关我们如何匿名化事物的承诺（例如，令牌分割路径名）。但即使单个令牌的实际匿名化发生变化，我们也不太可能想要改变这些规则。对于用户来说，这使事情变得更加容易，他们可以仅对目录名称进行取消隐藏，而无需指定其中的每个路径。

此方法的一种替代方法是根据我们认为合适的方式进行匿名化，然后将整个引用名和路径名映射转储到文件中。这确实有效，但使用起来有点尴尬（你必须手动从映射中挖掘出你关心的项目）。

git fast-export< /code> 现在有：

--anonymize-map=[:]:

将匿名输出中的标记 转换为 。
如果省略 ，则将 映射到自身（即，不对其进行匿名化）。

重现一些错误可能需要引用特定的提交或
路径，在引用名称和路径被修改后，这变得具有挑战性
匿名。
您可以要求保留特定令牌，或者
映射到新值。

例如，如果您有一个使用 git rev-listsensitive --secret.c 重现的错误，您可以运行：

<前><代码>-------------------------------------------------------- --------
$ git fast-export --anonymize --all \
--anonymize-map=sensitive:foo \
--anonymize-map=secret.c:bar.c \
>流
-------------------------------------------------- -

导入流后，您可以运行git rev-list foo -- bar.c
在匿名存储库中。

请注意，路径和引用名称在斜杠边界处被拆分为标记。
上面的命令会将 subdir/secret.c 匿名化为类似的内容
path123/bar.c;然后您可以在匿名中搜索 bar.c
存储库以确定最终路径名。

为了更简单地引用最终路径名，您可以映射每个路径
成分;因此，如果您还将 subdir 匿名化为 publicdir，那么
最终路径名将是 publicdir/bar.c。

---

在 Git 2.34（2021 年第 4 季度）之前，“ 的输出git fast-export"^{( man)}，在使用其匿名功能时，错误地显示了带注释的标签。

请参阅 提交 2f040a9（2021 年 8 月 31 日），作者：Tal Kelrich (hasturkun)。
^{（由 Junio C Hamano -- gitster -- 合并于 提交 febba80，2021 年 9 月 10 日）}

fast-export：使用修复匿名标签原始长度

^{签署人：Tal Kelrich}

提交7f40759（“快速导出：收紧 anonymize_mem() 接口以仅处理字符串”，2020-06-23，Git v2.28.0-rc0 -- 合并 列于 第 7 批) 更改了匿名字符串所使用的接口，但未能更新带注释的标签消息的大小以匹配新的匿名字符串。

因此，导出消息长度超过 13 个字符的标签将创建无法通过快速导入进行解析的输出，因为指示的数据长度大于数据输出。

在匿名时重置消息大小，并在测试中添加带有“长”消息的标签。

Answer 3

您可以在本地存储库中进行更改，git commit --amend 适当的提交（您添加名称的位置），然后git push --force 更新 github与您的存储库版本。

带有贡献者姓名的原始提交仍然可以在引用日志中找到（直到它过期，但是需要花费很多精力才能找到它。如果这是一个问题，您也可以从引用日志中删除该特定提交 - 请参阅git help reflog 了解语法以及如何在列表中找到它。

Answer 4

如果您想更改多个提交，请查看手册页

git filter-branch --env-filter

您可以使用 git-filter-branch 更改先前提交的内容/元。

请注意，由于您不处理本地分支（它已被推送到 github），因此您无法从任何已克隆您分支的人中删除作者。

修改已经发布的分支通常也是不好的做法，因为这可能会导致跟踪分支的人感到困惑。