如何退回commit：深度解析Git版本回溯的各種情境與最佳實踐

Byadmin

如何退回commit：深度解析Git版本回溯的各種情境與最佳實踐

在軟體開發的日常中，Git已成為不可或缺的版本控制工具。它賦予開發者強大的能力，可以追蹤、管理程式碼的每一次變更。然而，人非聖賢，孰能無過？有時候，我們可能會意外地提交（commit）了錯誤的程式碼、不完整的變更，或是將敏感資訊納入版本歷史中。在這些情況下，「如何退回commit」就成為了一個關鍵且必須掌握的技能。這篇文章將深入探討Git中退回commit的各種方法，並根據不同的使用情境提供具體、詳細的指導，幫助您安全、有效地回溯版本。

為何需要退回Commit？常見的場景

理解「為何需要退回commit」是掌握相關技巧的第一步。以下是一些您可能需要執行版本回溯的常見場景：

  • 提交了錯誤的程式碼： 可能是不小心將開發中的bug提交上去，導致專案無法正常運作。
  • 提交了不完整的變更： 某次提交的程式碼只完成了部分功能，但不應該被視為一個完整的版本。
  • 包含了敏感資訊： 不小心將API金鑰、密碼或其他敏感配置資訊提交到公開的程式碼倉庫。
  • 撤銷某個特定功能： 某個新功能上線後發現問題，需要將其相關的所有變更都撤銷。
  • 整理提交歷史： 在推送（push）到遠端倉庫之前，想將多個零碎的提交合併成一個，或撤銷一些無關緊要的提交，使提交歷史更清晰。

針對不同的需求和情境，Git提供了多種退回commit的策略。選擇正確的方法至關重要，因為錯誤的操作可能會導致程式碼丟失，甚至破壞團隊的協作流程。

Git退回Commit的主要方法與操作步驟

Git提供了幾種強大的指令來處理commit的回溯，其中最常用且重要的包括git revert、git reset和git commit --amend。理解它們之間的核心差異是安全操作的關鍵。

1. 使用 git revert：安全地撤銷已推送（Pushed）的Commit

git revert 是在公開或共享分支上撤銷commit的最安全、推薦方式。它不會刪除任何歷史記錄，而是創建一個新的commit來撤銷指定commit所引入的變更。這意味著即使該commit已經被推送到遠端倉庫，使用git revert也不會破壞共享的歷史，非常適合多人協作的專案。

運作原理

  • git revert <commit_hash> 會找到指定commit所做的所有變更，然後創建一個「反向」的變更，並將這些反向變更作為一個新的commit提交到您的歷史記錄中。
  • 它保留了原始的歷史記錄，因為它沒有刪除任何commit，只是增加了新的commit。
  • 適用於任何commit，無論它是否已推送到遠端倉庫。但它尤其適合處理已推送的commit。

操作步驟

  1. 找到要撤銷的Commit哈希值：
    您需要知道您想要撤銷的commit的唯一哈希值（通常是前7位或更多）。使用git log指令可以查看提交歷史。

    git log --oneline
    這會顯示一個簡潔的提交歷史，類似這樣：
    a1b2c3d (HEAD -> main) feat: add new feature
    e4f5g6h fix: resolve bug in login
    h9i0j1k initial commit
    假設您想撤銷e4f5g6h這個提交。

  2. 執行 git revert 指令：
    輸入您要撤銷的commit的哈希值。

    git revert e4f5g6h

    執行此指令後，Git會打開您的預設文字編輯器（如Vim或Nano），讓您編輯新的revert commit的提交訊息。預設的訊息通常會說明這個新的commit是為了撤銷哪個commit而創建的。

    儲存並關閉編輯器後，Git會自動創建一個新的commit，其中包含撤銷e4f5g6h所引入的變更。

  3. 推送到遠端倉庫：
    如果這是您在共享分支上的操作，您需要將這個新的revert commit推送到遠端倉庫。

    git push origin <your-branch-name>

優點

  • 安全： 不會重寫歷史，因此在團隊協作環境下非常安全。
  • 可追溯： 撤銷操作本身也是一個commit，歷史記錄清晰，便於追蹤。
  • 靈活： 可以撤銷歷史上的任何一個commit，即使它不是最新的commit。

缺點

  • 會增加新的commit，可能使提交歷史顯得冗長。
  • 如果被撤銷的commit後續又有其他相關的commit，可能會產生衝突。

2. 使用 git reset：強效但危險地重寫本地歷史

git reset 是一個功能強大但需要謹慎使用的指令，因為它會重寫提交歷史。它通常用於撤銷尚未推送到遠端倉庫的本地commit。一旦commit被重置，它就可能從歷史中消失（除非透過git reflog找回），這在共享環境中可能導致嚴重的問題。

