Отладка кода: что это такое и как найти ошибку в программе

Отладка — это поиск и исправление ошибок в коде. Разбираем шесть шагов, которые подходят для любого языка, учимся читать трассировку Python и находим одну логическую ошибку через print() и встроенный отладчик pdb.

В конце горячие клавиши отладчика VS Code и частые ошибки новичков.

Статью написал:
Ваня Буявец, продюсер, основатель Checkroi
Ваня Буявец
Основатель Checkroi, продюсер, эксперт в выборе онлайн-курсов
Все 3286 статей автора Подписаться на Телеграм-канал
Одобрено экспертом:
Наташа Буявец, основатель Checkroi, эксперт по онлайн-курсам
Наташа Буявец
Основательница Checkroi, продюсер Youtube-каналов, эксперт по онлайн-курсам
Все 3940 экспертных мнений Подписаться на Телеграм-канал
Обложка: Отладка кода: что это такое и как найти ошибку в программе

Отладка — это поиск и исправление ошибок в программе. Код запускают, видят неверный результат или падение, находят строку, где всё пошло не так, и чинят причину. Быстрее всего это делается так: воспроизвести ошибку, прочитать сообщение интерпретатора, сузить место и проверить значения переменных через отладочный вывод или отладчик. Ниже разбираем отладку кода по шагам на живом примере на Python, а базовые понятия вроде переменных и циклов есть в статье про основы программирования.

По-английски процесс называют debugging, отсюда разговорные «дебаг» и «дебажить». Это одно и то же.

Что такое отладка простыми словами

Рой за ноутбуком ищет ошибку в коде

Программа почти никогда не работает правильно с первого запуска. Где-то опечатка, где-то цикл проходит на круг меньше, где-то в функцию пришёл не тот тип данных. Отладка программы закрывает этот разрыв между «написал» и «работает».

В справке Microsoft по Visual Studio сказано, что в буквальном смысле отладка означает удаление ошибок из вашего кода. Способов много: перечитать код, запустить анализатор, вывести значения на экран или подключить отладчик.

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

Отладка и тестирование: в чём разница

Эти слова часто ставят рядом, как в учебном курсе «тестирование и отладка», но задачи у них разные.

Тестирование Отладка
Вопрос Есть ли ошибка? Где она и почему возникла?
Кто делает Тестировщик или автотесты Разработчик, который пишет код
Результат Отчёт о дефекте: что сделали, что ждали, что получили Исправленный код
Инструменты Тест-кейсы, фреймворки автотестов Отладчик, логи, отладочный вывод

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

Какие ошибки ищут при отладке

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

Вид ошибки Как проявляется Пример на Python
Синтаксическая Программа не запускается совсем, интерпретатор указывает строку Забыли двоеточие после if
Ошибка выполнения Программа запускается и падает на какой-то строке с сообщением Обращение к несуществующему ключу словаря, деление на ноль
Логическая Программа работает без сообщений, но результат неверный Цикл пропускает первый элемент списка

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

В компилируемых языках вроде C++ часть ошибок находит компилятор ещё до запуска, в Python они всплывают только при выполнении. Почему так, объясняем в разборе компилируемых и интерпретируемых языков.

Канал основателя Checkroi Вани Буявца3 800 человек читают мой Телеграм-канал про нейросетиСобрал промпты для Claude Code и ChatGPT, разборы ИИ-инструментов и лайфхаки по продвижению бизнеса в одном местеПрисоединиться

Как отладить программу: 6 шагов

Рой радуется найденной ошибке

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

  1. Воспроизведите ошибку. Найдите входные данные, на которых она появляется каждый раз. Ошибку, которая случается «иногда», искать почти невозможно.
  2. Прочитайте сообщение целиком. Тип ошибки, файл и номер строки уже сужают поиск до нескольких строк.
  3. Сузьте место. Найдите последнюю точку, где данные ещё правильные, и первую, где уже нет. Ошибка между ними.
  4. Проверьте предположение. Выведите значения переменных через print() или остановите программу отладчиком и посмотрите на них.
  5. Исправьте одну вещь. Если поменять сразу три строки, будет непонятно, какая правка помогла, а какая сломала что-то ещё.
  6. Запустите снова на тех же данных. Убедитесь, что ошибка ушла, а остальное работает. Хорошая привычка: добавить автотест на этот случай, чтобы ошибка не вернулась.

Разберём шаги на коротком примере. Функция должна считать среднюю оценку:

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.

