sheen.bot-Logo

← Einblicke

Warum Python einen IndentationError ausgibt, obwohl der Code perfekt ausgerichtet aussieht

18. Nov. 2026·Sheen Robotics
Warum Python einen IndentationError ausgibt, obwohl der Code perfekt ausgerichtet aussieht

Python wertet rohe Zeichen aus statt der visuellen Spaltenbreite. Ein optisch einwandfreier Block, der einen IndentationError auslöst, leidet fast immer unter gemischten Tabs und Leerzeichen oder versteckten Unicode-Zeichen, die aus einem Arbeitsblatt kopiert wurden.

Wenn Python einen IndentationError oder TabError in einer Zeile meldet, die für das menschliche Auge perfekt ausgerichtet aussieht, liegt die Ursache nie an einem visuellen Layoutproblem. Es ist ein Byte-Problem. Python analysiert rohe Zeichencodes, keine Pixelpositionen auf dem Bildschirm. Wenn eine Zeile mit vier standardmäßigen Leerzeichen (ASCII 32) beginnt und die nächste mit einem einzelnen horizontalen Tabulatorzeichen (ASCII 9), stellt ein Editor beide möglicherweise auf genau derselben visuellen Einrückungsebene dar – Python 3 sieht jedoch zwei inkompatible Whitespace-Konventionen und bricht die Ausführung ab.

Visuelle Ausrichtung im Vergleich zur Byte-Integrität

In den meisten Programmiersprachen sind Leerzeichen und Einrückungen rein dekorativ: Der Compiler verlässt sich auf geschweifte Klammern {} oder Schlüsselwörter wie begin und end, um Codeblöcke abzugrenzen. Python hingegen nutzt die Einrückung, um den syntaktischen Gültigkeitsbereich zu definieren. Um Eindeutigkeit zu gewährleisten, verbietet Python 3 das Mischen von Tabulatoren und Leerzeichen innerhalb desselben Blocks ausdrücklich.

Das Problem im Unterricht mit Einsteigern besteht darin, dass Code-Editoren konfigurierbare Anzeigewerkzeuge sind. Standardmäßig stellen Entwicklungsumgebungen wie Thonny, Mu oder Visual Studio Code ein Tabulatorzeichen oft mit einer visuellen Breite von vier Leerzeichen dar. Für Lernende – und für Lehrkräfte, die ihnen über die Schulter auf den Bildschirm schauen – scheinen beide Zeilen sauber in Spalte 4 zu beginnen:

  • Zeile 1: [Leerzeichen][Leerzeichen][Leerzeichen][Leerzeichen]print("Motor running")
  • Zeile 2: [Tab]time.sleep(1)

Beide Varianten werden in Monospace-Schriftarten identisch dargestellt. Dennoch stößt der Python-Interpreter auf zwei völlig unterschiedliche ASCII-Bytes. Python 3 interpretiert diese Diskrepanz als uneindeutige Einrückungsebene und gibt TabError: inconsistent use of tabs and spaces in indentation oder ein allgemeines IndentationError: unindent does not match any outer indentation level aus.

Die Arbeitsblatt-Falle: Das geschützte Leerzeichen

Eine noch frustrierendere Fehlerquelle im Unterricht entsteht, wenn Lernende Beispielcode aus digitalen Handouts, Microsoft-Word-Dokumenten, Google Docs oder exportierten PDFs kopieren. Moderne Textverarbeitungsprogramme behandeln Whitespace nicht als reinen Text. Um das Layout über Seitenränder hinweg stabil zu halten, ersetzen Textverarbeitungsprogramme aufeinanderfolgende Leerzeichen stillschweigend durch geschützte Leerzeichen (Non-breaking Spaces, Unicode-Zeichen U+00A0 oder Byte 0xC2 0xA0 in UTF-8).

Wenn Lernende diesen Codeschnipsel markieren und in Thonny oder Mu einfügen, werden diese geschützten Leerzeichen mitkopiert. Für das menschliche Auge ist U+00A0 vom regulären ASCII-Leerzeichen U+0020 absolut nicht zu unterscheiden. Der lexikalische Scanner von Python weist es jedoch sofort zurück:

SyntaxError: invalid non-printable character U+00A0

Oder der Editor versucht, es als Bezeichner zu behandeln, und löst stattdessen einen wenig hilfreichen IndentationError aus. Lernende können in dieser Zeile manuell ein Leerzeichen löschen und neu einfügen, ohne das Problem zu beheben, wenn die umliegenden Zeilen weiterhin das kopierte geschützte Leerzeichen enthalten.

Einsteiger-IDEs konfigurieren, um das Unsichtbare sichtbar zu machen

