Python: IndentationError и TabError — ошибка отступов
В Python отступ в начале строки — часть программы: по нему Python понимает, какие строки входят в if, for, функцию или класс. Если отступ не тот, программа не запустится.
Содержание 7
Как выглядит ошибка
Python показывает файл, номер строки и саму строку, а в конце — тип ошибки и её текст:
File "/home/ivan/myapp/app.py", line 3
print('Готово')
…
IndentationError: expected an indented block after 'if' statement on line 2Здесь в строке 2 стоит if с двоеточием, а строка 3 под ним не сдвинута вправо. Если программа запущена службой, ищите эти строки в журнале: sudo journalctl -u myapp -n 30 (про journalctl). Тексты ошибок сверены с исходным кодом Python 3.12.3 — эта версия стоит в Ubuntu 24.04 — и Python 3.14.4 из пакета python3.14 в Ubuntu 26.04.
Что значит сообщение
| Текст ошибки | Что случилось | Что сделать |
|---|---|---|
expected an indented block after 'if' statement on line 2 | после строки с двоеточием нет ни одной сдвинутой строки; вместо if может стоять for, while, with, try, else, function definition — функция или class definition — класс | сдвиньте строки, которые входят в этот блок, на 4 пробела вправо; если блок пока пустой, напишите в нём pass |
unexpected indent | строка сдвинута вправо, хотя над ней нет строки с двоеточием | уберите лишние пробелы в начале строки |
unindent does not match any outer indentation level | строка сдвинута назад, но не до уровня ни одной строки выше: например на 2 пробела, а выше блоки с 0 и 4 пробелами | выровняйте отступ по строкам того же блока |
TabError: inconsistent use of tabs and spaces in indentation | в отступах смешаны табуляция и пробелы — на экране они выглядят одинаково | замените табуляцию пробелами — как |
IndentationError и TabError — разновидности SyntaxError: Python не может прочитать текст программы и не выполняет из неё ни одной строки.
Шаг 1. Откройте строку из сообщения
Команды на этой странице вводятся на сервере: подключитесь к нему по SSH (как подключиться) и набирайте их в том же окне. Номер строки стоит после line, вместо app.py подставьте свой файл:
nano -l +3 app.pyКлюч -l покажет номера строк слева, +3 поставит курсор на третью строку. Посмотрите на эту строку и на ту, что над ней: у строк одного блока отступ одинаковый, в Python принято по 4 пробела на уровень. Исправьте отступ, сохраните файл — Ctrl+O и Enter, выйдите — Ctrl+X. Подробнее о редакторе — Редактор nano.
Python замечает ошибку на той строке, где отступ уже не сходится. Причина может быть выше: например лишний пробел в строке 2 даёт ошибку в строке 3.
Если в ошибке TabError
Найдите строки, где в отступе есть табуляция:
grep -n -P '^[ \t]*\t' app.pyВ ответе — номера строк и сами строки. Быстрее заменить табуляцию пробелами во всём файле сразу. Сначала сделайте копию файла:
cp app.py app.py.bakЗатем запишите исправленный файл рядом и поставьте его на место старого:
expand -i -t 4 app.py > app-fixed.py
mv app-fixed.py app.pyКлюч -i меняет табуляцию только в начале строк, а внутри строк с текстом не трогает. Ключ -t 4 — ширина табуляции: столько пробелов она занимала в редакторе, где писали код. Если после замены появится unindent does not match, верните копию командой cp app.py.bak app.py и попробуйте -t 8.
Чтобы nano сам ставил пробелы вместо табуляции, откройте файл так:
nano -E -T 4 app.pyКлюч -E заменяет нажатую клавишу Tab пробелами, -T 4 задаёт ширину табуляции.
Как проверить
Проверьте файл без запуска программы — Python только прочитает его:
python3 -m py_compile app.py && echo OKЕсли ошибок нет, появится OK. Если ошибка осталась, Python покажет её с номером строки, например:
Sorry: IndentationError: unexpected indent (app.py, line 4)Исправьте эту строку и проверьте снова. Если приложение запускается из окружения venv, проверяйте тем же Python: venv/bin/python -m py_compile app.py. Если приложение работает службой, перезапустите её: sudo systemctl restart myapp. Если приложение запущено как служба systemd, имя службы в примерах — myapp, папка — /home/ivan/myapp. Подставьте свои.
Источники
- Исходный код Python 3.12.3: Grammar/python.gram — expected an indented block after…, unexpected indent.
- Исходный код Python 3.12.3: Parser/pegen_errors.c — unindent does not match…, TabError.
- Исходный код Python 3.14.4: Grammar/python.gram — те же сообщения в Python 3.14.
- Исходный код Python 3.12.3: Lib/py_compile.py — что выводит python3 -m py_compile.
- Исходный код coreutils 9.4: src/expand.c — ключи -i и -t команды expand.
- Справка nano 7.2 — ключи -l, -E и -T.
Сверено 22 октября 2026 года.
Что почитать дальше
- Редактор nano.
- SyntaxError в Pythonдругие ошибки в тексте программы.
- Все ошибки Python и pipтаблица по тексту сообщения.