CheckroiCheckroiПодборка курсов по Python574 курса • 53 школыСравните цены, школы, программу и найдите выгодные предложения по обучениюСравнить→

Методы отладки: от 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С Встроенный отладчик конфигуратора
Ваня БуявецКанал основателя Checkroi Вани БуявцаЗабирайте промпты и обучение по нейросетям в моём Телеграм-каналеБольше 3 800 человек уже применяют Claude Code, ChatGPT и другие нейросети в работе, учёбе, бизнесе и жизниПерейти в канал

Частые ошибки при отладке

Проблемы самого процесса отладки повторяются у всех новичков.

  • Чинят до того, как поняли. Меняют код наугад, пока не заработает. Ошибка уходит, причина остаётся и всплывает в другом месте. Решение: сначала сформулируйте, почему ошибка возникла, потом правьте.
  • Не читают трассировку. Видят красный текст и сразу идут искать ответ в интернете. Решение: последняя строка сообщения обычно уже называет и тип ошибки, и место.
  • Ищут ошибку не там. Строка, где программа упала, и строка, где родились плохие данные, часто разные. Решение: идите по трассировке вверх и проверяйте, откуда пришло значение.
  • Оставляют отладочный мусор. Забытые print() и breakpoint() уезжают в рабочую версию. Решение: используйте logging или поиск по проекту перед отправкой кода.
  • Не проверяют после исправления. Решение: прогоните программу на тех данных, где ошибка была, и на паре обычных.

Если ошибки сыплются на каждом шаге, полезно вернуться к основам: типам данных и переменным. Половина ошибок новичков рождается именно там.

Где научиться программировать и отлаживать код системно

Отладка как навык растёт вместе с опытом: чем больше кода вы написали, тем быстрее видите типичные ловушки. На курсах по Python разбор ошибок идёт в каждом домашнем задании, а наставник показывает, как искать причину по трассировке и отладчику. Сравнить программы по цене и длительности можно в каталоге курсов по Python.

КурсШколаСтоимость со скидкойВ рассрочкуДлитель­ностьОбзор курса от Checkroi
Профессия «Python-разработчик»
Перейти на сайт курса
SkillboxSkillbox157 335 ₽5987 ₽/мес.10 месяцевОбзор курса
Fullstack-разработчик на Python
Перейти на сайт курса
НетологияНетология137 000 ₽7125 ₽/мес.21 месяцОбзор курса
ДО Профессия Python-разработчик
Перейти на сайт курса
GeekBrainsGeekBrains149 001 ₽3167 ₽/мес.10 месяцевОбзор курса
Автоматизированное тестирование на Python
Перейти на сайт курса
SkillboxSkillbox118 754 ₽4108 ₽/мес.9 месяцевОбзор курса
Профессия Python-разработчик
Перейти на сайт курса
SkillFactorySkillFactory140 040 ₽3890 ₽/мес.10 месяцевОбзор курса

Больше программ — в полном каталоге курсов по Python

Часто задаваемые вопросы

Чем отладка отличается от тестирования?

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

Что такое отладчик простыми словами?

Это программа, которая подключается к работающему коду, останавливает его на нужной строке и показывает значения переменных. В Python отладчик встроен и называется pdb, в VS Code им управляют горячими клавишами F5, F9, F10 и F11.

Что значит «дебажить» код?

Это разговорная калька с английского debugging, то есть отлаживать: искать и исправлять ошибки в программе. «Дебаг», «дебаггинг» и «отладка» означают одно и то же.

Можно ли отлаживать программу без IDE?

Можно. Самый простой способ: вывести значения переменных через print(), а в Python есть встроенный отладчик: запустите скрипт командой python3 -m pdb имя_файла.py или поставьте в коде строку breakpoint().

Почему assert в Python не сработал?

Скорее всего, программа запущена с флагом -O: в этом режиме Python не генерирует код для assert, и проверки пропускаются. Поэтому assert годится для отладки, а пользовательский ввод проверяют обычным if.

Как найти ошибку в программе, если сообщения об ошибке нет?

Это логическая ошибка: программа работает, но считает неверно. Найдите последнее место, где данные ещё правильные, и первое, где уже нет, и посмотрите значения переменных между ними через print() или точку останова в отладчике.

Читайте Checkroi первым в Google
Добавьте Checkroi в избранные источники — и наши разборы курсов и обзоры школ будут показываться выше в вашей выдаче Google.
Оставить комментарий
0 комментариев
Форма комментария

Оставьте комментарий

Напишите, что думаете. Нам важно ваше мнение!