LaTeX-Installation und Konfiguration
LaTeX ist ein auf TeX basierendes Satzsystem. Bevor Sie es verwenden, müssen Sie eine TeX-Distribution und einen Editor installieren.
Dieses Kapitel führt in die Installation und Konfiguration von LaTeX ein und behandelt Windows-, macOS- und Linux-Systeme.
LaTeX installieren
Windows-System
Unter Windows wird empfohlen,MiKTeXoderTeX Livezu verwenden, um LaTeX zu installieren.
MiKTeX installieren
- MiKTeX herunterladen: Besuchen Siedie offizielle MiKTeX-Websiteund laden Sie das für Ihr System passende Installationsprogramm herunter.
- Führen Sie das Installationsprogramm aus: Doppelklicken Sie auf das heruntergeladene Installationsprogramm und folgen Sie den Anweisungen zur Installation. Es wird empfohlen, "Vollständige Installation" zu wählen, um sicherzustellen, dass alle gängigen Pakete installiert werden.
- Umgebungsvariablen konfigurieren: Stellen Sie nach der Installation sicher, dass das MiKTeX-
binVerzeichnis der PATH-Umgebungsvariablen des Systems hinzugefügt wurde. Dadurch können Sie LaTeX-Befehle direkt in der Befehlszeile verwenden.
TeX Live installieren
- TeX Live herunterladen: Besuchen Siedie offizielle TeX-Live-Websiteund laden Sie das für Ihr System passende Installationsprogramm herunter.
- Installationsprogramm ausführen: Doppelklicken Sie auf das heruntergeladene Installationsprogramm und folgen Sie den Anweisungen zur Installation. Der Installationsprozess von TeX Live ist zeitaufwändig, da er eine große Anzahl von Paketen und Werkzeugen umfasst.
- Umgebungsvariablen konfigurieren: Stellen Sie nach der Installation sicher, dass das TeX-Live-
binVerzeichnis zur PATH-Umgebungsvariable des Systems hinzugefügt wurde.
macOS-System
Unter macOS wird empfohlen,MacTeXzur Installation von LaTeX zu verwenden.
MacTeX installieren
- MacTeX herunterladen: Besuchen Siedie offizielle MacTeX-Websiteund laden Sie das für Ihr System passende Installationsprogramm herunter.
- Installationsprogramm ausführen: Doppelklicken Sie auf die heruntergeladene
.pkgDatei und folgen Sie den Anweisungen zur Installation. MacTeX enthält TeX Live und zugehörige GUI-Tools. - Umgebungsvariablen konfigurieren: Stellen Sie nach der Installation sicher, dass das TeX-Live-
binVerzeichnis zur PATH-Umgebungsvariable des Systems hinzugefügt wurde.
Linux-System
Unter Linux wird empfohlen,TeX Livezur Installation von LaTeX zu verwenden.
TeX Live installieren
- Mit einem Paketmanager installieren: Die meisten Linux-Distributionen bieten TeX-Live-Pakete an. Sie können einen Paketmanager verwenden, um es zu installieren. Unter Ubuntu können Sie beispielsweise den folgenden Befehl verwenden:
sudo apt-get install texlive-full
Dies installiert die vollständige TeX Live-Distribution, einschließlich aller häufig verwendeten Pakete und Werkzeuge. - Manuelle Installation: Wenn Sie die neueste Version von TeX Live benötigen, können Sie das Installationsskript von deroffiziellen TeX Live-Websiteherunterladen und es manuell installieren.
LaTeX konfigurieren
Einen Editor auswählen
LaTeX-Dokumente sind reine Textdateien, daher können Sie jeden Texteditor verwenden, um LaTeX-Code zu schreiben. Die Verwendung eines speziellen LaTeX-Editors kann jedoch die Effizienz verbessern. Hier sind einige gängige LaTeX-Editoren:
- TeXstudio: Ein plattformübergreifender LaTeX-Editor mit leistungsstarken Funktionen, geeignet sowohl für Anfänger als auch für fortgeschrittene Benutzer.
- Overleaf: Ein Online-LaTeX-Editor, der keine Installation erfordert, geeignet für Zusammenarbeit und schnelles Bearbeiten.
- VS Code: Ein Allzweck-Code-Editor, der LaTeX-Bearbeitung und -Kompilierung unterstützen kann, indem LaTeX-Plugins (wie LaTeX Workshop) installiert werden.
LaTeX-Dokumente kompilieren
LaTeX-Dokumente müssen kompiliert werden, um die endgültige PDF-Datei zu erzeugen. Häufige Kompilierungsbefehle sind:
pdflatex: Erzeugt PDF-Dateien, geeignet für die meisten Dokumente.xelatex: Unterstützt Unicode- und TrueType-Schriften, geeignet für die Verarbeitung chinesischer Dokumente.lualatex: Eine auf Lua basierende Kompilierungsengine, die moderne Schriftarten und erweiterte Funktionen unterstützt.
Der Kompilierungsbefehl wird wie folgt verwendet:
pdflatex mydocument.tex
Dies wird generierenmydocument.pdfDatei.
Umgang mit chinesischen Dokumenten
Wenn Sie chinesische Dokumente verarbeiten müssen, wird empfohlen,xelatexoderlualatexKompilierungsengine zusammen mit demctexPaket. Hier ist ein einfaches LaTeX-Beispiel für ein chinesisches Dokument:
Beispiel
\begin{document}
Hallo, Welt!
\end{document}
Verwenden Siexelatexum das Dokument zu kompilieren:
xelatex mydocument.tex
Installieren und Verwalten von Paketen
LaTeX-Pakete können über Paketmanager installiert und verwaltet werden. In MiKTeX und TeX Live können Sie die folgenden Befehle verwenden, um Pakete zu installieren:
- MiKTeX: Verwenden Sie
MiKTeX Consolezum Suchen und Installieren von Paketen. - TeX Live: Verwenden Sie den
tlmgrBefehl zum Installieren von Paketen. Zum Beispiel:tlmgr install <package-name>
Kompilierungs-Workflow
Der zentrale Arbeitsablauf von LaTeX ist:
你编写的 .tex 源文件 → 编译器(如 pdfLaTeX) → 生成 .pdf 文件
Während der Kompilierung werden auch einige Hilfsdateien (wie .aux, .log, .toc) erzeugt. Sie werden verwendet, um Informationen wie Inhaltsverzeichnis und Referenzen aufzuzeichnen, und müssen normalerweise nicht manuell verwaltet werden.
Gängige Kompilierungsbefehle sind:
- pdflatex: Am häufigsten verwendet, erzeugt direkt PDF, hat aber schwache Unterstützung für Chinesisch und Schriftarten
- xelatex: Unterstützt Systemschriftarten und Chinesisch, empfohlen für chinesische Benutzer
- lualatex: Eine leistungsfähigere Engine der neuen Generation, etwas langsamer
Ihr erstes "Hello World"-Dokument
Erstellen Sie eine neue .tex-Datei und geben Sie den folgenden Inhalt ein:
\documentclass{article}
\begin{document}
Hello, World! 这是我的第一份 LaTeX 文档。
\end{document}
Klicken Sie nach dem Speichern auf Kompilieren, und Sie erhalten ein PDF-Dokument, das diesen Satz enthält.
Die grundlegende Dokumentstruktur verstehen
Ein LaTeX-Dokument ist normalerweise in zwei Teile unterteilt:
\documentclass{article} % 前导区(Preamble):设置文档类型、加载宏包
\begin{document} % 正文区:实际显示的内容
正文内容写在这里
\end{document} - Präambel: Befindet sich zwischen \documentclass und \begin{document}, wird verwendet, um den Dokumenttyp zu deklarieren, Pakete zu laden und globale Einstellungen zu definieren. Dieser Teil erscheint nicht im finalen PDF.
- Textkörper: Der Inhalt zwischen \begin{document} und \end{document} ist der Teil, der tatsächlich gesetzt und ausgegeben wird.
Häufige Dokumentklassen
\documentclass{article} % 文章、短报告,无章节 chapter
\documentclass{report} % 长报告,支持 chapter
\documentclass{book} % 书籍,支持双面排版、chapter
\documentclass{letter} % 信件
\documentclass{beamer} % 演示文稿(幻灯片)
Optionen können in eckigen Klammern übergeben werden, zum Beispiel:
\documentclass[12pt, a4paper]{article}Dies bedeutet, dass eine Schriftgröße von 12pt und A4-Papier für den Satz verwendet werden.
Grundlegende Struktur eines Dokuments
Jedes LaTeX-Dokument besteht aus zwei Teilen: der Präambel und dem Textkörper.
Vor \begin{document} befindet sich diePräambel, die verwendet wird, um die Dokumentklasse zu deklarieren, Pakete zu laden und globale Einstellungen wie Titel und Autor festzulegen.
Zwischen \begin{document} und \end{document} befindet sich derTextkörper, in dem Titel, Kapitel, Text und Formeln geschrieben werden.
Die Dokumentklasse bestimmt die Gesamtform des Dokuments und wird in der ersten Zeile \documentclass angegeben.
| Dokumentklasse | Zweck | Typische Szenarien |
|---|---|---|
| article | Kurze Artikel und Aufsätze, ohne "chapter"-Ebene | Zeitschriftenartikel, Aufgaben, kleine Berichte |
| report | Lange Berichte mit "chapter"-Ebene | Laborberichte, Kursprojekte |
| book | Bücher, einschließlich Vorwort, Kapitel, Anhänge | Lehrbücher, Monografien |
| ctexart / ctexrep / ctexbook | Chinesische Versionen der oben genannten drei | Wählen Sie es einfach für jedes chinesische Dokument. |
| beamer | Folien | Wissenschaftliche Präsentationen, ausführlich behandelt in Artikel/Lektion 12 |
Dokumentklassen können auch Optionen in eckigen Klammern annehmen, z. B. zur Angabe von Schriftgröße und Papier:
Beispiel: Dokumentklasse mit Optionen
% a4paper: A4-Papier (Standard ist letter; für den inländischen Druck wird eine explizite Angabe empfohlen)
\documentclass[12pt, a4paper]{ctexart}
Ihr erstes vollständiges Dokument
Hello World ist zu einfach, um den Wert von LaTeX zu demonstrieren. Das folgende Dokument fügt einen Titelblock, Listen und Formeln hinzu, wodurch es dem alltäglichen Gebrauch viel näher kommt.
Beispiel: Ihr erstes vollständiges Dokument
\usepackage{geometry} % Lade das Paket für die Seiteneinrichtung (erforderlich vor der Verwendung von \geometry)
\geometry{a4paper, margin=2.5cm} % A4-Papier, 2.5 cm Seitenränder auf allen vier Seiten
\title{Mein erstes vollständiges Dokument} % Titel
\author{BEISPIEL} % Autor
\date{\today} % \today trägt automatisch das Kompilierungsdatum ein
\begin{document}
\maketitle % Erzeugt den Titelblock (Titel, Autor und Datum zentriert dargestellt)
Hallo,\LaTeX{}! Dieses Dokument wurde mit XeLaTeX kompiliert.
Ich verwende LaTeX gerne für drei Dinge:
\begin{itemize} % Umgebung für ungeordnete Listen
\itemMathematische Formeln schreiben, wie zum Beispiel den Satz des Pythagoras$a^2 + b^2 = c^2$;
\itemAutomatisches Generieren von Abschnittsnummern und einem Inhaltsverzeichnis;
\itemLange Dokumente einheitlich formatiert halten.
\end{itemize}
\end{document}
Kompiliertes Ergebnis:

