Fehler- und Warnungslisten

LaTeX-Fehlermeldungen sind so gebaut, dass die ersten Worte nach dem ! verraten, wer sich beschwert. Ein nacktes ! Missing $ inserted. stammt von der TeX-Engine selbst, ! LaTeX Error: vom LaTeX-Kern und ! Package hyperref Error: von dem Paket, das genannt wird. Wer diese Unterscheidung liest, weiß schon nach der ersten Zeile, ob die Korrektur ins eigene Manuskript gehört, in die Ladereihenfolge der Präambel oder in fremdes Fehlerverzeichnis. Diese Seite ist ein Index der Meldungen, die wirklich vorkommen, wörtlich zitiert, jeweils mit dem, was sie tatsächlich bedeuten, und einem Verweis auf die Seite, die sie ausführlich behandelt. Jede hier aufgeführte Meldung wurde auf TeX Live 2024 reproduziert.

Die Worte nach ! nennen den Absender: TeX, LaTeX, ein Paket oder eine Warnung

Eine Zeile, die mit ! beginnt, ist ein Fehler und kann den Build stoppen; eine Zeile ohne ! ist eine Warnung oder ein Hinweis, und der Build läuft weiter. Die Fehler wiederum zerfallen in drei Schichten, und die Worte direkt nach dem ! sagen, welche. Die unterste Schicht ist die TeX-Engine, deren Meldungen gar kein Präfix tragen – ! Missing $ inserted. liest sich seit vierzig Jahren wortgleich, und reines TeX ohne LaTeX gibt denselben Satz aus. Die mittlere Schicht ist der LaTeX-Kern mit ! LaTeX Error: …, die oberste sind Pakete und Klassen mit ! Package X Error: … und ! Class X Error: …. Je höher die Schicht, desto freundlicher die Formulierung; je tiefer, desto näher an dem, woran TeX wirklich hängt. Eine Meldung ohne Präfix bedeutet meist, dass die Syntax des Manuskripts selbst beschädigt ist.

Fehler der TeX-Engine: die Meldungen ohne Präfix

Diese Gruppe meldet, dass TeX im Eingabestrom nicht weiterkommt, und die Ursache liegt fast immer bei der Paarung von Klammern, $ oder & oder bei der Schreibweise einer Zahl. Die knappe Formulierung stammt aus einer Zeit, in der es LaTeX noch nicht gab. Der Vorteil: Diese Zeichenketten sind auf jeder Distribution und in Dokumenten jeden Alters gleich und lassen sich daher gut suchen. Das Folgende wurde auf TeX Live 2024 reproduziert.

Fehler des LaTeX-Kerns: alles, was mit ! LaTeX Error: beginnt

Hier geht es um Verstöße gegen LaTeX-Konventionen statt gegen TeX-Syntax, und weil die Formulierung viel konkreter ist, gibt es meist genau eine Korrektur. Nicht zusammenpassende Umgebungen, ein \usepackage an falscher Stelle, ein nur in der Präambel erlaubter Befehl, eine fehlende Datei – jedes davon ist eine Regel, die LaTeX selbst aufgestellt hat. Zu beachten: In der .log folgt auf jede dieser Meldungen ein Hilfeabsatz, der mehr sagt als die eine Zeile im Terminal; reicht der Wortlaut nicht, hilft ein Blick ins Log.

Paketfehler: ! Package X Error: ist die Stimme von X

Meldungen dieser Schicht hat das genannte Paket selbst formuliert, dieselben Worte stehen also in dessen Handbuch – texdoc X öffnen und nach der Meldung suchen ist der kürzeste Weg. Sie sind zudem konkret: Diese Umgebung ist hier nicht erlaubt, diese Farbe ist nicht definiert, dieses Paket verträgt sich nicht mit jenem. Die Abhilfe steht oft direkt dabei. Das Folgende wurde auf TeX Live 2024 erzeugt.

Warnungen: Sie stoppen nie den Build, aber wer sie ignoriert, liefert ein falsches PDF

Warnungen stoppen den Build nie und ändern den Rückgabewert nicht von 0, weshalb ein CI-Job den Lauf als Erfolg wertet. Genau das macht sie gefährlich: Ein PDF, dessen Verweise noch ?? zeigen oder dessen Nummern eine Revision hinterherhinken, entsteht hier. Zwei davon sind Anweisungen und keine hinnehmbaren Warnungen: LaTeX Warning: There were undefined references. und Label(s) may have changed. Rerun to get cross-references right. bedeuten schlicht, dass erneut übersetzt werden muss. Ein Build-Skript sollte diese beiden Zeilen erkennen und neu starten – oder die Sache gleich latexmk überlassen.

Meldungen, die es nicht mehr gibt und nur in veralteten Ratschlägen fortleben

In alten Antworten aus der Suche stehen weiterhin Meldungen, die TeX Live 2024 gar nicht mehr erzeugt; wer dieselbe Zeichenkette nicht sieht, hat deshalb keine kaputte Installation. Am deutlichsten zeigt sich das beim Unicode-Fehler. Früher lautete er ! Package inputenc Error: Unicode character …; seit die UTF-8-Behandlung im Kern liegt, lautet er ! LaTeX Error: Unicode character 日 (U+65E5), gefolgt von not set up for use with LaTeX. in der nächsten Zeile. Und → sowie € scheitern überhaupt nicht mehr – gemessen zerfallen die Zeichen in solche, die pdfLaTeX nun annimmt, und solche, die es weiterhin ablehnt, etwa CJK, Emoji und ≤. Der Optionskonflikt bei xcolor ging denselben Weg, aus einem Grund, den die Seite zu Paketkonflikten erklärt.

• Unicode-Zeichen – die Meldung lautet jetzt ! LaTeX Error: Unicode character 日 (U+65E5) statt ! Package inputenc Error:. Unter pdfLaTeX gehen → und € durch, CJK, Emoji und ≤ weiterhin nicht.
• Der Optionskonflikt bei xcolor – auf \usepackage[dvipsnames]{xcolor} darf \usepackage[table]{xcolor} folgen, ohne dass ein Fehler entsteht, denn xcolor nutzt inzwischen Schlüssel-Wert-Optionen.
• caption mit subfigure – der alte Fehler „kann nicht zusammen verwendet werden“ ist verschwunden; die .log vermerkt nur noch Package caption Info: subfigure package is loaded.
• subfigure mit subcaption – beide zu laden erzeugt keinen Fehler. Stattdessen verschluckt der alte Befehl \subfigure das \begin{subfigure}, und es erscheinen scheinbar unzusammenhängende Fehler wie ! Missing number, treated as zero.