Course contentsShow
← Software Engineering
Lesson 1715 of 1,93350. Debugging and TroubleshootingFree lesson

Adding Strategic Print Statements and Logging

Insert temporary debug output at key points to observe program state and execution flow during investigation.

Adding Strategic Print Statements and Logging

What you'll learn: How to insert temporary debug output at critical points to observe your program's state and execution flow while hunting down bugs.

When debugging, you're essentially a detective trying to understand what's happening inside your program. One of the most powerful tools at your disposal is strategic output—deliberately placed print statements or log entries that let you "see" what your code is doing in real time.

Why Strategic Placement Matters

The key word is strategic. Don't just scatter print statements everywhere—that creates noise that obscures the signal. Instead, think about your bug's location (perhaps narrowed down using binary search) and place output at:

  • Entry and exit points of suspicious functions to confirm they're being called
  • Before and after state changes to catch unexpected transformations
  • Inside conditional branches to verify which path executes
  • Loop boundaries to check iteration counts and conditions

What to Output

Print the values you care about, labeled clearly:

print(f"DEBUG: user_id={user_id}, status={status}")
print(f"DEBUG: Entering process_order with order_count={len(orders)}")

Include context that helps you understand when and where this output occurs. Prefix with "DEBUG" so you can easily find and remove these statements later.

Logging vs Print Statements

As you become more sophisticated, use logging instead of raw print calls. Logging lets you control verbosity levels and can be left in production code, toggled on when needed.

Think of print statements as breadcrumbs you drop while walking through a dark forest—they show you the path your program actually took, not just the path you thought it would take.

Key Takeaway: Strategic debug output transforms invisible program execution into visible evidence, letting you observe actual behavior at critical decision points rather than guessing what your code is doing.