Die Lösung besteht nicht darin, Lernenden zu sagen, sie sollten genauer hinsehen – sondern darin, den Editor so einzustellen, dass Leerzeichen und Tabulatoren sichtbar dargestellt werden. Wenn Whitespace-Zeichen sichtbare Glyphen erhalten, können Lernende ihre Einrückungsfehler innerhalb von Sekunden selbst beheben.

Thonny konfigurieren

Thonny wird in südafrikanischen Computerräumen an weiterführenden Schulen, in Makerspaces und Coding-Clubs aufgrund seines geringen Speicherbedarfs häufig eingesetzt. Um Whitespace-Mehrdeutigkeiten im gesamten Computerraum zu beseitigen:

  1. Navigieren Sie zu Tools > Options (oder Thonny > Preferences unter macOS).
  2. Wählen Sie den Reiter Editor.
  3. Aktivieren Sie das Kontrollkästchen Show whitespace characters. Leerzeichen erscheinen nun als dezente graue Punkte (·) und Tabulatoren als schwache Pfeile (→).
  4. Stellen Sie auf demselben Reiter sicher, dass Indent with spaces aktiviert ist, und setzen Sie Tab size auf 4. Wenn Lernende die Tab-Taste drücken, fügt Thonny vier standardmäßige ASCII-Leerzeichen statt eines Tabulator-Bytes ein.

Mu konfigurieren

Der Mu-Editor ist für Umgebungen mit micro:bit und CircuitPython bewusst minimalistisch gehalten, weshalb er auf erweiterte Einstellungsmenüs verzichtet. Allerdings erzwingt Mu beim Drücken der Tab-Taste automatisch strikt eine Einrückung von vier Leerzeichen. Wenn in Mu weiterhin Fehler auftreten:

  • Klicken Sie im oberen Menü auf die Schaltfläche Check. Mu hebt Whitespace-Inkonsistenzen hervor und verweist direkt auf die Zeile, die gemischte Tabs oder nicht-standardmäßige Leerzeichen enthält.
  • Wählen Sie den gesamten Text aus (Strg+A oder Cmd+A) und drücken Sie Tab gefolgt von Umschalt+Tab, um Mu dazu zu zwingen, die Einrückungshierarchie in standardmäßige Leerzeichen neu zu formatieren.

VS Code konfigurieren

Für Lernende der Senior Phase und FET, die in Visual Studio Code arbeiten, öffnen Sie die Einstellungen (Strg+,) und suchen nach Render Whitespace. Setzen Sie den Wert auf all oder boundary. Suchen Sie außerdem nach Insert Spaces und stellen Sie sicher, dass die Option aktiviert ist, damit die Tab-Taste stets Leerzeichen einfügt.

Ein verlässliches Vorgehen für den Unterricht

Wenn ein ganzer Computerraum voller Lernender an Robotik- oder Automatisierungsaufgaben arbeitet, kann eine Lehrkraft nicht zwanzig Minuten damit verbringen, auf dreißig verschiedenen Bildschirmen unsichtbare Tabulatoren manuell aufzuspüren. Die Vermittlung dieses dreistufigen Fehlerbehebungsprotokolls löst die überwiegende Mehrheit aller Einrückungsfehler:

SchrittAktionMechanismus
1. Sichtbar machenWhitespace-Darstellung aktivierenMacht gemischte Punkte (Leerzeichen) und Pfeile (Tabs) sofort sichtbar.
2. EntfernenPer Rücktaste bis Spalte null löschenEntfernt versteckte geschützte Leerzeichen oder abweichende Bytes vollständig.
3. Neu einrückenTab einmal pro Ebene drückenErmöglicht es der Ersetzungsregel des Editors, saubere ASCII-Leerzeichen einzufügen.

Für Schulen, die Coding und Physical Computing einführen, helfen strukturierte Lehrplanressourcen und geprüfte browserbasierte Entwicklungsumgebungen – wie etwa die Workflows, die wir über Sheen Infinity for schools bereitstellen –, solche hardwarenahen Editor-Diskrepanzen von vornherein zu vermeiden, indem eine saubere Einrückung von Tag eins an automatisiert wird.

Wenn sich ein Skript trotz optisch sauberer Ausrichtung weigert zu laufen, vertrauen Sie der Fehlermeldung von Python mehr als Ihren Augen: Löschen Sie die Einrückung bis zum linken Rand und rücken Sie den Code ausschließlich mit sauber konfigurierten Leerzeichen neu ein.

#Python#Debugging#Informatikunterricht#Thonny#Programmieren an Schulen

Mehr aus Einblicke