logo sheen.bot

← Perspectives

Pourquoi Python renvoie une IndentationError alors que le code semble parfaitement aligné

18 nov. 2026·Sheen Robotics
Pourquoi Python renvoie une IndentationError alors que le code semble parfaitement aligné

Python évalue les caractères bruts plutôt que la largeur visuelle des colonnes. Un bloc visuellement parfait qui déclenche une IndentationError cache presque toujours un mélange de tabulations et d'espaces, ou des caractères Unicode invisibles copiés depuis une fiche d'exercices.

Lorsque Python lève une IndentationError ou une TabError sur une ligne qui semble parfaitement alignée à l'œil nu, la cause n'est jamais un problème de mise en page visuelle. C'est un problème d'octets. Python analyse des codes de caractères bruts, et non la position des pixels à l'écran. Si une ligne commence par quatre espaces standards (ASCII 32) et la suivante par une seule tabulation horizontale (ASCII 9), un éditeur peut les afficher exactement au même niveau d'indentation visuel, mais Python 3 y voit deux conventions d'espacement incompatibles et interrompt l'exécution.

Alignement visuel ou intégrité des octets

Dans la plupart des langages de programmation, les espaces et tabulations sont purement décoratifs : le compilateur s'appuie sur des accolades {} ou des mots-clés comme begin et end pour délimiter les blocs de code. Python, lui, utilise l'indentation pour définir la portée syntaxique. Afin de garantir un comportement prévisible, Python 3 interdit explicitement de mélanger tabulations et espaces au sein d'un même bloc.

En classe avec des débutants, le problème vient du fait que les éditeurs de code sont des moteurs d'affichage configurables. Par défaut, des environnements comme Thonny, Mu ou Visual Studio Code peuvent afficher une tabulation avec une largeur visuelle de quatre espaces. Pour un élève — comme pour un enseignant qui jette un coup d'œil par-dessus son épaule à un écran partagé —, les deux lignes semblent parfaitement alignées sur la colonne 4 :

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

Toutes deux s'affichent de manière identique avec une police à chasse fixe. Pourtant, l'interpréteur Python rencontre deux octets ASCII totalement distincts. Python 3 interprète cette incohérence comme un niveau d'indentation ambigu et renvoie TabError: inconsistent use of tabs and spaces in indentation ou une erreur générique IndentationError: unindent does not match any outer indentation level.

Le piège des fiches de travail : l'espace insécable

Une situation encore plus frustrante en classe se produit lorsque les élèves copient des exemples de code depuis des polycopiés numériques, des documents Microsoft Word, Google Docs ou des fichiers PDF exportés. Les traitements de texte modernes ne traitent pas les espaces comme du texte brut. Pour préserver la mise en page au niveau des marges, ils remplacent discrètement les espaces consécutifs par des espaces insécables (caractère Unicode U+00A0, ou octets 0xC2 0xA0 en UTF-8).

Lorsqu'un élève sélectionne cet extrait de code et le colle dans Thonny ou Mu, ces espaces insécables s'y glissent également. À l'œil nu, U+00A0 ne se distingue absolument pas de l'espace ASCII standard U+0020. Mais l'analyseur lexical de Python le rejette immédiatement :

SyntaxError: invalid non-printable character U+00A0

Ou bien, si l'éditeur tente de le traiter comme un identifiant, il renvoie une IndentationError peu explicite. L'élève peut supprimer et ajouter à nouveau un espace manuellement sur cette ligne sans résoudre le problème si les lignes adjacentes contiennent toujours le caractère insécable copié.

Configurer les IDE pour débutants afin de rendre l'invisible visible

La solution ne consiste pas à demander aux élèves de regarder de plus près, mais à configurer l'éditeur pour afficher les caractères d'espacement. Lorsque ces caractères disposent de glyphes visibles, les élèves peuvent corriger eux-mêmes leurs erreurs d'indentation en quelques secondes.

Configurer Thonny

Thonny est largement utilisé dans les salles informatiques des lycées sud-africains, les fablabs et les clubs de programmation en raison de sa faible consommation de mémoire. Pour éliminer toute ambiguïté d'espacement dans toute une salle informatique :

  1. Allez dans Outils > Options (ou Thonny > Préférences sur macOS).
  2. Sélectionnez l'onglet Éditeur.
  3. Cochez la case Afficher les caractères d'espacement. Les espaces apparaîtront alors sous la forme de discrets points gris (·) et les tabulations sous la forme de flèches légères (→).
  4. Dans ce même onglet, assurez-vous que l'option Indenter avec des espaces est cochée et réglez la Taille de tabulation sur 4. Lorsqu'un élève appuie sur la touche Tab, Thonny insère alors quatre caractères espace ASCII standard au lieu d'un octet de tabulation.

Configurer Mu

L'éditeur Mu est volontairement minimaliste pour les environnements micro:bit et CircuitPython, ce qui signifie qu'il masque les panneaux de préférences avancés. Cependant, Mu impose automatiquement une indentation stricte de quatre espaces lorsque l'on appuie sur la touche Tab. Lorsque les erreurs persistent dans Mu :

  • Cliquez sur le bouton Vérifier (Check) dans le menu supérieur. Mu mettra en évidence les incohérences d'espacement et pointera directement la ligne contenant un mélange de tabulations ou des espaces non standards.
  • Sélectionnez tout le texte (Ctrl+A ou Cmd+A) et appuyez sur Tab suivi de Maj+Tab pour forcer Mu à reformater la hiérarchie d'indentation avec des espaces standards.

Configurer VS Code

Pour les élèves de Senior Phase et du cycle FET travaillant dans Visual Studio Code, ouvrez les Paramètres (Ctrl+,) et recherchez Render Whitespace. Réglez la valeur sur all ou boundary. Recherchez également Insert Spaces et assurez-vous que la case est cochée pour que la touche Tabulation insère toujours des espaces.

Un protocole de classe fiable

Quand toute une classe d'élèves travaille sur des défis de robotique ou d'automatisation, un enseignant ne peut pas passer vingt minutes à inspecter manuellement des tabulations invisibles sur trente écrans différents. Enseigner aux élèves ce protocole de dépannage en trois étapes résout la grande majorité des erreurs d'indentation :

StepActionMechanism
1. RévélerActiver l'affichage des caractères d'espacementRévèle instantanément le mélange de points (espaces) et de flèches (tabulations).
2. SupprimerRetour arrière jusqu'à la colonne zéroÉlimine totalement les espaces insécables cachés ou les octets discordants.
3. RéindenterAppuyer sur Tab une fois par niveauPermet à la règle de conversion de l'éditeur d'insérer des espaces ASCII propres.

Pour les établissements scolaires qui déploient la programmation et l'informatique physique, des ressources pédagogiques structurées et des environnements de développement en ligne validés — comme les processus que nous mettons en œuvre via Sheen Infinity for schools — permettent de contourner totalement ces divergences au niveau de l'éditeur en automatisant les bonnes pratiques d'indentation dès le premier jour.

Si un script refuse de s'exécuter alors qu'il semble visuellement aligné, fiez-vous au message d'erreur de Python plutôt qu'à vos yeux : supprimez l'indentation jusqu'à la marge de gauche et réindentez uniquement à l'aide d'espaces correctement configurés.

#python#débogage#enseignement de l'informatique#thonny#programmation à l'école

Plus de Perspectives