Логотип sheen.bot

← Идеи и опыт

Почему Python выдает IndentationError, когда код кажется идеально выровненным

18 нояб. 2026 г.·Sheen Robotics
Почему Python выдает IndentationError, когда код кажется идеально выровненным

Python считывает фактические символы, а не визуальную ширину колонок. Если внешне безупречный блок кода вызывает IndentationError, причина почти всегда кроется в смешении табуляций и пробелов либо в скрытых символах Юникода, скопированных из раздаточного материала.

Когда Python выдает IndentationError или TabError на строке, которая визуально кажется человеку идеально выровненной, проблема никогда не связана с отображением на экране. Это проблема на уровне байтов. Python анализирует исходные коды символов, а не пиксели на мониторе. Если одна строка начинается с четырех стандартных пробелов (ASCII 32), а следующая — с одного символа горизонтальной табуляции (ASCII 9), редактор может отобразить их на абсолютно одинаковом визуальном уровне отступа, однако Python 3 распознает два несовместимых способа расстановки пробельных символов и аварийно завершает работу.

Визуальное выравнивание против байтовой целостности

В большинстве языков программирования пробельные символы выполняют лишь декоративную функцию: компилятор полагается на фигурные скобки {} или ключевые слова вроде begin и end для выделения блоков кода. Python же использует отступы для определения синтаксической области видимости. Чтобы обеспечить предсказуемость, Python 3 явно запрещает смешивать символы табуляции и пробелы внутри одного и того же блока.

Сложность на уроках для начинающих заключается в том, что редакторы кода представляют собой настраиваемые средства визуализации. По умолчанию такие среды, как Thonny, Mu или Visual Studio Code, могут отображать символ табуляции с визуальной шириной в четыре пробела. Ученику — да и учителю, заглядывающему через плечо на экран, — кажется, что обе строки четко начинаются с 4-й колонки:

  • Строка 1: [Пробел][Пробел][Пробел][Пробел]print("Motor running")
  • Строка 2: [Tab]time.sleep(1)

В моноширинных шрифтах обе строки выглядят идентично. Однако интерпретатор Python видит два совершенно разных байта ASCII. Python 3 воспринимает это несоответствие как неоднозначный уровень отступа и выдает ошибку TabError: inconsistent use of tabs and spaces in indentation либо общую IndentationError: unindent does not match any outer indentation level.

Копирование из раздаточных материалов: ловушка неразрывного пробела

Еще более неприятная для учебного процесса ситуация возникает, когда учащиеся копируют примеры кода из электронных раздаточных материалов, документов Microsoft Word, Google Docs или экспортированных PDF-файлов. Современные текстовые процессоры не относятся к пробелам как к обычному тексту. Чтобы сохранить форматирование макета в пределах полей страницы, текстовые редакторы незаметно заменяют идущие подряд пробелы неразрывными пробелами (символ Юникода U+00A0 или байты 0xC2 0xA0 в кодировке UTF-8).

Когда ученик выделяет фрагмент кода и вставляет его в Thonny или Mu, эти неразрывные пробелы переносятся вместе с текстом. Для человеческого глаза U+00A0 ничем не отличается от стандартного пробела ASCII U+0020. Однако лексический анализатор Python мгновенно отклоняет его:

SyntaxError: invalid non-printable character U+00A0

Либо, если редактор пытается обработать его как идентификатор, система выдает малопонятную ошибку IndentationError. Ученик может вручную удалить и снова ввести пробел в этой строке, но это не решит проблему, если соседние строки по-прежнему содержат скопированный неразрывный пробел.

Настройка учебных IDE: делаем невидимое видимым

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

Настройка Thonny

