Отладка — это поиск и исправление ошибок в программе. Код запускают, видят неверный результат или падение, находят строку, где всё пошло не так, и чинят причину. Быстрее всего это делается так: воспроизвести ошибку, прочитать сообщение интерпретатора, сузить место и проверить значения переменных через отладочный вывод или отладчик. Ниже разбираем отладку кода по шагам на живом примере на Python, а базовые понятия вроде переменных и циклов есть в статье про основы программирования.
По-английски процесс называют debugging, отсюда разговорные «дебаг» и «дебажить». Это одно и то же.
SkillboxПрофессия «Python-разработчик»157 335 ₽10 месяцев
НетологияFullstack-разработчик на Python137 000 ₽21 месяц
GeekBrainsДО Профессия Python-разработчик149 001 ₽10 месяцев
SkillFactoryПрофессия Python-разработчик140 040 ₽10 месяцев
Академия СинергияPython-разработчик + ИИ77 900 ₽6 месяцев
ЭдюсонPython-разработчик89 919 ₽9 месяцев
Что такое отладка простыми словами

Программа почти никогда не работает правильно с первого запуска. Где-то опечатка, где-то цикл проходит на круг меньше, где-то в функцию пришёл не тот тип данных. Отладка программы закрывает этот разрыв между «написал» и «работает».
В справке Microsoft по Visual Studio сказано, что в буквальном смысле отладка означает удаление ошибок из вашего кода. Способов много: перечитать код, запустить анализатор, вывести значения на экран или подключить отладчик.
Отладчик — отдельная программа, которая подключается к работающему коду. Она умеет остановить выполнение на нужной строке, показать текущие значения переменных и шагать по коду построчно. В Python отладчик встроен и называется pdb, в редакторах кода он работает через кнопки и горячие клавиши.
Отладка и тестирование: в чём разница
Эти слова часто ставят рядом, как в учебном курсе «тестирование и отладка», но задачи у них разные.
| Тестирование | Отладка | |
|---|---|---|
| Вопрос | Есть ли ошибка? | Где она и почему возникла? |
| Кто делает | Тестировщик или автотесты | Разработчик, который пишет код |
| Результат | Отчёт о дефекте: что сделали, что ждали, что получили | Исправленный код |
| Инструменты | Тест-кейсы, фреймворки автотестов | Отладчик, логи, отладочный вывод |
Тест находит симптом, отладка находит причину. Подробнее о том, чем занят специалист по проверке программ, мы писали в статье про инженера по тестированию.
Какие ошибки ищут при отладке
Ошибки делят на три вида. От вида зависит, как вы о ней узнаете и с чего начинать поиск.
| Вид ошибки | Как проявляется | Пример на Python |
|---|---|---|
| Синтаксическая | Программа не запускается совсем, интерпретатор указывает строку | Забыли двоеточие после if |
| Ошибка выполнения | Программа запускается и падает на какой-то строке с сообщением | Обращение к несуществующему ключу словаря, деление на ноль |
| Логическая | Программа работает без сообщений, но результат неверный | Цикл пропускает первый элемент списка |
Логическую ошибку найти труднее всего: сообщения нет, и о проблеме вы узнаёте только по неверному числу на экране. Именно такие ошибки ищут отладчиком.
В компилируемых языках вроде C++ часть ошибок находит компилятор ещё до запуска, в Python они всплывают только при выполнении. Почему так, объясняем в разборе компилируемых и интерпретируемых языков.
Канал основателя Checkroi Вани Буявца3 800 человек читают мой Телеграм-канал про нейросетиСобрал промпты для Claude Code и ChatGPT, разборы ИИ-инструментов и лайфхаки по продвижению бизнеса в одном местеПрисоединитьсяКак отладить программу: 6 шагов

