LaTeX-Kompilierung fehlgeschlagen? Fehler in drei Schritten finden und beheben
Prüfen Sie den aktuellen Kompilierstatus und anschließend den ersten tatsächlichen Fehler. Spätere Meldungen können Folgen desselben ursprünglichen Problems sein und müssen keine eigenständigen Fehler darstellen.
Schritt 1: Auftrag und ersten Fehler prüfen
Warten Sie, bis wartende oder laufende Aufträge abgeschlossen sind. Öffnen Sie in der Werkzeugleiste Bug und prüfen Sie Fehler sowie Original Log. Zwei häufige Formate sind:
! Undefined control sequence.l.42 \texbf{Ergebnisse}./main.tex:42: Undefined control sequence.Hier ist \texbf ein Tippfehler; richtig ist \textbf. Fehler bei der Literaturverarbeitung und Zeitüberschreitungen können anders gemeldet werden. Untersuchen Sie den tatsächlichen Fehler des Auftrags.
Schritt 2: Datei, Zeile und Kontext finden
l.42 oder main.tex:42 bezeichnet die Stelle, an der TeX ein Problem erkannt hat, nicht zwingend dessen Ursprung. Eine fehlende Klammer kann erst im nächsten Absatz auffallen. Bestimmen Sie die betroffene Haupt-, Kapitel- oder Vorlagendatei und prüfen Sie davor liegende Gruppierungen und Umgebungsgrenzen.
Bei Einträgen mit gültiger Datei und Zeile verwenden Sie Locate to position. Beheben Sie den ersten Fehler, kompilieren Sie erneut und bewerten Sie verbleibende unabhängige Probleme neu.
Schritt 3: Vollständige Blöcke in einer Kopie eingrenzen
Laden Sie vor größeren Änderungen das Quellprojekt herunter oder bewahren Sie eine wiederherstellbare Version auf:
- Prüfen Sie zuerst die jüngste Änderung.
- Teilen Sie nach vollständigen Abschnitten, Gleichungen, Tabellen oder Listen; durchtrennen Sie keine Befehlsargumente.
- Entfernen Sie vorübergehend ungefähr die Hälfte des verdächtigen Materials, lassen Sie Präambel und Abhängigkeiten aber bestehen.
- Grenzen Sie weiter ein, je nachdem, ob der ursprüngliche Fehler bleibt. Stellen Sie fehlende Abhängigkeiten wieder her, falls der Test neue undefinierte Befehle erzeugt.
Ein sichtbares PDF belegt keinen Erfolg
- Auch mit Warnungen kann ein PDF entstehen. Prüfen Sie Layout und überlaufende Inhalte.
- Wenn der aktuelle Quelltext nicht erfolgreich kompiliert wurde, kann die Vorschau ein älteres Ergebnis zeigen. Kontrollieren Sie Hauptdatei und aktuellen Auftrag.
- Preview with errors — not verified bedeutet, dass weitere Prüfung erforderlich ist.
Mit einem Minimalprojekt vergleichen
Erstellen Sie ein leeres Testprojekt, wählen Sie pdfLaTeX und setzen Sie dieses vollständige Beispiel in die Hauptdatei. Ergänzen Sie ursprünglichen Inhalt und Abhängigkeiten schrittweise:
\documentclass[a4paper,11pt]{article}\usepackage[T1]{fontenc}\usepackage{lmodern}\usepackage[ngerman]{babel}\usepackage{amsmath}\begin{document}Dies ist ein minimales Testdokument.\end{document}Drei häufige Fehler
| Meldung | Mögliche Ursache | Maßnahme |
|---|---|---|
Undefined control sequence | Tippfehler oder fehlende Definition | Schreibweise, Projektmakros und Pakete prüfen |
Missing $ inserted | Mathematischer Inhalt im Textmodus | Eine Mathematikumgebung wie \(...\) verwenden |
Extra }, or forgotten $ | Fehlerhafte Gruppierung oder Mathematikbegrenzung | Frühere Klammern und Mathematikgrenzen prüfen |
Agent mit der Untersuchung beauftragen
AI Fix im Bug-Bereich öffnet Agent und sendet eine Anfrage zur Fehlersuche. Sie können auch in Chat & Agent fragen: „Finde den ersten tatsächlichen Kompilierfehler, ändere nur das Nötige, kompiliere und nenne verbleibende Probleme.“ Prüfen Sie Änderungen und aktuellen Auftrag, anschließend das PDF.
Bei Literaturproblemen hilft die Literaturverwaltung, bei Erzeugungsproblemen der Beitrag zum Vermeiden KI-generierter Fehler.