git bisect详解|极客教程

git bisect详解

在软件开发过程中，经常会遇到bug产生的问题，尤其是当代码库非常大，并且有多人参与开发时，定位问题变得困难而耗时。为了简化这一过程，Git提供了一个非常实用的工具——git bisect，可以帮助我们快速定位bug引入的commit。

什么是git bisect？

git bisect是一个命令行工具，可以帮助我们逐步排除引入bug的commit，最终找到导致问题的原因。具体而言，git bisect会在一个给定的commit范围内使用二分查找的方式，将问题所在的commit逐步缩小。通俗地讲，就是将问题范围一分为二，然后确定问题在哪一半，再将问题范围缩小一半，如此重复直到找到问题的根源。

如何使用git bisect？

使用git bisect的过程分为三个步骤：标记bad commit、标记good commit、启动bisect。

步骤一：标记bad commit

首先需要在发现bug的最新版本（通常是HEAD）下标记为bad commit。使用如下命令：

git bisect bad

步骤二：标记good commit

接着我们需要标记一个已知是没有bug的commit为good commit。通常我们会向前追溯到一个较早的commit，可以使用如下命令：

git bisect good [commit hash]

其中[commit hash]是一个不会出现问题的commit的hash值。

步骤3：启动bisect

当我们标记了bad commit和good commit后，可以启动git bisect工具，Git会自动执行二分查找，让我们逐步排除有问题的commit。可以使用如下命令：

git bisect start

Git会根据我们标记的bad和good commit自动选择一个中间commit供我们测试。在测试完这个commit后，我们可以根据测试结果标记为bad或good，然后继续下一轮测试。如此重复，直到找到问题 commit。

示例

接下来我们通过一个简单的示例来演示如何使用git bisect。

假设我们有一个命令行工具，递增一个数字并输出。但是在某个commit之后，这个工具的输出出现了问题，我们希望找到引入问题的commit。

创建一个测试用的Git仓库：

git init

编写一个简单的脚本increment.sh：

#!/bin/bash

num=0

for i in {1..10}
do
  num= $((num + 1)) echo "Incrementing number:$ num"
done

提交这个脚本到Git仓库中：

git add increment.sh
git commit -m "Initial commit"

基于这个脚本创建一个新分支bugfix，并引入一个bug：

git checkout -b bugfix

修改increment.sh的代码如下：

#!/bin/bash

num=0

for i in {1..10}
do
  # introduce a bug here
  num= $((num - 1)) echo "Incrementing number:$ num"
done

提交这个bug并切换回主分支：

git add increment.sh
git commit -m "Introduce bug"
git checkout master

现在我们运行git bisect，找到引入问题的commit。

首先我们标记bad commit：

git bisect bad

然后回滚到初始状态，并标记good commit：

git bisect reset
git bisect good <commit hash of the initial commit>

接着启动bisect：

git bisect start

Git会自动选择一个中间commit供我们测试，然后我们运行测试脚本increment.sh看看是否有问题。如果有问题，我们标记为bad：

git bisect bad

如果没有问题，则标记为good：

git bisect good

如此反复测试、标记 bad/good，直到最终找到引入问题的commit。最后通过git bisect reset退出 bisect 模式，然后可以修复bug了。

总结

git bisect是一个非常有用的工具，可以帮助我们快速定位引入bug的commit，节省时间和精力。在日常开发中，如果遇到问题无法定位时，不妨尝试使用git bisect来辅助解决。

git bisect详解