運作原理

  • git reset 會將您的HEAD指針以及您當前的分支指針移動到指定的commit。
  • 它有三種主要模式：--soft、--mixed（預設）和--hard，它們決定了重置後工作目錄和暫存區的狀態。
  • 適用於本地未推送的commit。

git reset 的三種模式

a. git reset --soft <commit_hash>
  • HEAD指針移動： 將HEAD指針和當前分支指針移動到指定的commit。
  • 工作目錄： 不變，保持所有文件內容不變。
  • 暫存區（Staging Area）： 將指定commit之後的所有變更都移回到暫存區。
  • 適用場景： 您想撤銷最近的幾個commit，但又想保留這些變更，以便重新組合提交（例如，將多個小提交合併為一個）。

操作步驟範例：

  1. 假設您最近有三個提交，想撤銷最後兩個：
    A -- B -- C -- D (HEAD -> main)
    您想回到B的狀態，但保留C和D的變更。
  2. 執行：git reset --soft B
  3. 結果：HEAD指向B，C和D的變更現在都在暫存區，您可以重新git commit。
b. git reset --mixed <commit_hash> (預設模式)
  • HEAD指針移動： 將HEAD指針和當前分支指針移動到指定的commit。
  • 工作目錄： 不變，保持所有文件內容不變。
  • 暫存區： 將指定commit之後的所有變更都移回到工作目錄（未暫存）。
  • 適用場景： 您想撤銷最近的幾個commit，並且將這些變更退回到工作區，類似於git add .之前的狀態。這是最常用的reset模式。

操作步驟範例：

  1. 延續上面的例子，您想回到B的狀態，並且將C和D的變更退回到工作目錄（未暫存）。
  2. 執行：git reset --mixed B 或 git reset B
  3. 結果：HEAD指向B，C和D的變更現在都在工作目錄中，您需要重新git add . 和 git commit。
c. git reset --hard <commit_hash> (最危險模式)
  • HEAD指針移動： 將HEAD指針和當前分支指針移動到指定的commit。
  • 工作目錄： 會被完全覆寫為指定commit的狀態，所有未提交的變更（包括工作區和暫存區）都將永久丟失。
  • 暫存區： 會被完全清除，與指定commit的狀態一致。
  • 適用場景： 您確定要完全丟棄最近的幾個commit以及所有相關的未提交變更。務必小心使用！ 通常在您確定所有當前變更都不需要時才使用。

操作步驟範例：

  1. 延續上面的例子，您想回到B的狀態，並且完全丟棄C和D的所有變更。
  2. 執行：git reset --hard B
  3. 結果：HEAD指向B，您的工作目錄和暫存區將完全回溯到B這個commit時的狀態，C和D的變更將消失。

git reset 的優點與缺點

  • 優點：
    • 強大且靈活，能夠精確控制回溯的粒度。
    • 能夠重寫歷史，使提交歷史看起來更整潔（在未推送前）。
  • 缺點：
    • 極度危險： 尤其--hard模式會永久丟失未提交的變更。
    • 不適用於已推送的Commit： 如果重置已經推送到遠端倉庫的commit，會導致歷史分叉，迫使您強制推送（git push --force），這會對團隊成員造成困擾，因為他們的歷史將與您的不同步。

警告： 在共享專案中，切勿對已推送到遠端倉庫的commit使用git reset，除非您非常清楚自己在做什麼，並已與團隊溝通，否則會破壞其他人的本地倉庫。

3. 使用 git commit --amend：修改最近的Commit (尚未推送)

git commit --amend 嚴格來說，它不是「退回」commit，而是「修改」或「替換」最近的一個commit。它允許您在不創建新commit的情況下，對上一個commit進行微調，例如修改提交訊息、添加漏掉的文件或移除錯誤添加的文件。

運作原理

  • 它會將您當前暫存區中的所有變更，與上一個commit的變更合併，然後用這個新的組合替換掉上一個commit。
  • 結果是：一個新的commit會取代舊的那個commit，就好像舊的從未存在過一樣（因為它的哈希值會改變）。
  • 只能用於尚未推送到遠端倉庫的最新commit。 一旦推送到遠端，就不要使用此方法，否則同樣會導致歷史分歧。

