漫畫：Git 二分 Debug，火速定位出錯程式碼！

承香墨影發表於2018-02-05

Git

Git bisect 是 Git 提供的一種 二分法 的除錯工具，它可以按照我們選定的 commit 列表，進行二分分割，快速定位出出錯的 commit。來幫我們縮小最小改動的程式碼，從而快速定位問題。

Git bisect 其實很簡單，主要是基於幾個基本命令：

git bisect start：準備進行 bisect debug。
git bisect good：標記一個提交為 "good"。
git bisect bad：標記一個提交為 “bad”。
git bisect reset：退出 bisect debug 的狀態。

Git bisect 涉及到的命令，非常的清晰簡單，下面舉個實際的例子，結合上面的解釋，就更清晰了。

舉個例子

我自己生造出 6 個 commit，然後使用 git log 看看我的提交記錄。

這裡假設我正常開發的階段，到 v6 提交的時候，突然發現有個 Bug ，無法定位到問題，但是能明確的知道，在 v1 提交階段，並沒有這個 Bug。

那麼，在這樣的情況下，v6 就是一個有問題的版本，而 v1 則是一個好的版本，我們就可以藉助 git bisect 來進行二分超找定位問題來自哪個提交。

還記得剛才的命令嗎？

我們先用 git bisect start 標記開始 bisect debug ，然後使用 git bisect good 和 git bisect bad 分別標記出正確的和錯誤的提交。

每個提交，都有一個針對這個提交唯一的 SHA-1 值，因為太長不方便輸入和閱讀，這裡可以直接使用前幾位作為簡寫。

當標記處正確的和錯誤的提交之後，git bisect 立刻就可以幫我們定位出中間提交 v3。

現在 HEAD 就已經指向了 v3 提交的程式碼了，這個可以使用 git status 檢視當前的狀態。

所以我們可以基於 v3 版本的程式碼，直接執行專案，測試看該提交是否有問題。

經過測試之後，發現 v3 的提交程式碼版本，並沒有復現 Bug，那我們就可以縮小錯誤提交的範圍，大概落在了 v4、v5、v6 之間。

此時，我們只需要使用 git good 標記 v3 版本是正確的。

標記好 v3 為 good 之後，立刻又會進行一次二分，此次標記的為中間提交 v5。

經過對 v5 提交的版本程式碼，進行測試之後發現，它是有問題的。我們繼續使用 git bisect bad 對它進行標記。

當 v5 有問題的時候，現在只中間一個 v4 版本，所以會立刻指向 v4 提交。

我們繼續對 v4 版本的程式碼進行測試，發現 v4 版本也有問題，繼續標記它為 bad 。

此時就很明確了，出錯的提交就是 v4，而 Git 也直接幫我們指出來出錯的提交。

雖然這裡定位到，出錯的提交就是 v4 的問題，我們只需要仔細閱讀 v4 提交的程式碼，然後定位出問題程式碼，就達到了我們的目的。但是我們並不應該在 v4 提交上直接修改 Bug，我們應該退出 bisect debug 狀態，在最新的提交版本上進行修改，這裡使用 git bisect reset 退出，再進行修改即可。

到這裡，就是 git bisect 的完整工作流程。