Python для начинающих

Отладка Python-кода с помощью встроенного модуля pdb

Начинающие часто боятся отладки как чего-то «магического». На самом деле pdb — это всего лишь интерактивная пауза в вашем коде, где вы можете посмотреть, что происходит «под капотом», шаг за шагом.

---

### Зачем нужен pdb?

print-отладка быстро превращает код в кашу. pdb позволяет:

- останавливать программу в нужной точке;
- смотреть значения переменных;
- выполнять произвольные выражения;
- шагать по коду, строка за строкой.

---

### Самый простой старт: breakpoint()

С Python 3.7 появился встроенный вызов:

def divide(a, b):
    result = a / b
    return result

def main():
    x = 10
    y = 0
    breakpoint()  # здесь выполнение остановится
    print(divide(x, y))

if __name__ == "__main__":
    main()

Запускаем скрипт в терминале как обычно:

python script.py

В месте breakpoint() вы попадете в интерактивную консоль pdb с приглашением вида (Pdb).

---

### Базовые команды pdb

Находясь в (Pdb), попробуйте:

- l — показать фрагмент исходника (list).
- n — выполнить следующую строку (next).
- s — шагнуть внутрь функции (step).
- c — продолжить выполнение до следующей точки останова (continue).
- p x — вывести значение переменной x (print).
- q — выйти из отладки (quit).

Например, в нашем примере:

(Pdb) p x
10
(Pdb) p y
0
(Pdb) p divide(x, y)
ZeroDivisionError: division by zero

Вы сразу видите реальную причину будущей ошибки, не дожидаясь падения программы.

---

### Ручной запуск: python -m pdb

Иногда удобно запустить отладчик с самого старта:

python -m pdb script.py

Вы окажетесь в pdb ещё до выполнения первой строки. Тут можно заранее поставить точки останова:

(Pdb) b main
(Pdb) c

Команда b main ставит брейкпоинт на вход в функцию main.

---

### Отладка циклов и логики

Пример с циклом, где что-то идёт не так:

def sum_positive(numbers):
    total = 0
    for n in numbers:
        if n < 0:
            breakpoint()
        total += n
    return total

print(sum_positive([1, 2, -5, 3]))

Когда цикл дойдёт до -5, pdb остановится. Можно исследовать:

(Pdb) p n
-5
(Pdb) p total
3
(Pdb) p numbers
[1, 2, -5, 3]

Так легко понять, что отрицательные числа вообще не должны участвовать в сумме — и исправить логику.

---

### Несколько практических подсказок

- Не оставляйте breakpoint() в продакшене: вы можете обернуть его в условие по переменной окружения.
- Научитесь минимуму команд: l, n, s, c, p, q — этого достаточно, чтобы комфортно отлаживать большинство багов.
- pdb работает везде, где есть консоль: локально, в Docker-контейнере, на сервере.

pdb — лучший способ превратить «странные баги» в понятные и воспроизводимые ситуации. Чем раньше вы привыкнете к нему, тем быстрее перестанете бояться ошибок и начнёте управлять ими.

👍3❤1

250 views04:04