Erreurs
Dépannage
Les erreurs font partie de la programmation ; elles ne signifient pas que « vous n'y arrivez pas ». Les développeurs expérimentés voient des messages d'erreur tous les jours ; la seule différence, c'est qu'ils savent où regarder. Le plus souvent, la cause est simple : une faute de frappe, le mauvais dossier, une autre version du langage, une modification non enregistrée. Cette rubrique répond aux situations typiques du débutant et indique dans quel ordre chercher la cause.
Un message d'erreur n'est pas une condamnation : c'est un mot laissé par le programme pour dire où il n'a pas compris.
Comment fonctionne cette rubrique : nous décrivons les premières vérifications de manière générale, sans référence à un éditeur ou à un système d'exploitation précis. Cherchez les commandes exactes et le nom des réglages dans la documentation officielle de votre langage et de vos outils.
Si ça ne marche pas
Le terminal indique que la commande est introuvable
Le plus probable : le logiciel n'est pas installé, ou le terminal ne sait pas où il se trouve. Vérifiez que l'installation s'est terminée, redémarrez le terminal et regardez si le chemin du programme figure dans les paramètres système. Parfois, la commande porte un nom légèrement différent de celui que vous attendez : vérifiez dans la documentation.
Le programme signale une erreur de syntaxe
L'interpréteur n'a pas réussi à analyser le texte du programme. Regardez la ligne qu'il indique ainsi que la précédente : souvent, il s'agit d'une parenthèse ou d'un guillemet non fermé, d'un signe de ponctuation oublié, d'une indentation en trop ou manquante.
Le programme se lance mais n'affiche rien
Vérifiez que la partie du code concernée est bien appelée et que le fichier est enregistré avant l'exécution. Ajoutez un affichage temporaire à plusieurs endroits pour voir jusqu'où va l'exécution, puis retirez-le.
Ça marche chez les autres, pas chez moi
Comparez les versions du langage et des bibliothèques installées, le système d'exploitation et le dossier depuis lequel vous lancez le programme. Souvent, la cause est un fichier de configuration ou une dépendance qui vous manque. Une liste des dépendances avec leurs numéros de version, dans le projet lui-même, est d'une grande aide.
Conflit de fusion dans le dépôt
Un conflit signifie que les mêmes lignes ont été modifiées à deux endroits et que le système ne sait pas quelle version garder. Ouvrez le fichier, repérez les zones marquées, choisissez la bonne version ou combinez les deux, supprimez les marqueurs et faites un commit du résultat.
Mes modifications ont disparu
Pas de panique, et ne supprimez rien pour l'instant. Si les modifications ont fait l'objet d'un commit, vous les retrouverez dans l'historique du dépôt. Sinon, vérifiez que vous n'avez pas ouvert un autre fichier ou une autre branche, et consultez l'historique des modifications de l'éditeur. À l'avenir, faites des commits plus souvent.
Comment trouver la cause d'une erreur
Lisez le message en entier
Ne fermez pas tout de suite la fenêtre d'erreur. Repérez le type d'erreur, le fichier et le numéro de ligne, et notez la phrase clé.
Reproduisez l'erreur
Assurez-vous que l'erreur se répète à chaque exécution et notez les actions qui y mènent.
Si le problème ne survient qu'avec une saisie particulière, conservez cette saisie : elle deviendra votre premier test.
Repensez à la dernière modification
Ce qui casse, c'est le plus souvent ce qu'on a touché en dernier. Comparez la version actuelle du fichier avec celle enregistrée dans le dépôt.
Réduisez l'exemple
Retirez des parties du code une à une jusqu'à ce que l'erreur disparaisse. Le dernier fragment retiré est le principal suspect.
Recherchez le texte de l'erreur
Cherchez le message sans vos propres noms de fichiers et de variables : quelqu'un a très probablement déjà rencontré les erreurs courantes. Consultez aussi la documentation officielle.
Demandez et notez la réponse
Si rien n'y fait, posez la question à la communauté selon le modèle de la rubrique Guides. Une fois la cause trouvée, consignez-la dans votre carnet d'erreurs.
Rubriques associées
- Guides
Des guides pas à pas : environnement, premier script, premier dépôt, messages d'erreur, questions à la communauté. Avec le catalogue des articles.
- Outils
La trousse du débutant, sans marques : éditeur de code, terminal, interpréteur ou compilateur, gestion de versions, hébergement de dépôts, gestionnaire de paquets.
- Questions
Réponses sur le guide, sur l'apprentissage de zéro et sur les premiers projets concrets.
Sources
- Documentation Git
- Documentation Python
Les dates et les définitions proviennent de la documentation officielle et des spécifications à la date de rédaction. Les langages et les outils évoluent : vérifiez les détails dans les sources de référence à jour.