Fehlerbehebung

Die meisten Build-Fehler hängen mit der TeX-Umgebung oder fehlenden Paketen zusammen. Dieser Leitfaden zeigt häufige Probleme und Lösungen symptombasiert.

Diagnose-Befehle

Öffnen Sie das Terminal und führen Sie aus:

which lualatex which latexmk which latexindent which synctex

Prüfen Sie auch in TeX64: Einstellungen > Umgebung, um den Umgebungsstatus zu verifizieren

Probleme mit der TeX-Umgebung

„latexmk not found"

Ursache: TeX-Distribution nicht installiert oder nicht im PATH

Lösung:

  • Installieren Sie MacTeX von https://www.tug.org/mactex/
  • Oder: sudo tlmgr install latexmk
  • Überprüfen: which latexmk
  • Starten Sie TeX64 nach der Installation neu

„lualatex not found"

Ursache: TeX-Distribution nicht installiert

Lösung: Installieren Sie MacTeX (enthält lualatex)

„latexindent not found"

Lösung:

sudo tlmgr install latexindent

Hinweis: latexindent ist optional (für Code-Formatierung), Build funktioniert auch ohne

„synctex not found"

Lösung: standardmäßig in MacTeX enthalten, oder: sudo tlmgr install synctex

Ohne synctex funktioniert die SyncTeX-Navigation nicht

Fehlendes .sty-Paket

Fehler: „File xxx.sty not found"

Lösung:

sudo tlmgr install <package-name>

Zum Suchen:

tlmgr search --global --file <filename>

PATH-Probleme

Prüfen: echo $PATH

Sollte /Library/TeX/texbin für MacTeX oder /opt/homebrew/bin für Homebrew enthalten

Lösung: In ~/.zshrc einfügen: export PATH="/Library/TeX/texbin:$PATH"

Terminal und TeX64 neu starten

Build-Probleme

Build schlägt mit Fehlern fehl

Prüfen Sie das Build-Ausgabe-Panel auf Fehlermeldungen. Klicken Sie auf einen Fehler, um zur Quellzeile zu springen.

Häufige Ursachen: Tippfehler in LaTeX-Befehlen, nicht zusammenpassende Klammern, fehlende Pakete

Tipp: Verwenden Sie KI (Axiom) zur Diagnose – fügen Sie den Fehler ein oder fragen Sie im Chat

PDF wird nicht aktualisiert

Das PDF wird nur bei ERFOLGREICHEN Builds aktualisiert. Prüfen Sie die Build-Ausgabe auf Fehler.

Über die Build-Schaltfläche in der Symbolleiste neu bauen.

Build ist langsam

Große Projekte mit vielen Bildern dauern länger.

latexmk verwendet inkrementelle Kompilierung – nachfolgende Builds sind schneller.

Der erste Build kann durch Paket-Downloads langsam sein

SyncTeX-Probleme

SyncTeX funktioniert nicht

Überprüfen, ob synctex installiert ist: which synctex

Projekt über die Build-Schaltfläche neu bauen, um die .synctex.gz-Datei zu generieren

Grünen Haken in Einstellungen > Umgebung überprüfen

SyncTeX springt an falsche Stelle

Manche LaTeX-Pakete stören das Source-Mapping

Mehrdatei-Projekte: Stellen Sie sicher, dass \input/\include-Pfade korrekt sind

macOS-Probleme

Gatekeeper

Strg+Klick (Rechtsklick) → Öffnen Oder: Systemeinstellungen > Datenschutz & Sicherheit > Erlauben

Bildschirmaufnahme-Berechtigung (für OCR)

Systemeinstellungen > Datenschutz & Sicherheit > Bildschirmaufnahme > TeX64 aktivieren

TeX64 muss nach Erteilung der Berechtigung ggf. neu gestartet werden

„App is Damaged"

DMG erneut herunterladen. Korrekte Architektur überprüfen (Apple Silicon vs. Intel)

KI/Axiom-Probleme

KI-Funktionen nicht verfügbar

Stellen Sie sicher, dass Sie angemeldet sind, und prüfen Sie dann Ihr Konto: Konto > Abrechnung

KI (Chat & Vervollständigung) ist in jedem Plan enthalten, einschließlich eines kleinen monatlichen Kontingents im kostenlosen Plan. Der häufigste Grund, warum sie aufhört zu funktionieren, ist ein aufgebrauchtes monatliches Token-Kontingent (oder eine überfällige Zahlung) – laden Sie auf oder warten Sie auf den nächsten Zyklus.

Token-Kontingent prüfen: Konto > Nutzung

Internetverbindung überprüfen

KI-Antworten langsam oder Timeout

Internetverbindung prüfen

Server kann ausgelastet sein – versuchen Sie es in Kürze erneut

Rate-Limit: 30 Anfragen/Minute

Konto & Anmeldung

Google-Login schlägt fehl

Internetverbindung überprüfen. Browser-Cookies/Cache löschen. Erneut anmelden.

Abonnement wird nicht übernommen

Abrechnungsänderungen können einige Minuten dauern

Bei fehlgeschlagener Zahlung Zahlungsmethode über Stripe Billing-Portal aktualisieren

Karenzzeit: 3 Tage nach Zahlungsfehler, bevor Funktionen deaktiviert werden

Galerie-Probleme

Beitragslimits: Free=10, Basic=100, Pro=500

Tageslimit: 10 Beiträge pro Tag

Bildgröße: max. 20 MB. TeX-Quelle: max. 500.000 Zeichen. Tags: max. 8 pro Beitrag.

Hilfe erhalten

Verwenden Sie den KI-Chat, um Probleme zu beschreiben (er kann Compile-Logs lesen)

Support kontaktieren unter /feedback

Bitte angeben: macOS-Version, TeX64-Version, Fehlermeldung, Schritte zur Reproduktion

Optionale Fehlerdiagnose kann in Einstellungen > Datenschutz aktiviert werden

Tipp: Beginnen Sie bei der Diagnose von Build-Problemen mit den Diagnose-Befehlen, um die Einrichtung der TeX-Umgebung zu überprüfen. Die meisten Probleme stammen von Umgebungsproblemen.