操作步驟

  1. 修改文件或暫存文件：
    如果您忘記添加某些文件，或想修改已提交的文件內容。進行您所需的更改，並將它們添加到暫存區。

    git add <file-name> 或 git add .

  2. 執行 git commit --amend：

    git commit --amend

    執行後，Git會再次打開您的預設文字編輯器，顯示上一個commit的訊息。您可以修改這個訊息。

    儲存並關閉編輯器後，Git會用新的commit替換掉上一個commit。新的commit將包含您當前暫存區中的變更，以及上一個commit中的變更。

  3. 僅修改提交訊息：
    如果您只想修改上一個commit的提交訊息，而沒有其他文件變更，直接執行：

    git commit --amend --no-edit
    這會重用舊的提交訊息，您無需進入編輯器。

優點

  • 保持提交歷史的整潔，避免為了小修改而產生額外的commit。
  • 非常適合在推送到遠端倉庫前，對最後一個commit進行修訂。

缺點

  • 只能修改最新的、尚未推送的commit。
  • 一旦被修改的commit已經推送到遠端，使用此方法會導致歷史分叉，應避免。

4. 使用 git reflog：尋找和恢復「丟失」的Commit

雖然git reflog本身不是一個「退回commit」的指令，但它是您在不小心使用git reset --hard或進行其他危險操作後，找回「丟失」commit的救命稻草。它記錄了HEAD指針在本地倉庫中的所有移動歷史。

運作原理

  • git reflog 顯示了您本地倉庫中所有分支和HEAD的歷史變動記錄。
  • 即使一個commit不再被任何分支引用，只要它仍在reflog中，您就可以找回它。
  • 這些記錄是有時效性的（通常預設為90天）。

操作步驟

  1. 查看Reflog：

    git reflog
    您會看到類似這樣的輸出：
    a1b2c3d (HEAD -> main) HEAD@{0}: commit: add new feature
    e4f5g6h HEAD@{1}: commit: fix: resolve bug in login
    ...
    f7g8h9i HEAD@{5}: reset: moving to HEAD~2

    其中HEAD@{數字}代表了HEAD在過去的某個時間點。HEAD@{0}是當前HEAD的位置，HEAD@{1}是上一個位置，依此類推。

  2. 找到您想恢復的狀態：
    從reflog輸出中找到您想要恢復的那個commit的哈希值或HEAD@{數字}引用。
  3. 恢復到該狀態：
    使用git reset --hard或git checkout指令來回到那個狀態。

    例如，如果您想回到HEAD@{1}的狀態（即e4f5g6h這個commit），可以執行：
    git reset --hard HEAD@{1}
    或直接使用哈希值：
    git reset --hard e4f5g6h

    注意： 使用git reset --hard會丟棄當前工作區和暫存區的所有變更，直接回到指定commit的狀態。如果只想查看而不修改當前分支，可以使用git checkout <commit_hash>。

優點

  • 提供了一個強大的安全網，可以在您犯錯時恢復「丟失」的commit。

缺點

  • 只在本地倉庫有效，無法找回已經從遠端倉庫刪除的commit。
  • reflog有時效性，過期的commit可能無法找回。

如何選擇正確的退回Commit方法？

在眾多選項中選擇正確的退回commit方法至關重要。以下是一個決策流程圖，可以幫助您做出判斷：

決策流程：退回Commit的方法選擇

1. 您的Commit是否已推送到遠端倉庫（Pushed）？

  • 如果「是」（已推送）：

    • 請使用 git revert <commit_hash>。
      這是最安全的選擇，它會創建一個新的commit來撤銷先前的變更，不會破壞共享歷史。您需要將這個新的revert commit推送到遠端。
  • 如果「否」（僅在本地倉庫）：
    請繼續評估您的需求。

    • 您想修改最近的那個Commit嗎（例如，修改提交訊息或添加遺漏的文件）？

      • 如果「是」：
        請使用 git commit --amend。
        它會將您當前的變更與上一個commit合併，替換掉舊的commit。
    • 您想撤銷最近的一個或多個Commit，並決定如何處理這些變更嗎？

      • 如果「想保留這些變更，放入暫存區，以便重新提交」：
        請使用 git reset --soft <commit_hash>。
        HEAD指針移動，變更保留在暫存區。
      • 如果「想保留這些變更，放入工作目錄，從頭開始重新整理」：
        請使用 git reset --mixed <commit_hash> (預設)。
        HEAD指針移動，變更退回到工作目錄（未暫存）。
      • 如果「想完全丟棄這些Commit及其引入的所有變更（工作目錄和暫存區）」：
        請使用 git reset --hard <commit_hash>。
        極度危險！ 會永久丟失數據。只有在您確定完全不需要這些變更時才使用。
    • 您不小心執行了git reset --hard或其他操作，導致某些Commit「消失」了，想找回來？

      • 請使用 git reflog 查找歷史記錄，然後配合 git reset --hard HEAD@{數字} 或 git checkout <commit_hash> 來恢復。

