Mastering Git Bisect: Finding Bugs with Precision

by Juan Vásquez, 03 Sep 2023

Mastering Git Bisect: Finding Bugs with Precision

In the world of software development, bugs are a common adversary. They can be elusive, popping up when you least expect them and wreaking havoc in your codebase. When you encounter a bug, one of the most critical tasks is to identify the exact commit that introduced it. This is where Git Bisect, a powerful tool provided by Git, comes to the rescue.

Git Bisect is a tool that helps you perform a binary search through your commit history to find the specific commit responsible for a bug. It automates the process of checking out different commits, allowing you to quickly narrow down the culprit. In this article, we’ll explore how to use Git Bisect effectively.

Setting the Stage

Imagine you’re working on a project with a large codebase, and you’ve discovered a bug - let’s call it Bug X. You know that at some point in the project’s history, everything was working perfectly. However, due to the complexity of the code and the number of commits, you have no idea when or where Bug X was introduced.

This is where Git Bisect shines. It helps you find the problematic commit methodically and efficiently.

Starting Git Bisect

The first step is to start the Git Bisect process. Open your terminal and navigate to your project’s repository. Then, run:

git bisect start

This command initializes the bisect process and prepares Git to help you find the bug’s root cause.

Marking Good and Bad Commits

To begin the search, you need to identify two commits:

  1. A bad commit: This is a commit where you know for sure that Bug X exists.
  2. A good commit: This is a commit where you are certain that Bug X does not exist.

Use the following commands to mark these commits:

  • To mark a commit as bad, use:
    git bisect bad <commit>
  • To mark a commit as good, use:
    git bisect good <commit>

Let the Binary Search Begin

With the good and bad commits marked, Git will now perform a binary search through your commit history. It will check out commits in the middle of the range you specified (between the good and bad commits). You will need to test each of these commits and inform Git if they are “good” or “bad.”

  • If a checked-out commit is bad, run:
    git bisect bad
  • If a checked-out commit is good, run:
    git bisect good

Git will then proceed to check out the next commit in the middle of the remaining range, and you repeat the testing process. Git will continue this cycle until it has identified the exact commit where Bug X was introduced.

Viewing Bisect Progress

During the bisect process, it’s useful to keep track of the progress. To view the history of the bisect process, you can use:

git bisect log

This command displays a table with information about the commits that have been checked, including their commit hash, commit message, and whether they were marked as “good” or “bad.”

Ending the Bisect Process

Once Git has identified the commit that introduced the bug, it will display the commit hash and any additional information. You can end the bisect process by running:

git bisect reset

At this point, you can investigate the problematic commit, fix the bug, or take any other necessary actions.


Git Bisect is an invaluable tool in a developer’s toolkit for debugging. It simplifies the process of finding the commit that introduced a bug, saving you time and frustration. Whether you’re working on a large codebase or a small project, Git Bisect can help you pinpoint and resolve issues efficiently, allowing you to deliver more reliable software to your users.