Thonny широко используется в компьютерных классах средних школ, мейкерспейсах и кружках программирования Южной Африки благодаря низким системным требованиям. Чтобы устранить неоднозначность с отступами во всем компьютерном классе:

  1. Перейдите в меню Инструменты > Параметры (Tools > Options; или Thonny > Параметры на macOS).
  2. Выберите вкладку Редактор (Editor).
  3. Установите флажок Показывать пробельные символы (Show whitespace characters). Теперь пробелы будут отображаться неяркими серыми точками (·), а табуляции — тонкими стрелками (→).
  4. На этой же вкладке убедитесь, что включен параметр Отступ пробелами (Indent with spaces), и установите значение Размер табуляции (Tab size) равным 4. Теперь при нажатии клавиши Tab Thonny будет вставлять четыре стандартных символа пробела ASCII вместо байта табуляции.

Настройка Mu

Редактор Mu намеренно сделан минималистичным для работы со средами micro:bit и CircuitPython, поэтому в нем нет панелей с расширенными настройками. Тем не менее Mu автоматически строго применяет отступ в четыре пробела при нажатии клавиши Tab. Если ошибки в Mu продолжают возникать:

  • Нажмите кнопку Check («Проверить») в верхнем меню. Mu подсветит несоответствия пробельных символов и укажет непосредственно на строку со смешанными табуляциями или нестандартными пробелами.
  • Выделите весь текст (сочетанием клавиш Ctrl+A или Cmd+A) и нажмите клавишу Tab, а затем Shift+Tab, чтобы заставить Mu заново выровнять структуру отступов стандартными пробелами.

Настройка VS Code

Для учащихся старших классов (фаз Senior Phase и FET), работающих в Visual Studio Code, откройте «Параметры» (сочетание Ctrl+,) и найдите пункт Render Whitespace. Установите значение all или boundary. Кроме того, найдите параметр Insert Spaces и убедитесь, что флажок установлен — тогда клавиша Tab всегда будет вставлять пробелы.

Надежный алгоритм действий для урока

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

ШагДействиеПринцип работы
1. ПоказатьВключить отображение пробельных символовМгновенно выявляет смешение точек (пробелов) и стрелок (табуляций).
2. УдалитьКлавишей Backspace вернуть строку в нулевую колонкуПолностью удаляет скрытые неразрывные пробелы или несоответствующие байты.
3. Задать зановоНажать Tab по разу для каждого уровня отступаПозволяет правилу автозамены редактора вставить корректные пробелы ASCII.

Школам, внедряющим программирование и физические вычисления, структурированные учебные материалы и проверенные браузерные среды разработки — такие как решения, развертываемые нами через Sheen Infinity for schools, — помогают полностью избежать подобных проблем на уровне редактора благодаря автоматическому соблюдению правил форматирования отступов с первого же дня.

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

#python#отладка#обучение информатике#thonny#программирование в школе

Больше в категории «Идеи и опыт»

Почему SD-карты Raspberry Pi повреждаются в школьных классах (и как это исправить)
Идеи и опыт· 17 нояб. 2026 г.

Почему SD-карты Raspberry Pi повреждаются в школьных классах (и как это исправить)

Внезапные отключения питания и выдернутые кабели повреждают SD-карты, прерывая циклы записи во флеш-память. Встроенный оверлей только для чтения решает проблему без покупки ИБП.

Читать далее →
Помогает ли школьная робототехника при поступлении на инженерные специальности в ЮАР?
Идеи и опыт· 15 нояб. 2026 г.

Помогает ли школьная робототехника при поступлении на инженерные специальности в ЮАР?

Инженерные факультеты южноафриканских университетов принимают абитуриентов по сухому расчету: баллам APS за профильную математику и физику. Робототехника не спасет 65% по математике, но кардинально повысит шансы на собеседованиях на получение стипендий и поможет выжить на первом курсе.

Читать далее →
Как предотвратить потерю и путаницу деталей в робототехнических наборах
Идеи и опыт· 14 нояб. 2026 г.

Как предотвратить потерю и путаницу деталей в робототехнических наборах

Открытые контейнеры неизбежно приводят к потере деталей, когда уроки идут один за другим. Решение кроется в системной организации: нумерация рабочих мест, ложементы с силуэтами деталей и обязательная двухминутная проверка перед звонком.

Читать далее →