D.1 Déboguer un programme Python et gérer les erreurs

1Situer

Un collègue vous envoie un programme de calcul de moyenne qui « ne marche pas ». Il plante quand on saisit une lettre, et donne parfois une moyenne fausse. Avant de tout réécrire, il faut comprendre ce que dit Python et trouver les erreurs une par une.

2Comprendre

Lire un message d'erreur de bas en haut

Le programme s'arrête et Python affiche un message d'erreur (traceback). Pas de panique : il dit où et pourquoi.

1 / 5

Déboguer, c’est trouver et corriger les erreurs d’un programme. Il en existe trois familles.

Famille	Quand	Exemple	Message
Syntaxe	avant l’exécution	deux-points oublié après `if`	`SyntaxError`
Exécution	pendant l’exécution	diviser par zéro, `"5" + 1`	`ZeroDivisionError`, `TypeError`
Logique	jamais signalée	`<` au lieu de `<=`	aucun : le résultat est faux

Lire un message d’erreur

Lisez le message de bas en haut : la dernière ligne donne le type d’erreur et sa cause, la ligne line N indique où le problème a été détecté.

Traceback (most recent call last):
  File "<exec>", line 4, in moyenne
TypeError: unsupported operand type(s) for +: 'int' and 'str'

Ici, à la ligne 4, on additionne un entier et un texte : une note n’a pas été convertie.

Exemple simple

Décoder une erreur ligne par ligne

On lit un message d’erreur en partant du bas : le type d’erreur, puis le numéro de ligne.

Traceback (most recent call last):
  File "facture.py", line 3, in <module>
    total = prix + 20
TypeError: can only concatenate str (not "int") to str

Ce qui se passe

Dernière ligne : TypeError, on mélange un texte (str) et un nombre (int).
Juste au-dessus : la ligne 3, total = prix + 20.
Conclusion : prix vient d’un input() et n’a pas été converti avec int().

Méthode de débogage

Reproduire l’erreur avec des valeurs connues.
Localiser : lire le message, ajouter des print() pour voir les valeurs intermédiaires.
Corriger une seule chose à la fois, puis réexécuter.
Tester les cas limites : liste vide, zéro, saisie invalide.

Exemple simple

Trouver pourquoi la moyenne est fausse avec des print

Le programme affiche une moyenne de 2.4 au lieu de 12. On ajoute des print pour voir les valeurs à chaque étape.

notes = [12, 10, 14]
somme = 0
for n in notes:
    somme = n           # erreur ici
    print("debug : n =", n, "somme =", somme)
print(somme / len(notes))

Ce qui se passe

Le print de débogage montre que somme vaut 12, puis 10, puis 14 : elle ne s’additionne pas.
On repère la ligne fautive : il fallait somme = somme + n.
Une fois corrigé, on supprime les print de débogage. Le lab Python montre ces valeurs sans rien ajouter.

Gérer les erreurs prévisibles

Certaines erreurs viennent de l’utilisateur. On les traite avec try / except au lieu de laisser le programme planter :

try:
    note = float(input("Note : "))
except ValueError:
    print("Veuillez saisir un nombre.")

Exemple simple

Redemander tant que la saisie n’est pas un nombre

On combine une boucle et try/except : le programme ne plante plus, il redemande.

while True:
    try:
        age = int(input("Votre âge : "))
        break               # saisie correcte : on sort de la boucle
    except ValueError:
        print("Merci de taper un nombre, par exemple 18.")
print("Âge enregistré :", age)

Ce qui se passe

Si on tape « dix-huit », int() lance une ValueError et on passe dans except.
Le message s’affiche et la boucle recommence.
Si on tape 18, break arrête la boucle.

Exemple simple

Le voyant du tableau de bord

Quand un voyant s'allume dans la voiture, il indique où regarder. Un message d'erreur Python fait la même chose : il donne le type d'erreur et le numéro de ligne. On le lit en partant du bas.

Exemple simple

Additionner du texte et un nombre

input renvoie du texte. « 5 » + 3 n'a pas de sens pour Python, d'où une TypeError. La correction : convertir avec int.

age = input("Âge : ")
print(age + 1)        # TypeError
print(int(age) + 1)   # correct

3Manipuler

Ce programme contient 2 erreurs. Exécutez-le avec les entrées 12, 15, 9 et lisez le message. Corrigez, réexécutez, jusqu'à obtenir la moyenne 12.0. Essayez ensuite avec l'entrée abc.

Pas à pas dans le lab ↗Python se charge au premier clic (environ 12 Mo, une seule fois).

Entrées pour input(), séparées par des virgules

Console

4Pratiquer

Exercice 1 · Les deux corrections

Donnez les deux corrections à apporter au programme de la simulation et le type de chaque erreur.

Voir un indice

La première erreur arrête le programme. La seconde ne fait rien planter mais donne un résultat faux.

Voir le corrigé

# Erreur d'exécution (TypeError) : input() renvoie du texte
notes.append(float(texte))

# Erreur de logique : le « - 1 » fausse le résultat
return total / len(notes)

Exercice 2 · Protéger la saisie

Modifiez la saisie pour que le programme redemande la note tant que l'utilisateur tape autre chose qu'un nombre.

Voir le corrigé

def lire_note():
    while True:
        texte = input("Note : ")
        try:
            return float(texte)
        except ValueError:
            print("Ce n'est pas un nombre, recommencez.")

Déboguer un programme Python et gérer les erreurs

1Situer

2Comprendre

Lire un message d’erreur

Méthode de débogage

Gérer les erreurs prévisibles

Le voyant du tableau de bord

Additionner du texte et un nombre

3Manipuler

4Pratiquer

Exercice 1 · Les deux corrections

Exercice 2 · Protéger la saisie

5Vérifier