Порядок одинаковый для любого языка и любого размера проекта. Новички чаще всего пропускают первый и последний шаги.
- Воспроизведите ошибку. Найдите входные данные, на которых она появляется каждый раз. Ошибку, которая случается «иногда», искать почти невозможно.
- Прочитайте сообщение целиком. Тип ошибки, файл и номер строки уже сужают поиск до нескольких строк.
- Сузьте место. Найдите последнюю точку, где данные ещё правильные, и первую, где уже нет. Ошибка между ними.
- Проверьте предположение. Выведите значения переменных через
print()или остановите программу отладчиком и посмотрите на них. - Исправьте одну вещь. Если поменять сразу три строки, будет непонятно, какая правка помогла, а какая сломала что-то ещё.
- Запустите снова на тех же данных. Убедитесь, что ошибка ушла, а остальное работает. Хорошая привычка: добавить автотест на этот случай, чтобы ошибка не вернулась.
Разберём шаги на коротком примере. Функция должна считать среднюю оценку:
def average(scores):
total = 0
for i in range(1, len(scores)):
total += scores[i]
return total / len(scores)
print(average([5, 4, 3]))
Ждём 4.0, а получаем:
2.3333333333333335
Сообщения об ошибке нет, программа отработала. Это логическая ошибка, и ниже мы найдём её двумя способами: отладочным выводом и отладчиком.
Как читать сообщение об ошибке
Когда Python падает, он печатает трассировку (traceback): цепочку вызовов, которая привела к ошибке. Возьмём программу, которая считает сумму заказа:
prices = {"кофе": 180, "чай": 120}
def order_total(items):
return sum(prices[item] for item in items)
print(order_total(["кофе", "какао"]))
Python 3.14 выводит:
Traceback (most recent call last):
File "/private/tmp/otladka-lb/order.py", line 8, in <module>
print(order_total(["кофе", "какао"]))
~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^
File "/private/tmp/otladka-lb/order.py", line 5, in order_total
return sum(prices[item] for item in items)
File "/private/tmp/otladka-lb/order.py", line 5, in <genexpr>
return sum(prices[item] for item in items)
~~~~~~^^^^^^
KeyError: 'какао'
Трассировку читают снизу вверх. Последняя строка говорит, что случилось: KeyError, то есть в словаре нет ключа «какао». Строкой выше указано место: файл order.py, строка 5, а значки ^ подчёркивают выражение prices[item]. Верхние строки показывают, кто вызвал эту функцию.
Здесь правка нужна в данных или в обработке: добавить какао в прайс или решить, что делать с неизвестным товаром. Как перехватить такую ошибку и не уронить программу, разобрано в статье про try except в Python.
Методы отладки: от print до отладчика
Вернёмся к средней оценке. Ошибку можно найти разными средствами отладки, и у каждого своя ниша.
Отладочный вывод через print
Самый простой метод: печатать значения в тех местах, где вы сомневаетесь.
def average(scores):
total = 0
for i in range(1, len(scores)):
print("i =", i, "оценка =", scores[i], "сумма до =", total)
total += scores[i]
print("итог суммы:", total, "оценок:", len(scores))
return total / len(scores)
print(average([5, 4, 3]))
i = 1 оценка = 4 сумма до = 0
i = 2 оценка = 3 сумма до = 4
итог суммы: 7 оценок: 3
2.3333333333333335
Видно, что цикл начинается с i = 1 и пятёрка в сумму не попала: 4 + 3 = 7 вместо 12. Виноват range(1, …), индексы в списках Python начинаются с нуля.
Минус метода: отладочные строки потом надо не забыть удалить, а в большой программе вывод быстро превращается в простыню.
Встроенный отладчик pdb
Отладчик останавливает программу, не меняя код. Запускаем скрипт через python3 -m pdb, ставим точку останова на строке 4 и смотрим переменные на каждом круге цикла:
> /private/tmp/otladka-lb/average.py(1)<module>()
-> def average(scores):
(Pdb) b 4
Breakpoint 1 at /private/tmp/otladka-lb/average.py:4
(Pdb) c
> /private/tmp/otladka-lb/average.py(4)average()
-> total += scores[i]
(Pdb) p i, scores[i], total
(1, 4, 0)
(Pdb) c
> /private/tmp/otladka-lb/average.py(4)average()
-> total += scores[i]
(Pdb) p i, scores[i], total
(2, 3, 4)
(Pdb) q
Первая же остановка показывает i = 1: элемент с индексом 0 пропущен. Основные команды, по документации pdb:
| Команда | Что делает |
|---|---|
b 4 |
Ставит точку останова на строке 4 |
c |
Продолжает выполнение до следующей точки останова |
n |
Выполняет текущую строку и останавливается на следующей в этой же функции |
s |
То же, но заходит внутрь вызываемой функции |
p выражение |
Печатает значение выражения |
ll |
Показывает весь код текущей функции |
w |
Показывает стек вызовов |
q |
Выходит из отладчика и прерывает программу |
Остановиться можно и прямо из кода: строка breakpoint() в нужном месте открывает тот же отладчик. По документации pdb её можно использовать вместо связки import pdb; pdb.set_trace().
Исправленная функция:
def average(scores):
total = 0
for score in scores:
total += score
return total / len(scores)
print(average([5, 4, 3]))
4.0
Логирование
Если программа работает долго или на сервере, где нет консоли, вместо print() пишут лог. Модуль logging умеет включать и выключать отладочные сообщения одной настройкой уровня, не трогая остальной код:
import logging
logging.basicConfig(level=logging.DEBUG, format="%(levelname)s %(message)s")
def average(scores):
logging.debug("получили оценки: %s", scores)
total = sum(scores)
logging.debug("сумма %s, количество %s", total, len(scores))
return total / len(scores)
print(average([5, 4, 3]))
DEBUG получили оценки: [5, 4, 3]
DEBUG сумма 12, количество 3
4.0
Поменяйте logging.DEBUG на logging.WARNING, и строки с DEBUG пропадут. Уровни описаны в руководстве по logging.
Проверки через assert
assert останавливает программу, если условие ложно. Так ошибка всплывает там, где появились плохие данные, а не тремя функциями дальше:
def average(scores):
assert scores, "список оценок пуст"
return sum(scores) / len(scores)
print(average([5, 4, 3]))
print(average([]))
4.0
Traceback (most recent call last):
File "/private/tmp/otladka-lb/average_assert.py", line 7, in <module>
print(average([]))
~~~~~~~^^^^
File "/private/tmp/otladka-lb/average_assert.py", line 2, in average
assert scores, "список оценок пуст"
^^^^^^
AssertionError: список оценок пуст
Учтите: при запуске с флагом -O Python не генерирует код для assert. Для проверки пользовательского ввода он не годится, только для отладки: ввод числа проверяют обычным условием if.
Метод утёнка и деление пополам
Два приёма без всяких инструментов.
- Метод утёнка. Объясните код построчно вслух, хоть резиновой игрушке на столе. На словах «а здесь цикл идёт с единицы» ошибка часто находится сама.
- Деление пополам. Закомментируйте половину подозрительного кода или поставьте проверку посередине. Если ошибка осталась, она в первой половине, если пропала, то во второй. Повторяйте, пока не останется пара строк.
Отладка в редакторе кода и в браузере

