Perché Python genera un IndentationError quando il codice sembra perfettamente allineato

Python valuta i singoli caratteri anziché la larghezza visiva della colonna. Un blocco visivamente perfetto che genera un IndentationError soffre quasi sempre di una combinazione di tabulazioni e spazi o di caratteri Unicode nascosti copiati da una scheda didattica.
Quando Python genera un IndentationError o un TabError su una riga che all'occhio umano sembra perfettamente allineata, la causa non è mai un problema di layout visivo. È un problema di byte. Python analizza i codici dei singoli caratteri, non la posizione dei pixel sullo schermo. Se una riga inizia con quattro caratteri spazio standard (ASCII 32) e la successiva inizia con un singolo carattere di tabulazione orizzontale (ASCII 9), un editor può visualizzarli esattamente allo stesso livello di rientro visivo, ma Python 3 rileva due convenzioni incompatibili per gli spazi vuoti e interrompe l'esecuzione.
Allineamento visivo contro integrità dei byte
Nella maggior parte dei linguaggi di programmazione, lo spazio bianco è decorativo: il compilatore si affida a parentesi graffe {} o a parole chiave come begin ed end per delimitare i blocchi di codice. Python utilizza invece l'indentazione per definire l'ambito sintattico. Per garantire la prevedibilità, Python 3 vieta espressamente l'uso promiscuo di caratteri di tabulazione e spazi all'interno dello stesso blocco.
Nelle classi di principianti, il problema è che gli editor di codice sono motori di rendering configurabili. Per impostazione predefinita, ambienti come Thonny, Mu o Visual Studio Code possono mostrare un carattere di tabulazione con una larghezza visiva pari a quattro spazi. Agli occhi di uno studente — e di un docente che osserva lo schermo da sopra la sua spalla — entrambe le righe sembrano posizionate perfettamente alla colonna 4:
- Riga 1:
[Space][Space][Space][Space]print("Motor running") - Riga 2:
[Tab]time.sleep(1)
Entrambe vengono visualizzate in modo identico con caratteri a spaziatura fissa (monospace). Eppure l'interprete Python incontra due byte ASCII completamente diversi. Python 3 interpreta questa discrepanza come un livello di rientro ambiguo e genera TabError: inconsistent use of tabs and spaces in indentation o un generico IndentationError: unindent does not match any outer indentation level.
La trappola delle schede didattiche: lo spazio indivisibile
Una dinamica di errore ancora più frustrante in classe si verifica quando gli studenti copiano porzioni di codice di esempio da dispense digitali, documenti Microsoft Word, Google Documenti o PDF esportati. I moderni elaboratori di testo non trattano lo spazio bianco come semplice testo normale. Per mantenere stabile l'impaginazione lungo i margini della pagina, i programmi di videoscrittura sostituiscono silenziosamente gli spazi consecutivi con spazi indivisibili (carattere Unicode U+00A0 o byte 0xC2 0xA0 in UTF-8).
Quando uno studente seleziona quello snippet di codice e lo incolla in Thonny o Mu, questi spazi indivisibili vengono trasferiti insieme al codice. All'occhio umano, U+00A0 è del tutto indistinguibile dallo spazio ASCII standard U+0020. L'analizzatore lessicale di Python, tuttavia, lo rifiuta immediatamente:
SyntaxError: invalid non-printable character U+00A0
Oppure, se l'editor tenta di interpretarlo come un identificatore, genera un fuorviante IndentationError. Lo studente può cancellare e reinserire manualmente uno spazio su quella riga senza risolvere il problema, qualora le righe circostanti contengano ancora il carattere indivisibile copiato.
Configurare gli IDE per principianti per rendere visibile l'invisibile
La soluzione non è dire agli studenti di guardare con più attenzione; consiste nel configurare l'editor affinché mostri visivamente gli spazi vuoti. Quando i caratteri di spaziatura hanno glifi visibili, gli studenti possono individuare e correggere i propri errori di indentazione in pochi secondi.
Configurare Thonny
Thonny è ampiamente utilizzato nei laboratori informatici, nei makerspace e nei club di programmazione delle scuole superiori sudafricane grazie al suo ridotto consumo di memoria. Per risolvere l'ambiguità degli spazi nell'intero laboratorio:
- Accedere a Strumenti > Opzioni (o Thonny > Preferenze su macOS).
- Selezionare la scheda Editor.
- Spuntare la casella Mostra caratteri di spaziatura. Gli spazi appariranno ora come piccoli punti grigi (
·) e le tabulazioni come frecce sottili (→). - Nella stessa scheda, assicurarsi che Rientro con spazi sia selezionato e impostare Dimensione tabulazione su
4. Quando uno studente preme il tastoTab, Thonny inserirà quattro caratteri spazio ASCII standard anziché un byte di tabulazione.
Configurare Mu
L'editor Mu è volutamente minimalista per gli ambienti micro:bit e CircuitPython, il che significa che non dispone di pannelli di preferenze avanzati. Tuttavia, Mu applica rigorosamente un'indentazione di quattro spazi in modo automatico alla pressione del tasto Tab. Quando gli errori persistono in Mu:
- Fare clic sul pulsante Controlla (Check) nel menu superiore. Mu evidenzierà le incongruenze di spaziatura indicando direttamente la riga che contiene tabulazioni miste o spazi non standard.
- Selezionare tutto il testo (
Ctrl+AoCmd+A) e premere Tab seguito da Shift+Tab per forzare Mu a riformattare la gerarchia di indentazione con spazi standard.
Configuring VS Code
Per gli studenti della Senior Phase e del FET che lavorano in Visual Studio Code, aprire le Impostazioni (Ctrl+,) e cercare Render Whitespace. Impostare il valore su all o boundary. Inoltre, cercare Insert Spaces e verificare che la casella sia spuntata, in modo che il tasto Tab inserisca sempre spazi.
Un protocollo affidabile per la classe
Quando un'intera classe di studenti affronta sfide di robotica o automazione in laboratorio, un insegnante non può dedicare venti minuti a ispezionare manualmente tabulazioni invisibili su trenta schermi diversi. Insegnare agli studenti questo protocollo di risoluzione dei problemi in tre passaggi risolve la stragrande maggioranza degli errori di rientro:
| Passo | Azione | Meccanismo |
|---|---|---|
| 1. Rendi visibile | Attiva la visualizzazione degli spazi | Mostra istantaneamente punti (spazi) e frecce (tabulazioni) misti. |
| 2. Elimina | Cancella con Backspace fino alla colonna zero | Rimuove del tutto spazi indivisibili nascosti o byte non corrispondenti. |
| 3. Re-indenta | Premi Tab una volta per livello | Consente alla regola di conversione spazi dell'editor di inserire spazi ASCII puliti. |
Per le scuole che introducono la programmazione e il physical computing, risorse curricolari strutturate e ambienti di sviluppo basati su browser verificati — come i flussi di lavoro che distribuiamo tramite Sheen Infinity for schools — consentono di evitare del tutto queste discrepanze di basso livello negli editor, automatizzando la corretta gestione dell'indentazione fin dal primo giorno.
Se uno script si rifiuta di funzionare nonostante appaia visivamente allineato, fidati dell'errore di Python e non dei tuoi occhi: cancella l'indentazione fino al margine sinistro e re-indenta utilizzando esclusivamente caratteri spazio configurati.



