前言

列位看官都知道，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 的信息掌握了正確的方法，就能很方便操作。記住，在共享倉庫中操作時，溝通是關鍵！希望這篇小文能在列位看官需要時有所幫助！

---