> 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/questions-et-reponses/81-tips-and-tricks-for-troubleshooting-latex.md).

# Astuces et conseils pour dépanner LaTeX

Il existe quelques astuces et conseils que vous pouvez utiliser pour aider à identifier et résoudre les problèmes LaTeX. Nous vous recommandons généralement de déboguer avec le [mode de compilation « Arrêt à la première erreur » activé](/latex/fr/base-de-connaissances/149-using-the-stop-on-first-error-compilation-mode.md), car cela vous permettra d’éviter l’accumulation d’erreurs. Une fois que vous avez rencontré une erreur, vous pouvez suivre ces étapes pour la résoudre :

1. **Y a-t-il une erreur ou un avertissement ?**

   Commencez par regarder l’icône « Journaux et fichiers de sortie », juste à droite du bouton Recompiler.

   ![Un indicateur d’avertissement dans l’icône « Journaux et fichiers de sortie »](/files/01689b07d0c85fb24b56c839f2482954634dda85)

   Les messages d’avertissement s’affichent en orange. Il s’agit souvent simplement d’alertes indiquant que LaTeX a trouvé quelque chose d’inhabituel et a effectué des ajustements automatiques. S’ils n’ont pas d’impact sur l’apparence finale de votre document, on peut généralement les ignorer.

   Par exemple, de nombreux problèmes de flottants et de marges/d’espacement sont corrigés par LaTeX sans qu’une correction de l’utilisateur soit nécessaire. Overleaf signale une catégorie particulière d’avertissements, [les avertissements de boîtes sous-remplies et sur-remplies](/latex/fr/base-de-connaissances/138-understanding-underfull-and-overfull-box-warnings.md#overfull-or-underfull-boxes-are-not-errors), en bleu — la plupart peuvent être ignorés sans risque, même s’ils mettent parfois en évidence une partie de votre document qui doit être vérifiée.

   ![Un indicateur d’erreur dans l’icône « Journaux et fichiers de sortie ».](/files/236b523e35d599d6eea4e521e728937d59652bd4)

   Les messages d’erreur s’affichent en rouge. Ils sont généralement plus problématiques et peuvent empêcher la compilation correcte du document. Les erreurs fatales peuvent empêcher la compilation du document entièrement.

   Il existe une liste d’erreurs courantes et de la manière de les résoudre [ici](/latex/fr/bases-de-latex/05-errors.md). Nous recommandons de corriger les erreurs dès que possible, car leur accumulation peut entraîner à l’avenir des erreurs difficiles à déboguer et fatales.
2. **Le message indique-t-il une erreur spécifique ou un numéro de ligne ?**

   ![Un message d’erreur avec un numéro de ligne inclus.](/files/d06538d2700f013e4594dab1a0b5b8dce758c9a2)

   Dans de nombreux cas, le moteur LaTeX est suffisamment intelligent pour déterminer l’erreur exacte et vous donner un numéro de ligne. Dans l’exemple ci-dessus, il y avait un symbole `_`, que LaTeX exige d’échapper comme ceci : `\_`. Le message d’erreur indique même que l’erreur se trouve à la ligne 29, met en évidence la ligne appropriée et montre un extrait du texte où se situe le problème. Vous pouvez cliquer sur le message d’erreur pour accéder directement au fichier et au numéro de ligne où l’erreur se produit dans le code source.

   Si aucun numéro de ligne n’est indiqué, continuez d’essayer certaines des étapes ci-dessous.
3. **Le texte de l’erreur fournit-il un indice ?**

   ![Un message d’erreur indiquant que le problème se trouve dans le fichier .bbl, ce qui suggère un problème avec la bibliographie.](/files/6dc700096859f9d718a195966b25ee9f25b79151)

   Dans le message d’erreur ci-dessus, un numéro de ligne est donné, mais pas pour un fichier que vous modifiez habituellement. Ici, l’extension de fichier, .bbl, donne un indice : l’erreur qui empêche la compilation est un problème BibTeX.

   La recherche du texte mis en évidence dans votre fichier .bib vous permettra de trouver l’origine de l’erreur. Parfois [la vérification des fichiers auxiliaires et des journaux](/latex/fr/base-de-connaissances/150-view-generated-files.md) peut révéler des informations plus précises que les boîtes de dialogue de message plus brèves.
4. **Comparer les versions précédentes et annuler les changements**

   Si votre projet compilait parfaitement auparavant, alors vous avez probablement introduit une erreur dans le projet lors de vos modifications récentes. Vous pouvez utiliser la [fonction Historique](/latex/fr/autres-sujets/49-using-the-history-feature.md) pour annuler les changements récents.
5. **Essayez de déplacer \end{document}**

   Si vous n’avez toujours pas localisé l’erreur, coupez la `\end{document}` depuis toute la fin de votre fichier .tex principal et essayez de le coller à différents endroits de votre projet. Commencez par le fichier .tex principal, puis, si nécessaire, par tous les sous-fichiers que vous appelez dans votre fichier principal avec `\input{}` ou `\include{}`. Déplacez-vous méthodiquement depuis toute la fin du projet/document vers le début du document, en répétant ce processus une section à la fois. Accordez une attention particulière aux équations ou à d’autres sections complexes sujettes à de petites erreurs.

   Cela devrait vous aider à réduire progressivement votre document jusqu’à un document de plus en plus petit, afin que vous puissiez isoler la section contenant l’erreur. Si le document se met soudainement à compiler, vous savez que vous avez localisé la section erronée. Dans de nombreux cas, le problème peut être aussi simple qu’une commande mal saisie, un caractère spécial non échappé ou une parenthèse manquante.
6. **S’agit-il d’une erreur de compilation de « temporisation » ?**

   Dans certains cas, les utilisateurs peuvent rencontrer des erreurs de compilation liées à un dépassement de temps dans certaines conditions. Cela est dû aux limites de ressources/de temps de compilation sur nos serveurs. Nous avons différents délais pour les comptes gratuits et les comptes payants. Il existe un certain nombre de conseils que nous proposons afin de [faire compiler votre document plus rapidement](/latex/fr/base-de-connaissances/038-fixing-and-preventing-compile-timeouts.md), et si cela ne fonctionne pas, n’hésitez pas à nous contacter avec une [demande d’assistance](https://www.overleaf.com/contact).
7. **S’agit-il d’une erreur de « rendu PDF » ?**

   Comme pour d’autres services en ligne, vous pouvez parfois rencontrer des problèmes lors de l’utilisation d’Overleaf. L’état du navigateur, les extensions du navigateur, de brèves interruptions de service des fournisseurs et des problèmes de configuration réseau peuvent potentiellement causer des problèmes.

   Si vous rencontrez des problèmes de connexion, ou si une partie de l’éditeur ou de la visionneuse PDF ne se charge pas ou ne s’affiche pas comme prévu, veuillez essayer les étapes de dépannage sur [cette page](/latex/fr/base-de-connaissances/125-resolving-access-loading-and-display-problems.md).
8. **Essayez les forums**

   Si aucun numéro de ligne n’est fourni et que vous ne parvenez pas à déchiffrer le message d’erreur donné, un rapide aller-retour « copier-coller » vers votre moteur de recherche préféré peut révéler des informations d’utilisateurs experts qui ont été confrontés à un problème similaire. Parmi les excellents forums liés à TeX, on peut citer [LaTeX Stack Exchange](https://tex.stackexchange.com/) et [LaTeX Community](https://latex.org/forum/).
9. **Contactez-nous**

   Enfin, mais surtout, vous pouvez toujours nous envoyer un [demande d’assistance](https://www.overleaf.com/contact). Quel que soit votre problème, qu’il soit spécifique à LaTeX ou au site, nous serons heureux de vous aider à tirer le meilleur parti de votre expérience Overleaf.


---

# 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/questions-et-reponses/81-tips-and-tricks-for-troubleshooting-latex.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.