JSON vs YAML vs TOML, Erklaert

Zuletzt geprueft 2026-04-27. Oeffnen Sie den JSON-Parser oder JSON to CSV fuer JSON-Arbeit im Browser.

Die drei Formate nebeneinander

Dieselbe Konfiguration, drei Wege:

JSON                        YAML                  TOML
{                           server:               [server]
  "server": {                 host: "localhost"   host = "localhost"
    "host": "localhost",      port: 8080          port = 8080
    "port": 8080
  }
}                                                 

JSON - streng und eindeutig

JSONs Designziel war ein Format, das jede Sprache identisch parsen kann. Die Grammatik ist klein (sechs Datentypen, gut definierte Leerraumregeln). Jeder Parser produziert denselben Baum. Diese Einheitlichkeit ist der Grund, warum JSON APIs, Konfigurationsdateien fuer Werkzeuge, die mit einem JSON-Parser ausgeliefert werden, und Maschine-zu-Maschine-Serialisierung dominiert.

Wo JSON umstaendlich ist: Kommentare sind nicht erlaubt, nachgestellte Kommas sind Syntaxfehler, und tief verschachtelte Konfiguration wird fuer Menschen unlesbar. Die Loesung ist JSON5 (JSON mit Kommentaren und nachgestellten Kommas) fuer von Menschen bearbeitete Konfiguration, waehrend reines JSON fuer den Transport beibehalten wird.

YAML - lesbar, manchmal zu schlau

YAML liest sich wie Gliederungsnotizen. Einrueckung schafft Struktur; Listen verwenden Bindestriche; Werte brauchen keine Anfuehrungszeichen. Die Felder sind kurz und die Datei ist dicht. Deshalb dominiert YAML Kubernetes, GitHub Actions, Docker Compose und CI-Konfigurationen - alles Orte, an denen Menschen die Datei taeglich bearbeiten.

Wo YAML schmerzt: Leerraum ist signifikant und Tabs brechen den Parser. Die Zeichenkette "yes" wird als Boolean true geparst. Der Laendercode Norwegen "NO" wird als false geparst. Zahlen mit fuehrenden Nullen werden als Oktal geparst. Mehrzeilige Zeichenketten haben vier verschiedene Syntaxen. Das Format ist menschenlesbar, aber nicht menschensicher; subtile Parsing-Bugs sind in Produktion ueblich. Die Loesung ist, jede YAML-Datei in CI zu linten und jede Zeichenkette in Anfuehrungszeichen zu setzen, die fehlinterpretiert werden koennte.

TOML - einfach, flach

TOML zielt auf die Konfigurationsdatei-Nische, wo YAML zu locker und JSON zu ausfuehrlich ist. Abschnitte in eckigen Klammern, Schluessel-Wert-Paare mit Gleichheitszeichen, native Datums- und Zeittypen. Cargo (Rusts Paketmanager), pyproject.toml im modernen Python, und mehrere Konfigurationswerkzeuge verwenden es.

Wo TOML umstaendlich ist: tief verschachtelte Daten. Die Syntax fuer Arrays von Tabellen ist ausfuehrlich und nicht visuell offensichtlich. Fuer Verschachtelung von mehr als 2-3 Ebenen lesen sich YAML oder JSON besser. TOML gewinnt, wenn die Konfiguration natuerlich flach ist - eine Liste von Abhaengigkeiten, eine Liste von Build-Einstellungen, ein kleines Set benannter Abschnitte.

Entscheidungsregel

Maschine-zu-Maschine: JSON. Menschliche Konfiguration taeglich bearbeitet, mit grossenteils flacher Struktur: TOML. Menschliche Konfiguration taeglich bearbeitet, mit tief verschachtelter Struktur: YAML, mit Linting in CI. Im Zweifel JSON - die Strenge ist eine billige Versicherung.

Fuer das Konvertieren zwischen Formaten siehe JSON to CSV oder den JSON-Parser. Fuer andere Entwicklerwerkzeuge, der Hub fuer Entwicklerwerkzeuge.