Beachten Sie einige Details: \maketitle rendert die in der Präambel definierten Titelinformationen in einen Titelblock; \today generiert automatisch "August 20, 2026" ohne manuelle Eingabe; die itemize-Liste fügt automatisch Aufzählungszeichen hinzu.
Die detaillierten Regeln für diese Befehle werden in den folgenden Artikeln einzeln erklärt.
Fehlerbehebung bei häufigen Problemen
Wenn Sie Ihre Umgebung zum ersten Mal einrichten, sind Probleme die Norm. Nachfolgend finden Sie die häufigsten Fehler, die von Anfängern gemeldet werden.
| Symptom | Ursache | Lösung |
|---|---|---|
| Chinesischer Text wird leer angezeigt oder löst direkt einen Fehler aus | Der Compiler ist nicht XeLaTeX | Overleaf: Wechseln Sie es im Menü; lokal mit dem Befehl xelatex kompilieren |
| Nicht definierte Steuersequenz | Der Befehl ist falsch geschrieben, oder es wird ein Befehl aus einem Paket verwendet, das nicht geladen wurde | Überprüfen Sie das Log, um die Zeilennummer zu finden und die Schreibweise zu prüfen; stellen Sie sicher, dass das entsprechende Paket mit \usepackage geladen ist |
| Datei 'xxx.sty' nicht gefunden | Der lokalen Distribution fehlt dieses Paket | TeX Live: mit tlmgr install xxx installieren; MiKTeX lädt es normalerweise automatisch herunter |
| Inhaltsverzeichnis und Referenzen werden als ?? angezeigt | Nur einmal kompiliert | Erneut kompilieren |
| Zeitüberschreitung bei der Overleaf-Kompilierung | Die kostenlose Version hat Ressourcenbeschränkungen | Vereinfachen Sie das Dokument oder wechseln Sie zur lokalen Kompilierung |