Leçon 3 : Lecture d'erreurs et débogage

Une erreur est vite arrivée ! La différence entre un débutant et un expert ? La capacité à comprendre les messages d'erreurs. Bonne nouvelle : les messages d'erreur de Typst sont clairs et utiles. Apprenons à les lire.

📹 Vidéos

3 — Lire les messages d'erreur
  
Anatomie d'un message d'erreur. Les erreurs fréquentes et leurs solutions.

Objectifs

  • Lire et comprendre les messages d'erreur Typst
  • Identifier les erreurs les plus courantes
  • Appliquer une méthode de débogage efficace
  • Adopter les bonnes pratiques de codage
  • Résoudre les problèmes propres au travail en ligne sur typst.app

Erreurs fréquentes et solutions

Message Cause probable Solution
unclosed delimiter $, [ ou ( non fermé Ajouter le délimiteur manquant
unknown variable Faute de frappe Vérifier l'orthographe
#a + #b affiche "4 + 5" Expressions non groupées Utiliser #(a + b)
unexpected token Caractère ou syntaxe inattendue, souvent dans un import Vérifier la forme exacte de la ligne
cannot add Opération impossible entre deux valeurs Vérifier les types et grouper avec #(...) si besoin
unknown package Package ou version inexistante Vérifier la page Typst Universe

Cas typst.app à connaître

Problème À vérifier
Package not found Nom, version, ligne d'import copiée depuis Typst Universe
Import path broken Nombre de ../, nom exact des dossiers, fichier présent dans le projet
Missing bracket Crochets, parenthèses et accolades fermés dans le bon ordre
Math mode not closed Chaque $ est fermé
Function called in markup mode Ajouter # devant les appels de fonction hors math
PDF does not update Compiler le bon fichier dans submit/ et réexporter le PDF
Projet mal partagé Le formateur doit voir le dossier submit/
⚠️ Règle d'or : Corrigez TOUJOURS la première erreur d'abord, puis recompilez. Les erreurs suivantes disparaîtront peut-être !

Méthode de débogage

  1. Lire le message d'erreur en entier (jusqu'au "help")
  2. Localiser la ligne indiquée
  3. Identifier le type d'erreur
  4. Corriger une seule erreur à la fois
  5. Recompiler et vérifier

Pièges courants à éviter

Piège Correction
([{ groupement Mauvaise fermeture ou ouverture
farc(,) à la place de frac(,) commande inconnue
frac(4) manque un paramètre frac(4,5) commande incomplète
#a + #b au lieu de #(a + b) Grouper les expressions
Import sans : #import "@preview/pkg:0.1.0": fonction
cases sans virgules Virgule après chaque cas
Variables collées en math : xy Écrire x y pour le produit de x par y
Texte sans guillemets dans les maths "si" et non si
Vous en aurez souvent, mais la plupart seront faciles à corriger. Vous savez maintenant déboguer vos documents. Dans la leçon 4, vous allez apprendre à créer des graphiques et utiliser des packages pour enrichir vos cours.
Modifié le: jeudi 9 juillet 2026, 13:17