How to debug Python code in Replit

The simplest debugging technique is adding print statements to your code. In Replit, anything printed to stdout appears in the Console pane when you click Run. Place print calls before and after suspicious lines to see the actual values your variables hold at runtime. This is especially useful for catching unexpected None values, wrong data types, or off-by-one errors in loops. Print debugging is not sophisticated, but it solves the majority of beginner bugs in seconds.

1def calculate_total(prices):
2    print(f"DEBUG: prices received = {prices}")  # inspect input
3    total = 0
4    for price in prices:
5        total += price
6        print(f"DEBUG: running total = {total}")  # trace each iteration
7    return total
8
9result = calculate_total([10, 20, 30])
10print(f"Final result: {result}")

When Python encounters an error, it prints a traceback in the Console. A traceback reads from bottom to top: the last line tells you the error type and message, while the lines above show the call stack leading to the error. Common errors include NameError (misspelled variable), TypeError (wrong data type), IndexError (list index out of range), and KeyError (missing dictionary key). Learning to read tracebacks is the single most valuable debugging skill in Python.

1# This code intentionally has a bug
2user_data = {"name": "Alice", "email": "alice@example.com"}
3print(user_data["phone"])  # KeyError: 'phone'

Wrap risky code in try/except blocks to prevent crashes and log meaningful error messages instead. This is especially important for operations that depend on external input, like reading user data, calling APIs, or accessing files. The except block catches the error, and you can print the exception details to the Console for debugging. This technique lets your app continue running while you investigate the problem.

1import traceback
2
3def fetch_user_setting(settings, key):
4    try:
5        value = settings[key]
6        return value
7    except KeyError as e:
8        print(f"ERROR: Missing setting '{key}' - {e}")
9        traceback.print_exc()  # prints full traceback
10        return None
11
12config = {"theme": "dark"}
13result = fetch_user_setting(config, "language")
14print(f"Got: {result}")

Python's built-in pdb debugger lets you pause execution and inspect your program step by step. Open the Shell pane in Replit (not Console) and run your script with the -m pdb flag. You can also insert breakpoint() directly in your code to pause at a specific line. Once paused, use pdb commands: 'n' for next line, 's' to step into a function, 'p variable' to print a variable, 'c' to continue, and 'q' to quit. This is more powerful than print debugging for complex logic bugs.

1# Add breakpoint() where you want to pause
2def process_items(items):
3    results = []
4    for item in items:
5        breakpoint()  # execution pauses here in Shell
6        processed = item.strip().lower()
7        results.append(processed)
8    return results
9
10process_items(["  Hello ", "WORLD  ", " Python "])

Python's logging module gives you leveled output (DEBUG, INFO, WARNING, ERROR) that you can turn on and off without removing code. Set the logging level to DEBUG during development and WARNING for production. This avoids the common problem of forgetting to remove print statements before deploying. Logging output appears in the Console just like print statements but with timestamps and severity levels.

1import logging
2
3logging.basicConfig(
4    level=logging.DEBUG,
5    format="%(asctime)s [%(levelname)s] %(message)s"
6)
7
8def divide(a, b):
9    logging.debug(f"divide() called with a={a}, b={b}")
10    if b == 0:
11        logging.error("Division by zero attempted")
12        return None
13    result = a / b
14    logging.info(f"Result: {result}")
15    return result
16
17divide(10, 0)
18divide(10, 3)

Some errors are specific to the Replit environment. ModuleNotFoundError usually means the package is not installed; fix it by running pip install package_name in the Shell or adding the package via the Dependencies tool. FileNotFoundError often occurs because the working directory is not what you expect; use os.getcwd() to check. IndentationError is common when pasting code from external sources because of mixed tabs and spaces. When your Repl shows 'Your Repl ran out of memory,' you are hitting the plan's RAM limit, which is 2 GiB on the free tier.

1import os
2import sys
3
4# Diagnostic script for common Replit issues
5print(f"Python version: {sys.version}")
6print(f"Working directory: {os.getcwd()}")
7print(f"Files here: {os.listdir('.')}")
8
9# Check if a module is importable
10try:
11    import flask
12    print(f"Flask version: {flask.__version__}")
13except ModuleNotFoundError:
14    print("Flask not installed. Run: pip install flask in Shell")