事情的起因是一條 git commit --amend。
某條 commit 已經 push 到遠端 develop,之後我又在它基礎上做了改動,並用 --amend 把改動擠壓進了原 commit。這一操作導致該 commit 的哈希值發生了變化——本地和遠端就此分岔。更麻煩的是,這之後我又連續提交了 N 條新的 commit。
(Begin)
情況大致如下圖。下面綠色的部分是本地與遠端仍然一致的地方;紅色那條做的是同一個功能、commit message 也相同,但 push 到 develop 之後又改動了很多,然後被 --amend 擠壓過。
這就比較棘手了:那條 amend 過的 commit 裡積累了大量改動,需要想辦法把它和遠端重新對齊。
這個思路是先把改動暴露出來,剔除被污染的 commit,再重新組裝。全程用 stash 保護工作區,避免沖突:
git checkout develop
git reset 2c4532 // 把上面 97、98、99 三條的改動放出來
git stash // 先存起來
git reset --hard 5d67bc // 等於把 96 完全剔除,代碼回到 95 的狀態
git cherry-pick 8a6f7f // 把修改後的那條功能 commit(96 的 feature)粘過來,這步 100% 無沖突
git stash pop // 把之前存起來的改動放出來(實踐中兩塊功能離得開,也沒沖突)
git add .
git commit -m "..." // 把 97、98、99 擠壓成一條
git cherry-pick 86f6cc d34c7 2817f5 // 把 feature 分支的 97、98、99 粘過來,也無沖突
(End)
改完之後 develop 的提交樹如上圖(第 97 條就是由原 97、98、99 擠壓而成),編譯通過、功能完整。
缺點也很直接:這時必須強推 develop。
組裡另一位同學提出了另一種做法,全程只動 feature 分支:
(Begin,圖再貼一遍免得往上翻)
git checkout feature // 操作都在 feature 分支進行,不動 develop
git reset 5d67bc // 把 feature 上「不科學」的 96、97、98、99 全部放出來
git stash // 全部臨時存起來
git rebase develop // 快進,合入 develop 的所有新代碼,100% 無沖突
git stash pop // 把揉在一起的四條 commit 代碼一起放出來(這步會有大量沖突)
git add .
git commit -m "fix" // 解決沖突後提交
// 最後再把這條 commit 合入 develop
(End)
這種做法不需要強推 develop,理論上更規範,代價是中間要手工解決大量沖突。
冷靜下來看,兩種方案各有優劣。
方案一的風險在於強推覆蓋遠端歷史。如果組內成員不多、彼此都在線,可以通過充分的口頭同步把風險控制住——畢竟強推是一次明確的、可預期的操作。
方案二的風險在於大量手工解沖突。沖突解得越多,出錯概率越高;而「非常清晰地了解差異之後執行 -f 強推」,在某些情況下反而比逐個解沖突更不容易出錯。
但如果是幾十人的大型項目,遠端配了編譯檢查和 merge 規則,那麼方案二是唯一選項——強推在這種環境下根本走不通。
選擇依據其實很簡單:看團隊規模和遠端保護策略。
對程序員來說,比寫出 bug 更可怕的是把代碼弄丟或弄亂。這類問題有三層救援手段:
① git reset --hard <哈希>——最常用的一招。代碼有點亂,直接回到一個已知安全的 commit。
② git reflog——如果經歷過 rebase 或 merge,第一招就不管用了,因為被改寫的並不只是最後一條 commit。這時 reflog 是萬能恢復指令,它記錄了 HEAD 的每一次移動,可以讓你回到任意一個操作的哈希點。
③ IDE 的 Local History——前兩招都有一個前提:代碼已經被 git 記錄過。如果某些改動還沒 commit 就被 reset 掉了,git 完全無能為力,這時只能靠 IDE 的本地歷史(可以理解為 IDE 幫你實現了一套類 git 機制)。我自己就遇到過一次:沒 commit 的代碼被 reset,靠 Local History 救了回來。
好消息是主流 IDE 都有這個功能:
最後回到源頭:這場事故的根本原因是對已經 push 出去的 commit 使用了 --amend。養成一個習慣就能避免大部分類似問題——--amend 只用於尚未推送的本地 commit。
如果對上述問題有更好的解法,歡迎一起討論。