Debugging Formula

The Formula

\text{bug report} \rightarrow \text{hypothesis} \rightarrow \text{test} \rightarrow \text{fix}

When to use: Detective work—observe the wrong output, form a hypothesis, test it, then fix what's wrong.

Quick Example

Program prints 'Hello Worl' instead of 'Hello World'. Find the missing 'd', fix it.

What This Formula Means

The systematic process of finding, diagnosing, and correcting errors (bugs) in a program. Debugging involves reproducing the problem, isolating its cause through testing and inspection, applying a targeted fix, and verifying the fix resolves the issue without introducing new problems.

Detective work—observe the wrong output, form a hypothesis, test it, then fix what's wrong.

Formal View

Debugging applies the scientific method to code: observe unexpected behavior, hypothesize a cause, design a test to confirm or reject the hypothesis, and iterate until the root cause is identified and corrected.

Worked Examples

Example 1

medium
This code should print numbers 1 to 5 but has a bug: SET i = 1. WHILE i < 5: OUTPUT i. i = i + 1. Find and fix the bug.

Solution

  1. 1
    Step 1: Trace: i=1 (output 1), i=2 (output 2), i=3 (output 3), i=4 (output 4), i=5 (5 < 5 is false, loop ends).
  2. 2
    Step 2: The loop outputs 1, 2, 3, 4 — it misses 5.
  3. 3
    Step 3: Fix: change `WHILE i < 5` to `WHILE i <= 5`.

Answer

Change `i < 5` to `i <= 5`. Off-by-one error.
Off-by-one errors are among the most common bugs. Careful attention to loop boundaries (< vs <=) prevents them. Tracing helps catch these errors.

Example 2

medium
This code calculates an average but gives the wrong answer: SET total = 0. FOR each num in [10, 20, 30]: total = total + num. SET average = total / 2. OUTPUT average. The input has 3 numbers. Find the bug.

Common Mistakes

  • Making random changes hoping to fix the bug instead of systematically isolating the cause
  • Fixing the symptom instead of the root cause, which leads to the bug reappearing in different forms
  • Not testing the fix thoroughly, accidentally introducing new bugs while fixing the original one

Common Mistakes Guide

If this formula feels simple in isolation but keeps breaking during real problems, review the most common errors before you practice again.

Debugging Mistakes

Why This Formula Matters

Programs rarely work perfectly the first time—debugging is unavoidable. Professional developers spend roughly half their time debugging. Learning to debug systematically rather than randomly guessing saves enormous time and frustration.

Frequently Asked Questions

What is the Debugging formula?

The systematic process of finding, diagnosing, and correcting errors (bugs) in a program. Debugging involves reproducing the problem, isolating its cause through testing and inspection, applying a targeted fix, and verifying the fix resolves the issue without introducing new problems.

How do you use the Debugging formula?

Detective work—observe the wrong output, form a hypothesis, test it, then fix what's wrong.

Why is the Debugging formula important in CS Thinking?

Programs rarely work perfectly the first time—debugging is unavoidable. Professional developers spend roughly half their time debugging. Learning to debug systematically rather than randomly guessing saves enormous time and frustration.

What do students get wrong about Debugging?

The bug might not be where the error appears—trace backward.

What should I learn before the Debugging formula?

Before studying the Debugging formula, you should understand: algorithm.

← Back to Debugging See All Examples Common Mistakes Practice Problems