Office de la formation professionnelle · ressources stagiaires● Cours · Exercices · Examens corrigés

M102 – Partie 6 : Déboguer et déployer une solution Python | Développement Digital​

novembre 19, 2026 · OF-PPT

Même un développeur expérimenté fait des erreurs : ce qui distingue un bon développeur, c’est sa capacité à les trouver rapidement et à les corriger. Cette dernière partie du module vous apprend à déboguer un script Python, puis à le documenter et le déployer correctement.

  • Distinguer les trois grands types d’erreurs en Python.
  • Lire un message d’erreur (traceback) pour localiser le problème.
  • Gérer les erreurs avec try / except.
  • Documenter un script avec des commentaires.
  • Préparer et déployer un script Python.

Les trois types d’erreurs

En programmation, une erreur n’est pas toujours de même nature. Savoir à quel type elle appartient aide à savoir où chercher la solution.

Type d’erreur Cause Exemple
Erreur de syntaxe Le code ne respecte pas les règles d’écriture du langage Oublier les deux-points après un if
Erreur d’exécution Le code est valide mais provoque un problème pendant son exécution Diviser par zéro, ouvrir un fichier qui n’existe pas
Erreur logique Le programme s’exécute sans planter, mais le résultat est faux Calculer une moyenne en oubliant de diviser par le bon nombre

Débogage : le processus qui consiste à trouver la cause d’une erreur ou d’un résultat incorrect, puis à la corriger.

Les erreurs de syntaxe sont détectées avant l’exécution : Python refuse de lancer le script. Les erreurs d’exécution et logiques, elles, n’apparaissent souvent qu’en testant le programme avec des données précises.

Lire un message d’erreur (traceback)

Quand une erreur d’exécution se produit, Python affiche un traceback : un message qui indique le type d’erreur, la ligne concernée, et l’enchaînement des appels qui ont mené à cette erreur.

Script :
notes = [12, 15, 9]
print(notes[5])

Message d’erreur obtenu :
Traceback (most recent call last):
  File "script.py", line 2, in <module>
    print(notes[5])
IndexError: list index out of range

Pour lire ce message efficacement, repérez toujours ces trois informations, en partant du bas :

  1. Le type d’erreurSur la dernière ligne : ici, IndexError (indice hors limites)
  2. Le message précisJuste après le type : ici, « list index out of range »
  3. La ligne concernéeIndiquée par line 2 : on sait directement où regarder
Type d’erreur Python Signification
SyntaxError Le code ne respecte pas la syntaxe Python
NameError Une variable utilisée n’a jamais été créée
TypeError Une opération est appliquée à un type incompatible (ex. additionner un texte et un nombre)
IndexError On accède à un indice qui n’existe pas dans une liste
ZeroDivisionError Une division par zéro a été tentée

Gérer les erreurs avec try / except

Certaines erreurs d’exécution sont prévisibles (une saisie incorrecte de l’utilisateur, un fichier absent). Plutôt que de laisser le programme s’arrêter brutalement, on peut les intercepter avec try / except, pour réagir proprement.

try:
    note = float(input("Entrez une note : "))
    print(10 / note)
except ValueError:
    print("Ce n’est pas un nombre valide.")
except ZeroDivisionError:
    print("La note ne peut pas être zéro.")

Si l’utilisateur tape du texte, Python intercepte l’erreur et affiche un message clair au lieu de faire planter le programme. S’il tape 0, l’autre bloc except gère la division par zéro.

Un bloc try peut aussi se terminer par finally, exécuté dans tous les cas (erreur ou non) — utile pour fermer un fichier ou libérer une ressource, par exemple.

Documenter son code

Un script sans aucune explication est difficile à relire, même pour son propre auteur quelques semaines plus tard. Python propose deux outils de documentation.

Outil Usage Exemple
Commentaire Une note rapide sur une ligne, ignorée à l’exécution # calcule la moyenne des notes
Docstring Une description du rôle d’une fonction, entre triples guillemets """Renvoie la moyenne de deux notes."""

def moyenne(note1, note2):
    """Renvoie la moyenne de deux notes."""
    # on additionne puis on divise par 2
    return (note1 + note2) / 2

Un bon commentaire explique pourquoi le code fait quelque chose, pas ce qu’il fait — le code lui-même montre déjà ce qu’il fait, si les noms de variables et de fonctions sont clairs.

Déployer un script Python

Déployer, c’est rendre un script utilisable en dehors de l’ordinateur sur lequel il a été écrit. Le programme officiel retient quelques bonnes pratiques simples pour un premier déploiement.

  1. Tester avant de livrerVérifier le script avec plusieurs cas, y compris des cas limites (valeur nulle, liste vide…)
  2. Lister les dépendancesNoter les bibliothèques utilisées qui ne sont pas incluses par défaut dans Python
  3. Préciser la version de PythonIndiquer la version utilisée, pour éviter des incompatibilités chez un autre utilisateur
  4. Documenter l’usageExpliquer comment lancer le script et ce qu’il attend comme données

Exemple de note de déploiement jointe à un script :
# Script : calcul_moyenne.py
# Version Python requise : 3.10 ou plus récente
# Dépendances : aucune (bibliothèques standards uniquement)
# Usage : python calcul_moyenne.py

  • On distingue trois types d’erreurs : de syntaxe, d’exécution et logique.
  • Le traceback indique le type d’erreur, le message précis et la ligne concernée.
  • try / except permet d’intercepter une erreur prévisible sans faire planter le programme.
  • Les commentaires et les docstrings documentent le pourquoi du code, pour soi-même et pour les autres.
  • Déployer un script, c’est le tester, lister ses dépendances, préciser sa version Python et documenter son usage.

Vérifiez vos acquis

Quelle différence entre une erreur d’exécution et une erreur logique ?

L’erreur d’exécution fait planter le programme ; l’erreur logique laisse le programme s’exécuter normalement mais produit un résultat faux.

À quoi sert un bloc try / except ?

À intercepter une erreur prévisible pendant l’exécution et à réagir proprement, au lieu de laisser le programme s’arrêter brutalement.

Que doit contenir une bonne documentation de déploiement ?

Au minimum : les dépendances utilisées, la version de Python requise, et les instructions pour lancer le script.

Exercices corrigés

Exercice 1 — Identifiez le type d’erreur : print(x) alors que x n’a jamais été créé.

NameError : la variable x n’existe pas.

Exercice 2 — Écrivez un bloc try / except qui intercepte une division par zéro et affiche « Division impossible ».

try:
    resultat = 10 / diviseur
except ZeroDivisionError:
    print("Division impossible")

Exercice 3 — Ce script ne plante pas mais affiche toujours 0 : def moyenne(a, b): return (a + b) / 3. Quel type d’erreur est-ce, et quelle est la correction ?

C’est une erreur logique : on divise par 3 au lieu de 2. Correction : return (a + b) / 2.

Exercice 4 — Ajoutez une docstring et un commentaire pertinents à : def est_pair(n): return n % 2 == 0.

def est_pair(n):
    """Renvoie True si n est un nombre pair."""
    # le reste de la division par 2 vaut 0 pour un nombre pair
    return n % 2 == 0

Vous savez maintenant modéliser un problème, construire un algorithme, le traduire en Python et déboguer votre code. Ce module vous servira de base dans tous les modules suivants, en particulier M103 (Programmer en orienté objet) et M105 (Programmer en JavaScript).

​

Commentaires

Formulaire de contact

Nom

E-mail *

Message *