Писать команды pdb руками не обязательно: в редакторах отладчик управляется мышью и горячими клавишами. Принцип тот же, меняется только интерфейс.
VS Code
Горячие клавиши по документации VS Code:
- F9 или клик слева от номера строки: поставить или убрать точку останова;
- F5: запустить отладку или продолжить до следующей точки;
- F10: шаг без захода в функцию, F11: шаг с заходом;
- Shift+F11: выйти из текущей функции;
- Shift+F5: остановить отладку.
Ещё в VS Code есть точки журнала (logpoints): они пишут сообщение в консоль отладки и не останавливают программу. Это тот же print(), только без правки кода. Как подготовить редактор к Python, рассказали в инструкции по настройке VS Code для Python, а сравнение сред с удобным отладчиком есть в обзоре IDE для Python.
Браузер
JavaScript отлаживают на панели Sources инструментов разработчика. Точку останова ставят кликом по номеру строки, а значения переменных видны на панели Scope.
В руководстве Chrome DevTools сказано, что точки останова могут помочь найти и исправить ошибку быстрее, чем console.log(). Как открыть эти инструменты в любом браузере, описано в статье про DevTools.
Чем отлаживать разные языки
| Язык | Отладчик |
|---|---|
| Python | pdb в терминале, отладчик VS Code или другой IDE |
| JavaScript | Инструменты разработчика в браузере, отладчик VS Code для Node.js |
| C и C++ | GDB в терминале, отладчик Visual Studio |
| Java | Отладчик IDE, например Eclipse |
| 1С | Встроенный отладчик конфигуратора |
Частые ошибки при отладке
Проблемы самого процесса отладки повторяются у всех новичков.
- Чинят до того, как поняли. Меняют код наугад, пока не заработает. Ошибка уходит, причина остаётся и всплывает в другом месте. Решение: сначала сформулируйте, почему ошибка возникла, потом правьте.
- Не читают трассировку. Видят красный текст и сразу идут искать ответ в интернете. Решение: последняя строка сообщения обычно уже называет и тип ошибки, и место.
- Ищут ошибку не там. Строка, где программа упала, и строка, где родились плохие данные, часто разные. Решение: идите по трассировке вверх и проверяйте, откуда пришло значение.
- Оставляют отладочный мусор. Забытые
print()иbreakpoint()уезжают в рабочую версию. Решение: используйтеloggingили поиск по проекту перед отправкой кода. - Не проверяют после исправления. Решение: прогоните программу на тех данных, где ошибка была, и на паре обычных.
Если ошибки сыплются на каждом шаге, полезно вернуться к основам: типам данных и переменным. Половина ошибок новичков рождается именно там.
Где научиться программировать и отлаживать код системно
Отладка как навык растёт вместе с опытом: чем больше кода вы написали, тем быстрее видите типичные ловушки. На курсах по Python разбор ошибок идёт в каждом домашнем задании, а наставник показывает, как искать причину по трассировке и отладчику. Сравнить программы по цене и длительности можно в каталоге курсов по Python.
| Курс | Школа | Стоимость со скидкой | В рассрочку | Длительность | Обзор курса от Checkroi |
|---|---|---|---|---|---|
| Профессия «Python-разработчик» Перейти на сайт курса | 157 335 ₽ | 5987 ₽/мес. | 10 месяцев | Обзор курса | |
| Fullstack-разработчик на Python Перейти на сайт курса | 137 000 ₽ | 7125 ₽/мес. | 21 месяц | Обзор курса | |
| ДО Профессия Python-разработчик Перейти на сайт курса | 149 001 ₽ | 3167 ₽/мес. | 10 месяцев | Обзор курса | |
| Автоматизированное тестирование на Python Перейти на сайт курса | 118 754 ₽ | 4108 ₽/мес. | 9 месяцев | Обзор курса | |
| Профессия Python-разработчик Перейти на сайт курса | 140 040 ₽ | 3890 ₽/мес. | 10 месяцев | Обзор курса |
Больше программ — в полном каталоге курсов по Python




