0Pricing
Git Advanced: Monorepo, Submodules & Workflows · درس

تصحيح الأخطاء باستخدام Git Bisect

استخدم `git bisect` لتحديد الالتزام الدقيق الذي أدخل الخطأ بكفاءة، مما يوفر وقتًا ثمينًا في تصحيح الأخطاء

تصحيح الأخطاء باستخدام Git Bisect درس مجاني في Git Advanced: Monorepo, Submodules & Workflows على CoddyKit. هذا هو الدرس 2 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في Git Advanced: Monorepo, Submodules & Workflows، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة Git Advanced: Monorepo, Submodules & Workflows 4 دروس في المجموع.

بعض أجزاء هذا الدرس لم تُترجم بعد وتظهر باللغة الإنجليزية.

What is Git Bisect?

Imagine a bug appears in your project, but you're not sure which recent change caused it. Manually checking each commit can be a huge time sink!

git bisect is a powerful Git command that uses a binary search algorithm to quickly find the exact commit that introduced a bug.

The Binary Search Advantage

How does git bisect work so fast? It's like a game of 'hot or cold' with your commit history.

  • You tell Git a commit you know is bad (has the bug).
  • You tell Git a commit you know is good (before the bug existed).
  • Git picks a commit roughly in the middle and asks you to test it.
  • Based on your feedback, it halves the search space, repeating until the culprit is found.

Starting Your Bisect Hunt

To begin, first you need to tell Git you're starting a bisect session. Then, you mark the known 'bad' (buggy) commit and a known 'good' (working) commit.

You can use commit hashes, branch names, or tags.

git bisect start
git bisect bad HEAD
git bisect good <known_good_commit_hash>

The Iterative Process: Test & Mark

After you define your good and bad commits, Git will automatically check out a commit in the middle of that range. Your job is to test the code at this commit.

  • If the bug is present, mark it as bad.
  • If the bug is NOT present, mark it as good.

Git will then move to the next commit, halving the remaining search space.

Marking a Commit

Once you've tested the currently checked-out commit, use these commands to tell Git whether it's good or bad:

  • To mark the current commit as bad: git bisect bad
  • To mark the current commit as good: git bisect good

Git will then automatically check out the next commit to test.

git bisect bad
# OR
git bisect good

Narrowing Down the Problem

You'll repeat the 'test and mark' process. With each step, git bisect gets closer to the single commit that introduced the bug. It's much faster than checking commits one by one!

For a range of 100 commits, it takes at most 7 tests (log2(100) ≈ 6.64).

Found the Culprit!

Eventually, git bisect will narrow the range down to a single commit. It will then report the first 'bad' commit found, which is your bug introducer!

After finding the bug, it's crucial to exit the bisect session to return your repository to its original state (usually the branch you were on when you started).

git bisect reset

Handling Untestable Commits

Sometimes, git bisect might land on a commit that can't be tested (e.g., it doesn't compile, or dependencies are broken). In such cases, you can tell Git to skip it:

git bisect skip

Git will then pick another commit to test, making sure to exclude the skipped one from the potential range of the bug.

git bisect skip

Automating with Git Bisect Run

For even faster debugging, you can automate the testing process using git bisect run. This command takes a script that performs the test and exits with specific codes:

  • 0: The commit is good.
  • 1-127 (except 125): The commit is bad.
  • 125: The commit should be skipped (e.g., cannot build).

Git will then run the script automatically for each commit until the bug is found.

#!/bin/bash

# Example test script for git bisect run
# Replace 'make test' with your actual test command

if make test;
then
  exit 0 # Tests passed, commit is good
else
  exit 1 # Tests failed, commit is bad
fi

Bisect Workflow Check

Which of the following commands are essential when performing a manual git bisect to find a bug?

Debugging Power-Up!

You've mastered git bisect! This powerful tool transforms bug hunting from a tedious chore into an efficient, systematic process using binary search.

  • Start with git bisect start, defining good and bad commits.
  • Test and mark commits as good or bad.
  • Use git bisect skip for untestable commits.
  • Automate with git bisect run for fast, hands-free debugging.
  • Always finish with git bisect reset.

Happy bug hunting!

الأسئلة الشائعة

هل درس «تصحيح الأخطاء باستخدام Git Bisect» مجاني؟

نعم — نص درس «تصحيح الأخطاء باستخدام Git Bisect» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة Git Advanced: Monorepo, Submodules & Workflows، انتقل إلى CoddyKit PRO. تتضمن دورة Git Advanced: Monorepo, Submodules & Workflows 4 دروس في المجموع.

ماذا ستتعلم في «تصحيح الأخطاء باستخدام Git Bisect»؟

استخدم `git bisect` لتحديد الالتزام الدقيق الذي أدخل الخطأ بكفاءة، مما يوفر وقتًا ثمينًا في تصحيح الأخطاء تتمرن على Git Advanced: Monorepo, Submodules & Workflows مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.

هل أحتاج إلى خبرة سابقة لأبدأ Git Advanced: Monorepo, Submodules & Workflows؟

لا تُشترط خبرة سابقة. Git Advanced: Monorepo, Submodules & Workflows على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 2 من أصل 4.

كم من الوقت يستغرق درس «تصحيح الأخطاء باستخدام Git Bisect»؟

معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.

هل يمكنني كتابة وتشغيل أكواد في درس Git Advanced: Monorepo, Submodules & Workflows هذا؟

نعم. كل درس في Git Advanced: Monorepo, Submodules & Workflows يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.

جميع الدروس في هذه الدورة

  1. استعادة الالتزامات والفروع المفقودة
  2. تصحيح الأخطاء باستخدام Git Bisect
  3. تحسين أداء مستودعات Git
  4. استعادة العمل باستخدام Reflog وStash
← العودة إلى Git Advanced: Monorepo, Submodules & Workflows