退回Commit的最佳實踐與注意事項

掌握了Git退回commit的技術固然重要，但遵循最佳實踐和了解注意事項能確保您在實際開發中更加安全和高效。

1. 永遠先確認狀態

在執行任何退回操作之前，務必先使用git status查看當前工作區和暫存區的狀態，確保沒有未提交的重要變更。同時，使用git log查看提交歷史，確認要操作的commit哈希值。

2. 理解 revert 與 reset 的根本差異

這是最核心的區別：

  • git revert：非破壞性操作，創建一個新的commit來撤銷變更，保留歷史，適合已推送的commit。
  • git reset：破壞性操作，重寫歷史，移除commit，適合本地未推送的commit。--hard會丟棄變更，--soft/--mixed會保留變更在工作區或暫存區。

3. 在共享分支上避免 git reset

如果commit已經推送到遠端倉庫並被其他團隊成員拉取（pull），請絕對不要使用git reset。這會導致您和團隊成員的歷史不一致，強制推送（git push --force）將會覆寫遠端歷史，這會給團隊協作帶來混亂，甚至導致他人工作進度丟失。

4. 先備份，再操作

如果您對操作結果不確定，或者變更非常重要，可以考慮在執行退回操作前先創建一個新的分支來備份當前的狀態：

git branch backup-before-reset

這樣即使操作失誤，您仍然可以從備份分支恢復。

5. 善用 git reflog

git reflog是您的救星。即使您不小心git reset --hard移除了commit，只要在reflog的有效期內（預設90天），您通常都可以找回並恢復這些commit。

6. 溝通是關鍵

在多人協作的專案中，如果您需要對共享歷史進行操作（例如，必須使用git push --force的情況），請務必提前與您的團隊成員溝通，說明您將進行的操作及其影響。

7. 在沙盒環境中練習

如果您是Git新手，或對某個指令不熟悉，強烈建議在一個獨立、非生產的Git倉庫中進行練習，熟悉這些指令的行為和結果，直到您完全理解為止。

常見問題（FAQ）

如何知道我的commit是否已經推送到遠端倉庫了？

您可以使用git status命令。如果它顯示您的本地分支「ahead of ‘origin/your-branch-name’ by X commits」，則表示有X個commit尚未推送。如果沒有顯示此訊息或顯示「Your branch is up to date with ‘origin/your-branch-name’」，則表示您的本地分支與遠端分支同步，所有commit都已推送。更直接的方法是使用git log，查看遠端分支（如`origin/main`）的指向，如果您的commit在`origin/main`之後，則表示尚未推送。

為何git reset --hard會被認為很危險？

git reset --hard被認為危險，因為它會無情地丟棄指定commit之後的所有變更，包括工作目錄中尚未提交的修改和暫存區的內容，且這些變更通常無法輕易恢復（除非透過git reflog等高級手段，且在有效期限內）。這意味著您可能永久丟失重要的工作進度或程式碼。

如果我revert了一個commit，但後來又後悔了怎麼辦？

由於git revert本身會創建一個新的commit來撤銷原來的變更，因此您可以再次使用git revert來撤銷這個「revert commit」。這會再次應用原先被撤銷的變更，就好像從未revert過一樣。例如，如果 `A` 是您想恢復的 commit，您先 `git revert A` 得到 `A’`，現在想恢復 `A` 的內容，就 `git revert A’`。

在多人協作的專案中，我應該如何退回commit？

在多人協作專案中，對於已推送到遠端倉庫的commit，一律推薦使用git revert。它不會修改共享的歷史記錄，避免了與其他團隊成員的歷史衝突。只有在特殊情況且經過團隊討論後，才考慮對本地未推送的commit使用git reset或git commit --amend。

git revert和git reset的主要區別是什麼？

主要區別在於它們對歷史記錄的處理方式：

  • git revert：非破壞性。它創建一個「新的」commit來撤銷「舊」commit的變更，保留了原有的歷史記錄。適合用於已推送到共享倉庫的commit。
  • git reset：破壞性。它會移動分支指針，從而「刪除」或「重寫」提交歷史。這會使某些commit在分支歷史中消失，只適合用於本地未推送的commit。

結語

「如何退回commit」是Git使用者必須掌握的核心技能之一。無論是避免錯誤、清理提交歷史，還是應對突發狀況，熟練運用git revert、git reset和git commit --amend都能讓您在版本控制中游刃有餘。最重要的是，要時刻牢記每種方法的適用場景和潛在風險，尤其是在處理已推送到遠端共享倉庫的commit時。謹慎操作，並在不確定時多加練習和查閱資料，您就能成為一位Git的回溯高手。

如何退回commit