> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/fr/base-de-connaissances/149-using-the-stop-on-first-error-compilation-mode.md).

# Utiliser le mode de compilation Arrêter à la première erreur

Cet article explique comment utiliser le **Arrêter à la première erreur** mode de compilation d’Overleaf, ainsi qu’un examen de quelques sujets de contexte importants, notamment :

* Qu’est-ce qu’un [mode de compilation LaTeX](#introduction-to-latex-errors-and-compilation)?
* [Modes de compilation sur Overleaf](#compilation-modes-on-overleaf)
* Comment **Arrêter à la première erreur** peut être [utile pour le débogage](#benefits-of-using-the-stop-on-first-error-mode)

Pour passer les informations de contexte, vous pouvez aller directement à la section expliquant [comment activer le mode de compilation Arrêter à la première erreur](#the-stop-on-first-error-compilation-mode).

## Introduction aux erreurs LaTeX et à la compilation

La conversion d’un document LaTeX en un fichier PDF mis en page est le résultat d’un processus appelé *compilation*: un programme exécutable, appelé « compilateur LaTeX », lit le contenu de votre document et exécute ses commandes LaTeX constitutives pour générer le fichier PDF mis en page.

Lorsque vous écrivez du balisage LaTeX (code), il est tout à fait naturel de faire des erreurs qui, pendant la compilation, amènent le compilateur à afficher des messages d’erreur qui tentent d’expliquer ce que le compilateur *pense* a causé le(s) problème(s). Comme pour d’autres langages de programmation, une seule erreur dans le code LaTeX de votre document peut déclencher une cascade d’erreurs, chacune avec son message correspondant. Sur Overleaf, les messages d’erreur de compilation sont signalés à l’utilisateur via [une notification rouge à côté du **Recompiler** bouton](#overleafs-latex-error-reporting), et vous pouvez cliquer sur l’ **volet Journaux et fichiers de sortie** icône pour les afficher.

### Gestion des erreurs : modes de compilation

Les compilateurs LaTeX, aussi appelés [moteurs TeX](/latex/fr/articles-approfondis/55-what-s-in-a-name-a-guide-to-the-many-flavours-of-tex.md), disposent de *modes de compilation* intégrés (sélectionnables par l’utilisateur) qui déterminent comment les erreurs sont gérées. La liste à puces suivante utilise le *propre nom explicatif/descriptif* pour chacun de ces modes :

* **Essayer de compiler malgré les erreurs**— en substance, continuer à essayer de compiler malgré la rencontre d’erreurs, en espérant que tout se passe bien, en produisant éventuellement un fichier PDF, mais qui peut contenir des erreurs de mise en page.
* **Arrêter à la première erreur**— en pratique, « abandonner » au premier signe de difficulté, afficher un message à l’utilisateur et quitter sans créer de PDF. Cela évite de déclencher une cascade ultérieure d’erreurs, vous permettant de vous concentrer sur la correction de la toute première erreur et de recompiler le document.
* **Suspendre la compilation pour interagir avec l’utilisateur**— mettre la compilation en pause pour offrir de l’aide et fournir des mécanismes permettant aux utilisateurs de corriger les erreurs et de poursuivre la compilation. Cela est possible avec une installation LaTeX locale mais peu pratique sur Overleaf.

## Modes de compilation sur Overleaf

Pour gérer le processus de compilation LaTeX, Overleaf utilise un [outil de compilation appelé latexmk](/latex/fr/base-de-connaissances/064-how-does-overleaf-compile-my-project.md) qui, par défaut, utilise un mode de compilation qu’Overleaf appelle **Essayer de compiler malgré les erreurs :** l’outil de compilation essaiera de produire un PDF mis en page, même s’il y a [des erreurs de compilation LaTeX](/latex/fr/bases-de-latex/05-errors.md).

Dans le **Essayer de compiler malgré les erreurs** dans ce mode de compilation, le compilateur LaTeX ne s’arrête pas si des erreurs sont détectées ; au lieu de cela, il essaie de « deviner au mieux » l’intention de l’utilisateur et applique des « corrections » fondées sur cette supposition — le code problématique peut aussi être « ignoré ». Le compilateur *pourrait* revenir à un état où le processus de compilation peut finalement s’achever pour créer un PDF, bien que le PDF produit puisse contenir une sortie incorrecte. Souvent, les erreurs rencontrées peuvent être trop graves, ou trop nombreuses, pour que le compilateur LaTeX les corrige, de sorte qu’il peut quand même « abandonner » sans produire de PDF.

### Le signalement des erreurs LaTeX par Overleaf

Comme indiqué ci-dessus, les messages d’erreur générés pendant la compilation sont signalés à l’utilisateur via une notification rouge à côté du **Recompiler** bouton :

![Capture d’écran montrant les erreurs LaTeX signalées sur Overleaf](/files/4dc8f1fc04399c7e61d44014825b1d3110763d76)

Vous pouvez cliquer sur l’ **volet Journaux et fichiers de sortie** icône pour voir plus de détails sur l’erreur ou les erreurs. Par exemple, si vous aviez tapé par erreur `\texbf{word}` au lieu de `\textbf{word}`, Overleaf afficherait quand même un aperçu PDF compilé ainsi que le message d’erreur concernant la commande non définie, mais « word » ne serait pas en gras dans le PDF !

## Le mode de compilation Arrêter à la première erreur

Les utilisateurs peuvent désormais modifier le mode de compilation LaTeX en passant au **Arrêter à la première erreur** mode qui amène Overleaf à arrêter immédiatement la compilation dès la détection de la première erreur.

### Comment activer Arrêter à la première erreur

Sélectionnez le petit triangle à côté du **Recompiler** bouton puis choisissez **Arrêter à la première erreur** de **Recompiler** menu déroulant :

![Capture d’écran montrant comment activer le mode de compilation Arrêter à la première erreur](/files/f9be456fa7099d783aeeb5c78c751762539febef)

#### Portée de ce réglage de mode

Le **Arrêter à la première erreur** le mode est un réglage par utilisateur, par projet. L’activation de ce mode ne *pas* affectera pas vos autres projets, ni aucun collaborateur dans le même projet.

### Désactiver Arrêter à la première erreur

Lorsque **Arrêter à la première erreur** est activé, vous pouvez revenir au mode de compilation par défaut en sélectionnant le bouton bleu **Désactiver « Arrêter à la première erreur »** situé dans la boîte de dialogue qui apparaît lorsqu’il y a une erreur de compilation :

![Capture d’écran montrant un message d’échec de compilation](/files/7d90d68a62473b01678fbcad0e2a0873ebf80f60)

Vous pouvez également aller au **Recompiler** menu déroulant, et sélectionner le **Essayer de compiler malgré les erreurs** mode :

![Capture d’écran montrant comment désactiver le mode de compilation Arrêter à la première erreur](/files/c83217a01fe27f419074462f0b04c15a611e033b)

### Notes et conseils supplémentaires

Si votre projet ne contient aucune erreur de compilation LaTeX, un aperçu PDF sera affiché comme d’habitude. Si votre projet *ne* contient des erreurs de compilation LaTeX, la compilation s’arrêtera immédiatement à la première erreur. Le premier message d’erreur est affiché comme indiqué dans la capture d’écran ci-dessous, afin que vous puissiez vous concentrer sur le débogage de l’erreur dans votre code source. Dans cette capture d’écran, l’erreur est due à une utilisation incorrecte de `\caption{...}\label{...}` dans un environnement tabular. La ligne 15 devrait être déplacée avant `\begin{tabular}`.

![Capture d’écran montrant une erreur LaTeX typique](/files/f13ead91f125252ef0e2e39b99fa2830f312b4eb)

Cliquez sur **Recompiler** après avoir corrigé chaque erreur, puis répétez ce processus de débogage pour chaque erreur de compilation suivante. Lorsque votre projet ne contient plus d’erreurs LaTeX, le **Arrêter à la première erreur** mode affichera le PDF compilé avec succès.

### Avantages d’utiliser le mode Arrêter à la première erreur

* **Aide à déboguer les délais d’expiration de compilation.** Certains types d’erreurs de compilation sont si graves (par exemple, une récursion accidentelle) qu’ils peuvent bloquer le **mode Essayer de compiler malgré les erreurs** de compilation, entraînant un [délai d’expiration de compilation](/latex/fr/base-de-connaissances/038-fixing-and-preventing-compile-timeouts.md#fatal-compile-errors-blocking-the-compilation) dans un projet Overleaf. L’activation du **Arrêter à la première erreur** mode peut aider à localiser et à déboguer de telles erreurs.
* **Ne laissez pas vos erreurs s’accumuler.** Certains utilisateurs peuvent préférer le comportement d’autres éditeurs LaTeX dans lesquels le processus de compilation s’arrête à la première erreur LaTeX rencontrée afin qu’ils puissent corriger l’erreur avant de recompiler. Empêcher les erreurs de se propager — déclenchant une avalanche d’autres erreurs — évite d’avoir à déboguer plus de 100 messages d’erreur de compilation, ce qui peut devenir difficile et quelque peu fastidieux.
* **L’activation du mode Arrêter à la première erreur peut détecter rapidement vos erreurs (s’il y en a).** Si vous avez un document volumineux ou complexe qui prend plus de temps à compiler, le **Essayer de compiler malgré les erreurs** mode vous oblige à attendre la fin de la compilation. S’il y a des erreurs que vous devez corriger, il peut être long d’attendre avant de pouvoir voir la première erreur de compilation et tenter de la corriger.
* **Apprendre à déboguer les erreurs est une partie essentielle de l’apprentissage de LaTeX.** Le **Arrêter à la première erreur** le mode peut aider les débutants LaTeX à apprendre et à adopter tôt de bonnes habitudes de codage LaTeX, accélérant peut-être leur parcours vers la maîtrise de LaTeX. Les erreurs LaTeX peuvent sembler si bizarres et ésotériques qu’il est très tentant de les ignorer et de laisser le compilateur continuer — en espérant qu’un PDF finira par apparaître, même si ce PDF contient des erreurs de mise en page. À long terme, ignorer les erreurs de compilation peut conduire à de mauvaises habitudes de codage qui pourraient, à terme, vous jouer des tours dans le futur, peut-être lors de la soumission d’un article important à une revue ! Si vous enseignez un cours sur LaTeX, vos étudiants peuvent utiliser le **Arrêter à la première erreur** mode pour développer leurs compétences en débogage des erreurs LaTeX.

## Des erreurs qui ne semblent pas provenir de vos fichiers

Si vous interrompez manuellement la compilation dans le **Essayer de compiler malgré les erreurs** mode, puis activez **Arrêter à la première erreur**, la compilation suivante peut produire des messages d’erreur apparemment aléatoires, tels que `! Fin de fichier atteinte lors de l’analyse de l’utilisation de \@writefile`, qui ne semblent pas provenir de vos fichiers. De telles erreurs peuvent être dues à des fichiers tronqués générés par, et restés de, la précédente compilation incomplète. Dans ce cas, vous voudrez peut-être faire un [Recompiler à partir de zéro](/latex/fr/base-de-connaissances/028-clearing-the-cache.md) afin que la compilation suivante, toujours en **Arrêter à la première erreur** mode, ait une chance de repartir de zéro et d’afficher la première erreur pertinente. Si vous obtenez toujours des erreurs provenant d’un fichier apparemment inexistant — par exemple, `output.aux`, `output.toc` etc. — consultez [cette page d’aide](/latex/fr/base-de-connaissances/066-how-to-find-and-fix-errors-reported-in-generated-files.md).

## Quelques détails plus techniques

Le **Essayer de compiler malgré les erreurs** mode de compilation s’exécute `latexmk` avec les indicateurs suivants :

```latex
latexmk -f -interaction=nonstopmode …
```

Le **Arrêter à la première erreur** le mode de compilation exécutera latexmk avec les indicateurs suivants à la place :

```latex
latexmk -halt-on-error -interaction=nonstopmode …
```

Puisque vous êtes ici, vous pourriez aussi être intéressé par la lecture de plus d’informations sur [la façon dont Overleaf utilise `latexmk` l’outil](/latex/fr/base-de-connaissances/064-how-does-overleaf-compile-my-project.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://overleaf-pro.ayaka.space/latex/fr/base-de-connaissances/149-using-the-stop-on-first-error-compilation-mode.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.