Por qué Python lanza un IndentationError cuando el código parece perfectamente alineado

Python evalúa caracteres en bruto en lugar del ancho visual de las columnas. Un bloque impecable a la vista que lanza un IndentationError casi siempre sufre de tabulaciones y espacios mezclados o caracteres Unicode ocultos copiados de una ficha.
Cuando Python lanza un IndentationError o un TabError en una línea que a simple vista parece perfectamente alineada, la causa nunca es un problema de maquetación visual. Es un problema de bytes. Python analiza códigos de caracteres en bruto, no la posición de los píxeles en pantalla. Si una línea comienza con cuatro caracteres de espacio estándar (ASCII 32) y la siguiente comienza con un único carácter de tabulación horizontal (ASCII 9), un editor puede representarlos exactamente con el mismo nivel visual de sangría, pero Python 3 detecta dos convenciones de espacios en blanco incompatibles y detiene la ejecución.
Alineación visual frente a integridad de bytes
En la mayoría de los lenguajes de programación, los espacios en blanco son decorativos: el compilador recurre a llaves {} o a palabras clave como begin y end para delimitar bloques de código. Python utiliza la sangría para definir el alcance sintáctico. Con el fin de garantizar la coherencia, Python 3 prohíbe de forma explícita mezclar caracteres de tabulación y de espacio dentro del mismo bloque.
El problema en las aulas de iniciación es que los editores de código son motores de visualización configurables. Por defecto, entornos como Thonny, Mu o Visual Studio Code pueden mostrar un carácter de tabulación con un ancho visual de cuatro espacios. Para un alumno —y para un profesor que eche un vistazo por encima de su hombro a una pantalla compartida—, ambas líneas parecen situarse limpiamente en la columna 4:
- Línea 1:
[Espacio][Espacio][Espacio][Espacio]print("Motor running") - Línea 2:
[Tab]time.sleep(1)
Ambas se representan de manera idéntica con tipografías monoespaciadas. Sin embargo, el intérprete de Python se encuentra con dos bytes ASCII completamente distintos. Python 3 interpreta esta discrepancia como un nivel de sangría ambiguo y lanza TabError: inconsistent use of tabs and spaces in indentation o un IndentationError: unindent does not match any outer indentation level genérico.
La trampa de las fichas de trabajo: el espacio de no separación
Un fallo de aula todavía más frustrante se produce cuando los alumnos copian código de ejemplo de fichas digitales, documentos de Microsoft Word, Google Docs o archivos PDF exportados. Los procesadores de texto modernos no tratan los espacios en blanco como texto plano. Para mantener estable el formato del diseño entre los márgenes de página, sustituyen en silencio los espacios consecutivos por espacios de no separación (el carácter Unicode U+00A0, o el byte 0xC2 0xA0 en UTF-8).
Cuando un alumno selecciona ese fragmento de código y lo pega en Thonny o Mu, esos espacios de no separación se copian con él. Para el ojo humano, U+00A0 es totalmente indistinguible del espacio ASCII estándar U+0020. Sin embargo, el analizador léxico de Python lo rechaza de inmediato:
SyntaxError: invalid non-printable character U+00A0
O bien, si el editor intenta tratarlo como un identificador, devuelve un IndentationError poco explicativo. El alumno puede borrar y volver a introducir un espacio manualmente en esa línea sin resolver el problema si las líneas adyacentes aún contienen el carácter de no separación copiado.
Cómo configurar los IDE de iniciación para hacer visible lo invisible
La solución no consiste en pedir a los alumnos que miren con más atención; se trata de configurar el editor para que muestre los espacios en blanco de forma visible. Cuando los caracteres de espacio tienen glifos visibles, los alumnos pueden depurar sus propios errores de sangría en cuestión de segundos.
Configuración de Thonny
Thonny se utiliza ampliamente en aulas de informática de secundaria, espacios maker y clubes de programación de Sudáfrica gracias a su reducido consumo de memoria. Para corregir la ambigüedad de los espacios en blanco en todo un laboratorio:
- Vaya a Herramientas > Opciones (Tools > Options, o Thonny > Preferencias en macOS).
- Seleccione la pestaña Editor.
- Marque la casilla Mostrar caracteres de espacio (Show whitespace characters). Los espacios aparecerán ahora como discretos puntos grises (
·) y las tabulaciones como tenues flechas (→). - En la misma pestaña, asegúrese de que la opción Sangrar con espacios (Indent with spaces) esté activada y establezca el Tamaño de tabulación (Tab size) en
4. Cuando un alumno pulse la teclaTab, Thonny insertará cuatro caracteres de espacio ASCII estándar en lugar de un byte de tabulación.
Configuración de Mu
El editor Mu es deliberadamente minimalista para entornos micro:bit y CircuitPython, lo que implica que prescinde de paneles avanzados de preferencias. Sin embargo, Mu aplica automáticamente una rigurosa sangría de cuatro espacios cada vez que se pulsa la tecla Tab. Si los errores persisten en Mu:
- Haga clic en el botón Comprobar (Check) del menú superior. Mu resaltará las incoherencias de los espacios en blanco y señalará directamente la línea que contiene tabulaciones combinadas o espacios no estándar.
- Seleccione todo el texto (
Ctrl+AoCmd+A) y pulse Tab seguido de Mayús+Tab para obligar a Mu a reformatear la jerarquía de sangría a espacios estándar.
Configuración de VS Code
Para los alumnos de Senior Phase y FET que trabajen en Visual Studio Code, abra Configuración (Ctrl+,) y busque Render Whitespace. Establezca el valor en all o boundary. Asimismo, busque Insert Spaces y asegúrese de que esté marcado para que la tecla Tab siempre inserte espacios.
Un protocolo fiable para el aula
Cuando un aula entera de alumnos trabaja en retos de robótica o automatización, un profesor no puede dedicar veinte minutos a inspeccionar manualmente tabulaciones invisibles en treinta pantallas distintas. Enseñar a los alumnos este protocolo de resolución de problemas en tres pasos subsana la gran mayoría de los fallos de sangría:
| Paso | Acción | Mecanismo |
|---|---|---|
| 1. Revelar | Activar la visualización de espacios en blanco | Muestra al instante los puntos (espacios) y flechas (tabulaciones) combinados. |
| 2. Borrar | Retroceder hasta la columna cero | Elimina por completo los espacios de no separación ocultos o los bytes incompatibles. |
| 3. Volver a sangrar | Pulsar Tab una vez por nivel | Permite que la regla de conversión a espacios del editor inserte espacios ASCII limpios. |
Para los centros educativos que están desplegando la programación y la computación física, los recursos curriculares estructurados y los entornos de desarrollo basados en navegador contrastados —como los flujos de trabajo que desplegamos a través de Sheen Infinity for schools— ayudan a sortear por completo estas discrepancias de bajo nivel de los editores automatizando una buena higiene en la sangría desde el primer día.
Si un programa se niega a ejecutarse a pesar de parecer visualmente alineado, confíe en el error de Python antes que en sus ojos: elimine la sangría hasta el margen izquierdo y vuelva a sangrar utilizando únicamente caracteres de espacio correctamente configurados.



