> 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/de/wissensdatenbank/149-using-the-stop-on-first-error-compilation-mode.md). # Den Kompiliermodus „Bei erstem Fehler stoppen“ verwenden Dieser Artikel erklärt, wie man Overleafs **Stopp beim ersten Fehler** Kompilierungsmodus verwendet, zusammen mit einem Blick auf einige wichtige Hintergrundthemen, darunter: * Was ist ein [LaTeX-Kompilierungsmodus](#introduction-to-latex-errors-and-compilation)? * [Kompilierungsmodi in Overleaf](#compilation-modes-on-overleaf) * Wie **Stopp beim ersten Fehler** kann [nützlich für das Debugging](#benefits-of-using-the-stop-on-first-error-mode) Um die Hintergrundinformationen zu überspringen, kannst du direkt zum Abschnitt springen, der erklärt, [wie man den Kompilierungsmodus „Bei erstem Fehler stoppen“ aktiviert](#the-stop-on-first-error-compilation-mode). ## Einführung in LaTeX-Fehler und das Kompilieren Die Umwandlung eines LaTeX-Dokuments in eine gesetzte PDF-Datei ist das Ergebnis eines Prozesses namens *Kompilierung*: ein ausführbares Programm, bekannt als ein „LaTeX-Compiler“, liest den Inhalt deines Dokuments und führt die darin enthaltenen LaTeX-Befehle aus, um die gesetzte PDF-Datei zu erzeugen. Beim Schreiben von LaTeX-Markup (Code) ist es ganz natürlich, Fehler zu machen, die während des Kompilierens dazu führen, dass der Compiler Fehlermeldungen ausgibt, die zu erklären versuchen, was der Compiler *denkt* die Probleme verursacht hat. Wie bei anderen Programmiersprachen kann ein einzelner Fehler im LaTeX-Code deines Dokuments eine Kaskade von Fehlern auslösen, jeder mit seiner entsprechenden Meldung. In Overleaf werden Kompilierungsfehlermeldungen dem Benutzer über [eine rote Benachrichtigung neben dem **Neu kompilieren** Schaltfläche](#overleafs-latex-error-reporting), und du kannst auf das **Protokolle und Ausgabedateien** Symbol klicken, um sie anzuzeigen. ### Fehlerbehandlung: Kompilierungsmodi LaTeX-Compiler, auch bekannt als [TeX-Engines](/latex/de/ausfuhrliche-artikel/55-what-s-in-a-name-a-guide-to-the-many-flavours-of-tex.md), haben eingebaute (vom Benutzer auswählbare) *Kompilierungsmodi* die festlegen, wie Fehler behandelt werden. Die folgende Aufzählung verwendet Overleafs *eigenen erklärenden/beschreibenden Namen* für jeden dieser Modi: * **Trotz Fehlern versuchen zu kompilieren**—im Wesentlichen immer weiter versuchen zu kompilieren, trotz auftretender Fehler, in der Hoffnung auf das Beste, wobei möglicherweise eine PDF-Datei erzeugt wird, die jedoch Satzfehler enthalten kann. * **Stopp beim ersten Fehler**—im Grunde beim ersten Anzeichen von Problemen „den Rückzug antreten“, dem Benutzer eine Meldung anzeigen und ohne Erzeugung einer PDF beenden. Dadurch wird verhindert, dass eine nachfolgende Kaskade von Fehlern ausgelöst wird, sodass du dich auf die Behebung des allerersten Fehlers und das erneute Kompilieren des Dokuments konzentrieren kannst. * **Kompilierung unterbrechen, um mit dem Benutzer zu interagieren**—das Kompilieren pausieren, um Hilfe anzubieten und Mechanismen bereitzustellen, mit denen Benutzer Fehler beheben und das Kompilieren fortsetzen können. Das ist mit einer lokalen LaTeX-Installation möglich, aber auf Overleaf unpraktisch. ## Kompilierungsmodi in Overleaf Um den LaTeX-Kompilierungsprozess zu verwalten, verwendet Overleaf [ein Build-Tool namens latexmk](/latex/de/wissensdatenbank/064-how-does-overleaf-compile-my-project.md) das standardmäßig einen Kompilierungsmodus verwendet, den Overleaf als **Trotz Fehlern versuchen zu kompilieren:** das Build-Tool wird versuchen, ein gesetztes PDF zu erzeugen, selbst wenn es [LaTeX-Kompilierfehler](/latex/de/latex-grundlagen/05-errors.md). In dem **Trotz Fehlern versuchen zu kompilieren** Kompilierungsmodus stoppt der LaTeX-Compiler nicht, wenn Fehler erkannt werden; stattdessen versucht er, die Absicht des Benutzers „bestmöglich zu erraten“ und wendet auf dieser Grundlage „Korrekturen“ an — problematischer Code kann auch „übersprungen“ werden. Der Compiler *kann* in einen Zustand zurückkehren, in dem der Kompilierungsprozess schließlich abgeschlossen werden kann, um eine PDF zu erzeugen, obwohl die erzeugte PDF möglicherweise fehlerhafte Ausgabe enthält. Oft sind die aufgetretenen Fehler zu schwerwiegend oder zu zahlreich, als dass der LaTeX-Compiler sie beheben könnte, sodass er möglicherweise dennoch ohne Erzeugung einer PDF „den Rückzug antritt“. ### Overleafs Berichterstattung über LaTeX-Fehler Wie oben erwähnt, werden während des Kompilierens erzeugte Fehlermeldungen dem Benutzer über eine rote Benachrichtigung neben dem **Neu kompilieren** Button angezeigt: ![Screenshot, der auf Overleaf gemeldete LaTeX-Fehler zeigt](/files/7a69285ca54e097777c5918568fcd3454a8aed35) Du kannst auf das **Protokolle und Ausgabedateien** Symbol klicken, um weitere Details zu den Fehlern anzuzeigen. Wenn du zum Beispiel versehentlich `\\texbf{word}` anstelle von `\\textbf{word}`würde Overleaf weiterhin eine kompilierte PDF-Vorschau zusammen mit der Fehlermeldung über den unbekannten Befehl anzeigen, aber „word“ wäre in der PDF nicht fett gedruckt! ## Der Kompilierungsmodus „Bei erstem Fehler stoppen“ Benutzer können den LaTeX-Kompilierungsmodus jetzt ändern, indem sie zum **Stopp beim ersten Fehler** Modus wechseln, der dazu führt, dass Overleaf das Kompilieren sofort beim ersten erkannten Fehler beendet. ### So aktivierst du „Bei erstem Fehler stoppen“ Wähle das kleine Dreieck neben dem **Neu kompilieren** Button und wähle dann **Stopp beim ersten Fehler** aus dem **Neu kompilieren** Dropdown-Menü ein: ![Screenshot, der zeigt, wie der Kompiliermodus „Stopp beim ersten Fehler“ aktiviert wird](/files/32d19736208816d6be8db065a89ef8ba5b687576) #### Geltungsbereich dieser Moduseinstellung Die **Stopp beim ersten Fehler** Modus ist eine Einstellung pro Benutzer und pro Projekt. Das Aktivieren dieses Modus wird *nicht* deine anderen Projekte oder Mitbearbeiter im selben Projekt nicht beeinflussen. ### Deaktivieren von „Bei erstem Fehler stoppen“ Wenn **Stopp beim ersten Fehler** aktiviert ist, kannst du zum Standard-Kompilierungsmodus zurückkehren, indem du den blauen Button auswählst **„Bei erstem Fehler stoppen“ deaktivieren** der im Dialogfeld erscheint, wenn ein Kompilierungsfehler auftritt: ![Screenshot, der eine Meldung über einen fehlgeschlagenen Kompilierungsversuch zeigt](/files/17762f481d87453bc6b3f113eee0b921873c0032) Du kannst auch zum **Neu kompilieren** Dropdown-Menü gehen und den **Trotz Fehlern versuchen zu kompilieren** Modus auswählen: ![Screenshot, der zeigt, wie man den Kompilierungsmodus „Bei erstem Fehler stoppen“ deaktiviert](/files/91da93b51775bfcb139b16e567fb5b80f62bacab) ### Zusätzliche Hinweise und Ratschläge Wenn dein Projekt frei von LaTeX-Kompilierfehlern ist, wird wie gewohnt eine PDF-Vorschau angezeigt. Wenn dein Projekt *nicht* LaTeX-Kompilierfehler enthält, wird das Kompilieren sofort beim ersten Fehler gestoppt. Die erste Fehlermeldung wird wie im Screenshot unten gezeigt angezeigt, damit du dich darauf konzentrieren kannst, den Fehler in deinem Quellcode zu debuggen. In diesem Screenshot liegt der Fehler an der falschen Verwendung von `\\caption{...}\\label{...}` innerhalb einer tabellarischen Umgebung. Zeile 15 sollte vor `\\begin{tabular}`. ![Screenshot, der einen typischen LaTeX-Fehler zeigt](/files/1590382e6f2acaa371e031161764216cc11a2e34) Klicken Sie auf **Neu kompilieren** erscheint, nachdem du jeden Fehler behoben hast, und wiederhole dann diesen Debugging-Prozess für jeden weiteren Kompilierungsfehler. Wenn dein Projekt frei von LaTeX-Fehlern ist, zeigt der **Stopp beim ersten Fehler** Modus die erfolgreich kompilierte PDF an. ### Vorteile der Verwendung des Modus „Bei erstem Fehler stoppen“ * **Hilft beim Debuggen von Zeitüberschreitungen beim Kompilieren.** Einige Arten von Kompilierungsfehlern sind so schwerwiegend (z. B. unbeabsichtigte Rekursion), dass sie den **Trotz Fehlern kompilieren** Kompilierungsmodus blockieren können, was zu einer [Kompilier-Timeout](/latex/de/wissensdatenbank/038-fixing-and-preventing-compile-timeouts.md#fatal-compile-errors-blocking-the-compilation) in einem Overleaf-Projekt führt. Das Aktivieren des **Stopp beim ersten Fehler** Modus kann helfen, solche Fehler zu finden und zu debuggen. * **Lass deine Fehler nicht auf sich stapeln.** Manche Benutzer bevorzugen möglicherweise das Verhalten anderer LaTeX-Editoren, bei denen der Kompilierungsprozess beim ersten auftretenden LaTeX-Fehler stoppt, damit sie den Fehler vor dem erneuten Kompilieren beheben können. Die Vermeidung, dass Fehler sich fortpflanzen — also eine Lawine weiterer Fehler auslösen — erspart das Debuggen von mehr als 100 Kompilierungsfehlermeldungen, was schwierig und etwas mühsam werden kann. * **Das Aktivieren des Modus „Bei erstem Fehler stoppen“ kann deine Fehler (falls vorhanden) schnell erkennen.** Wenn du ein großes oder komplexes Dokument hast, dessen Kompilierung länger dauert, erfordert der **Trotz Fehlern versuchen zu kompilieren** Modus, dass du wartest, bis das Kompilieren abgeschlossen ist. Wenn Fehler vorhanden sind, die du beheben musst, kann es zeitaufwendig sein, warten zu müssen, bevor du den ersten Kompilierungsfehler sehen und versuchen kannst, ihn zu beheben. * **Zu lernen, Fehler zu debuggen, ist ein wesentlicher Teil des LaTeX-Lernens.** Die **Stopp beim ersten Fehler** Modus kann LaTeX-Anfängern helfen, früh gute LaTeX-Codierungsgewohnheiten zu erlernen und anzunehmen, was vielleicht ihren Weg zur LaTeX-Kompetenz beschleunigt. LaTeX-Fehler können so bizarr und esoterisch erscheinen, dass es sehr verlockend ist, sie zu ignorieren und den Compiler weitermachen zu lassen — in der Hoffnung, dass irgendwann eine PDF erscheint, auch wenn diese PDF Satzfehler enthält. Langfristig kann das Ignorieren von Kompilierungsfehlern zu schlechten Codierungsgewohnheiten führen, die dich schließlich in Zukunft einholen könnten, vielleicht bei der Einreichung eines wichtigen Fachartikels! Wenn du einen Kurs über LaTeX unterrichtest, können deine Studierenden den **Stopp beim ersten Fehler** Modus nutzen, um Fähigkeiten im Debuggen von LaTeX-Fehlern zu entwickeln. ## Fehler, die scheinbar nicht in deinen Dateien entstehen Wenn du das Kompilieren im **Trotz Fehlern versuchen zu kompilieren** Modus manuell stoppst und dann **Stopp beim ersten Fehler**aktivierst, kann die nächste Kompilierung zu einigen scheinbar zufälligen Fehlermeldungen führen, wie etwa `! File ended while scanning use of \\@writefile`, die scheinbar nicht aus deinen Dateien stammen. Solche Fehler können auf abgeschnittene Dateien zurückzuführen sein, die von der vorherigen unvollständigen Kompilierung erzeugt wurden und übrig geblieben sind. In diesem Fall solltest du möglicherweise ein [Neu kompilieren von Grund auf](/latex/de/wissensdatenbank/028-clearing-the-cache.md) durchführen, damit die nächste Kompilierung, immer noch im **Stopp beim ersten Fehler** Modus, die Chance hat, mit einem sauberen Zustand zu beginnen und den ersten relevanten Fehler anzuzeigen. Wenn du immer noch Fehler von einer scheinbar nicht existierenden Datei erhältst — z. B. `output.aux`, `output.toc` usw. — wirf einen Blick auf [diese Hilfeseite](/latex/de/wissensdatenbank/066-how-to-find-and-fix-errors-reported-in-generated-files.md). ## Einige Details auf niedrigerer Ebene Die **Trotz Fehlern versuchen zu kompilieren** Kompilierungsmodus läuft `latexmk` mit den folgenden Flags: ```latex latexmk -f -interaction=nonstopmode … ``` Die **Stopp beim ersten Fehler** Kompilierungsmodus wird latexmk stattdessen mit den folgenden Flags ausführen: ```latex latexmk -halt-on-error -interaction=nonstopmode … ``` Während du hier bist, könnte es dich auch interessieren, mehr zu lesen über [wie Overleaf das `latexmk` Tool verwendet](/latex/de/wissensdatenbank/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/de/wissensdatenbank/149-using-the-stop-on-first-error-compilation-mode.md?ask=&goal= ``` `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.