git bisect 命令教程

迷南。 2022-12-04 08:47 154阅读 0赞

`git bisect`是一个很有用的命令，用来查找哪一次代码提交引入了错误。

![format_png][]

它的原理很简单，就是将代码提交的历史，按照两分法不断缩小定位。所谓"两分法"，就是将代码历史一分为二，确定问题出在前半部分，还是后半部分，不断执行这个过程，直到范围缩小到某一次代码提交。

本文通过一个实例，解释如何使用这个命令。下面是一个[代码库][Link 1]，请将它克隆到本地。

>     $ git clone git@github.com:bradleyboy/bisectercise.git
>     $ cd bisectercise

这个库是一个网页`index.html`，在浏览器打开这个网页。

>     $ open index.html

![format_png 1][]

网页上是一个计数器，有两个按钮。点击`+`号按钮，可以看到计数器没有递增，反而递减，这说明代码有问题。

现在，就要来查找，到底哪一次代码提交，引入了错误。首先，检查一下代码提交历史。

>     $ git log --pretty=oneline

可以看到，这个库一共有101次提交。最早的第一次提交的哈希是`4d83cf`。

`git bisect start`命令启动查错，它的格式如下。

>     $ git bisect start [终点] [起点]

上面代码中，"终点"是最近的提交，"起点"是更久以前的提交。它们之间的这段历史，就是差错的范围。

这个例子中，我们选择全部的代码历史。起点是第一次提交`4d83cf`，终点是最近一次的`HEAD`。当然，指定其他范围也可以。

>     $ git bisect start HEAD 4d83cf

执行上面的命令以后，代码库就会切换到这段范围正当中的那一次提交，本例是第51次提交。

现在刷新浏览器，点击`+`按钮，发现可以正常递增。使用`git bisect good`命令，标识本次提交（第51次）没有问题。

>     $ git bisect good

既然第51次提交没有问题，就意味着错误是在代码历史的后半段引入的。执行上面的命令，Git 就自动切换到后半段的中点（第76次提交）。

现在刷新浏览器，点击`+`按钮，发现不能正常递增。使用`git bisect bad`命令，标识本次提交（第76）有问题。

>     $ git bisect bad

执行上面的命令以后，Git 就自动切换到第51次到第76次的中点（第63次提交）。

接下来，不断重复这个过程，直到成功找到出问题的那一次提交为止。这时，Git 会给出如下的提示。

>     b47892 is the first bad commit

既然找到那个有问题的提交，就可以[检查代码][Link 2]，确定具体是什么错误。

然后，使用`git bisect reset`命令，退出查错，回到最近一次的代码提交。

>     $ git bisect reset

现在就可以开始修复错误了。

[format_png]: /images/20221123/7632a2f65d35461f9fe8c4c7b9712c67.png
[Link 1]: https://github.com/bradleyboy/bisectercise
[format_png 1]: /images/20221123/b78f0f24cdcb4e00a9da8ae2437950a1.png
[Link 2]: https://github.com/bradleyboy/bisectercise/commit/b47892adec22ee3b0330aff37cbc5e695dfb99d6

发表评论取消回复

表情：

评论列表（有 0 条评论，154人围观）

还没有评论，来说两句吧...

相关阅读

相关 git bisect 命令教程

`git bisect`是一个很有用的命令，用来查找哪一次代码提交引入了错误。 ![format_png][] 它的原理很简单，就是将代码提交的历史，按照两分法不断缩小定位

迷南。/ 2022年12月04日 08:47/ 0 赞/ 155 阅读

相关 Git - 常用命令使用教程

> 本文介绍git常用命令的使用方法。 Git > 译为`分布式版本控制系统`，是一个开源的分布式版本控制系统，可以有效、高速地处理从很小到非常大的项目版本管理。

谁践踏了优雅/ 2022年11月22日 00:03/ 0 赞/ 223 阅读

相关 git--命令大全/常用命令--使用/教程

原文网址：[git--命令大全/常用命令--使用/教程\_IT利刃出鞘的博客-CSDN博客][git--_--_IT_-CSDN] 简介本文介绍git的命令，涉及日常

绝地灬酷狼/ 2022年09月15日 05:53/ 0 赞/ 522 阅读

相关 Git 命令行教程及实例教程

前言：前几天在写博客 [手把手教你用Hexo + github 搭建自己博客][Hexo _ github]的时候，经常需要用到一些git操作，截了好多图，于是就想干脆整理成一

Dear 丶/ 2022年07月14日 13:27/ 0 赞/ 253 阅读

相关 git命令行使用方式教程

创建一个版本库 git init demo \[xuhaixing@localhostgitRepo\]$ git

野性酷女/ 2022年06月06日 07:38/ 0 赞/ 236 阅读

相关 Git使用教程(5)-Git常用命令

克隆仓库到本地 git clone git://xxx.git 新增文件加入仓库 git add . 代码提交本地 git commit -a -m “a

水深无声/ 2022年05月29日 04:36/ 0 赞/ 177 阅读

相关 git教程之git命令总结

一. 分支操作 1. 列出本地所有分支 git branch 退不出命令?单击Q键 1. 列出所有远程分支 git branch -r

刺骨的言语ヽ痛彻心扉/ 2022年05月08日 02:04/ 0 赞/ 181 阅读

相关 Git 教程 1 git安装及基本命令

在Mac OS X上安装Git 由于没有Windows系统，也没在Windows上安装过git，所以只介绍mac的安装。Windows小伙伴自行百度了。第

痛定思痛。/ 2022年04月18日 04:15/ 0 赞/ 225 阅读

相关 git命令行使用教程

git命令行使用教程基础使用 Linux服务器安装git服务端初始化项目路径常用git命令分支使用

￡神魔★判官ぃ/ 2022年04月05日 15:27/ 0 赞/ 302 阅读

相关 Git 教程② git基本命令

git基本命令和linux相同，如pwd、ls、cd、touch....... -------------------- ![watermark_type_ZmFuZ3p

快来打我*/ 2021年10月19日 00:34/ 0 赞/ 415 阅读