Behebe den fatalen fontspec-Fehler in LaTeX.
Der Fehler Fatal Package fontspec Error: The fontspec package requires either XeTeX or LuaTeX tritt auf, wenn du ein Dokument kompilierst, das fontspec mit pdfLaTeX oder Standard-LaTeX lädt. Das Paket basiert auf Funktionen zur Schriftverwaltung, die nur XeTeX und LuaTeX bieten.
Die kurze Antwort: Stelle in deinen Editoreinstellungen die Engine von pdfLaTeX auf XeLaTeX oder LuaLaTeX um. Falls dein Verlag zwingend pdfLaTeX erfordert, entferne \usepackage{fontspec} und verwende stattdessen traditionelle Schriftpakete wie lmodern mit fontenc.
Warum der Fehler auftritt
Das traditionelle pdfLaTeX verarbeitet Schriften über TeX-Font-Metrik-Dateien (.tfm) und Type-1-PostScript-Konturen. Das Paket fontspec funktioniert völlig anders: Es lädt OpenType- (.otf) und TrueType-Schriften (.ttf), die auf deinem Betriebssystem installiert oder in deinem Projektordner gespeichert sind.
Da pdfLaTeX die interne Maschinerie zum Lesen von OpenType-Schrifttabellen fehlt, bricht fontspec beim Laden sofort ab. Es wirft entweder Fatal fontspec error: "cannot-use-pdftex" oder The fontspec package requires either XeTeX or LuaTeX, um eine fehlerhafte PDF-Erstellung zu verhindern.
Du siehst diesen Fehler möglicherweise, selbst wenn du \usepackage{fontspec} nie selbst in deine Präambel geschrieben hast. Viele moderne Lebenslauf-Vorlagen (wie Awesome-CV), mehrsprachige Pakete wie polyglossia und Unicode-Mathe-Pakete laden fontspec im Hintergrund.
Lösung 1: Stelle deinen Compiler auf XeLaTeX oder LuaLaTeX um
Das Umstellen der Engine deines Projekts ist die Standardlösung, wenn du benutzerdefinierte OpenType-Schriften oder Unicode-Text verwenden möchtest.
In Texeno
Öffne die Projekteinstellungen über die linke Seitenleiste oder die obere Leiste. Wähle unter Compiler-Engine XeLaTeX oder LuaLaTeX. Beide Engines laufen auf TeX Live 2026 mit vollständiger fontspec-Unterstützung.
In Overleaf
Klicke auf das Menü-Symbol in der oberen linken Ecke über dem Dateibaum. Ändere im Dropdown-Menü „Compiler“ pdfLaTeX zu XeLaTeX oder LuaLaTeX und kompiliere erneut.
In VS Code (LaTeX Workshop)
Füge einen Magic Comment ganz oben in deiner Haupt-
.tex-Datei hinzu oder setze das Standard-Rezept insettings.jsonauflatexmk (xelatex).% !TEX program = xelatex \documentclass{article} \usepackage{fontspec}In TeXstudio
Füge die Programm-Direktive ganz oben in deinem Dokument hinzu oder gehe zu Optionen -> TeXstudio konfigurieren -> Erzeugen und setze den Standard-Compiler auf XeLaTeX.
%!TEX TS-program = xelatex
Lösung 2: Behalte pdfLaTeX und ersetze fontspec
Bereinige Präambel-Konflikte nach dem Wechsel
Was zu prüfen ist, wenn die Kompilierung nach dem Wechsel fehlschlägt
Wenn das Ändern der Engine den fatalen Fehler behebt, aber die Kompilierung bei einer neuen Meldung anhält, prüfe diese zwei häufigen Ursachen.
Package fontspec Error: The font cannot be found
Dies passiert, wenn dein Code eine Betriebssystemschrift (wie Times New Roman, Calibri oder SimSun) anfordert, die auf dem Linux-Server, auf dem dein Compiler läuft, nicht installiert ist. Stelle die Schriftdatei (.otf oder .ttf) in deinem Projektverzeichnis bereit und referenziere sie über den Dateinamen.
\setmainfont{CustomFont}[ Path = ./fonts/ , Extension = .otf , UprightFont = *-Regular , BoldFont = *-Bold ]Konflikte mit Package unicode-math
Wenn du sowohl
amssymbals auchunicode-mathlädst, werden Symboldefinitionen kollidieren. Entferneamssymbund lade nurunicode-math, wenn du unter XeLaTeX oder LuaLaTeX kompilierst.
Fragen
Kann ich fontspec mit pdfLaTeX verwenden?
Nein. Das Paket fontspec hängt von primitiven Operationen ab, die nur in XeTeX und LuaTeX existieren. Wenn du pdfLaTeX verwenden musst, ersetze fontspec durch Standard-Schriftpakete wie lmodern oder mathptmx.
Welche Engine sollte ich wählen: XeLaTeX oder LuaLaTeX?
LuaLaTeX ist der moderne Standard für TeX Live und verarbeitet komplexe Schriftformungen, große microtype-Anpassungen und dynamische Speicherzuweisung reibungslos. XeLaTeX bleibt eine solide Wahl für veraltete Vorlagen oder ostasiatische Skripte, die xeCJK verwenden.
Probier dein eigenes Paper in Texeno aus.
Starte kostenlos, lade ein Projekt als .zip hoch und klicke auf „Neu kompilieren“. Upgrade, wenn du längere Kompilierungen brauchst.
Losschreiben
