Git 时光机：修改Commit信息

前言

列位看官都知道，Git 的每一次 git commit，其中会包含作者（Author）和提交者（Committer）的姓名与邮箱。有时可能会因为配置错误、切换了开发环境，或者只是单纯的手滑，导致 commit 的作者信息不正确。

别担心，Git 提供了强大的工具来修正这些“历史遗留问题”。不过，请记住：修改 Git 历史是一项具有潜在风险的操作，尤其是当这些 commit 已经被推送到共享仓库时。 它会改变 commit 的 SHA-1 哈希值，可能影响团队协作。在操作前，请务必了解风险并做好备份。

修改场景与对应方案

根据不同场景修改的 commit 范围和位置，有不同的策略：

场景一：只修改最新的那一个 Commit

这是最简单的情况。如果刚刚提交，发现作者信息错了：

1. 确保 Git 配置正确：

   # 针对当前仓库设置
   git config user.name "Your Correct Name"
   git config user.email "your.correct.email@example.com"
   # 或全局设置
   # git config --global user.name "Your Correct Name"
   # git config --global user.email "your.correct.email@example.com"
   

2. 使用 git commit --amend：

   git commit --amend --reset-author --no-edit
   

   • --amend：修改上一个 commit。
   • --reset-author：使用当前 Git 配置中的 user 和 email 更新 Author 和 Committer 信息。
   • --no-edit：保持原有的 commit message 不变。

   如果想直接指定作者信息，而不是依赖配置：

   git commit --amend --author="Your Correct Name <your.correct.email@example.com>" --no-edit
   

场景二：修改最近的几个连续 Commit

如果需要修改最近几个连续的 commit，交互式 Rebase (git rebase -i) 是好帮手：

1. 启动交互式 Rebase：
   假设要修改最近的 3 个 commit：

   git rebase -i HEAD~3
   

   Git 会打开一个编辑器，列出这 3 个 commit。

2. 标记要编辑的 Commit：
   在编辑器中，将需要修改作者信息的每一行前面的 pick 改为 edit (或 e)。

   edit abcdef1 Commit message 1
   edit fedcba9 Commit message 2
   pick 1234567 Commit message 3  # 这个不改，保持 pick
   

   保存并关闭编辑器。

3. 逐个修改 Commit：
   Git 会暂停在第一个标记为 edit 的 commit 上。此时，可以：

   • 确保 Git 配置正确（同场景一的步骤 1）。
   • 使用 git commit --amend --reset-author --no-edit 来更新当前 commit 的作者信息。
   • 然后执行 git rebase --continue，Git 会继续到下一个标记为 edit 的 commit，重复此过程。

4. 完成 Rebase：
   当所有标记为 edit 的 commit 都处理完毕后，Rebase 完成。

场景三：修改任意位置的多个或所有 Commit

对于更复杂的批量修改，例如修改历史中特定作者的所有 commit，或者修正整个项目的作者信息，推荐使用 git filter-repo 工具。它比老旧的 git filter-branch 更快、更安全、更易用。

1. 安装 git filter-repo：

   pip install git-filter-repo
   

2. 备份您的仓库！ (重要！)

3. 执行修改：
   例如，将所有 old-email@example.com 的作者信息改为 New Name <new-email@example.com>：

   git filter-repo --env-callback '
   import os
   if os.environ.get("GIT_AUTHOR_EMAIL") == "old-email@example.com":
       os.environ["GIT_AUTHOR_NAME"] = "New Name"
       os.environ["GIT_AUTHOR_EMAIL"] = "new-email@example.com"
   # 如果需要，也可以类似地修改 GIT_COMMITTER_EMAIL 和 GIT_COMMITTER_NAME
   '
   

   git filter-repo 会遍历并重写 commit。您可以根据需要调整脚本逻辑，例如基于旧用户名判断等。
   如果需要修改所有分支和标签，可以添加 --all 参数。

   注意： git filter-branch 是另一个选择，但它更复杂且容易出错，一般不推荐新手使用。

修改历史后的重要一步：推送

当修改了本地的 commit 历史后，这些 commit 的 SHA-1 哈希值会发生改变。如果之前已经将这些 commit 推送到了远程仓库，直接 git push 会失败，因为本地历史和远程历史产生了分歧。

需要使用强制推送 (Force Push)：

git push origin your-branch-name --force

或者，一个更安全的选择是 --force-with-lease，它会检查远程分支在您上次拉取后是否被其他人修改过：

git push origin your-branch-name --force-with-lease

警告：强制推送会覆盖远程仓库的历史。请确保您了解其影响，并在团队协作中提前沟通！

小插曲：为什么 Rebase 后 push 提示 “Everything up-to-date”？

有时，在使用 git rebase -i 修改 commit（例如标记为 edit 来修改作者）的过程中，可能会尝试 push，却发现 Git 提示 Everything up-to-date，即使已经用 git commit --amend 修改了 commit。

这通常是因为：** Rebase 过程还没有完全结束！**

• 当使用 edit 时，Git 会在那个 commit 处暂停。
• 执行 git commit --amend 只是修改了当前这个暂停的 commit。
• 当前分支指针（例如 main 或 dev）此时尚未移动到这个新生成的 commit 链上。 它仍然指向 Rebase 开始前的旧 commit。
• 因此，Git 比较本地分支指针和远程分支指针时，发现它们指向同一个（旧的）commit，自然认为一切都是最新的。

解决方案：

1. 完成对当前 edit commit 的修改后，务必执行：

   git rebase --continue
   

2. 如果还有其他 edit 的 commit，重复修改和 git rebase --continue 的过程。
3. 直到整个 Rebase 过程成功结束（git status 不再显示 “rebase in progress”），当前分支指针才会更新到新的 commit 历史。
4. 此时，再进行强制推送，就能成功将修改后的历史推送到远程了。

结语

修改 Git commit 的信息掌握了正确的方法，就能很方便操作。记住，在共享仓库中操作时，沟通是关键！希望这篇小文能在列位看官需要时有所帮助！