TOML in JSON umwandeln: So ändert sich die Syntax
![Ansicht mit ausgewähltem Tab „TOML → JSON“: Im Eingabefeld oben steht TOML mit einer [database]-Tabelle und einem [[posts]]-Tabellen-Array, darunter das Ergebnis als JSON mit verschachteltem Objekt und Objekt-Array.](/images/blog/de/toml-converter/01-result.webp)
Inhalt
Wer TOML in JSON umwandeln möchte, scheitert selten an der Rechenarbeit. Meist fehlt schlicht die Zuordnung im Kopf: Welche Syntax wird zu welcher Struktur? Vorab die Kurzfassung: Die Zuordnung ist einfach. [table] wird zu einem verschachtelten Objekt, [[table]] zu einem Array von Objekten, und Schlüssel mit Punkt (.) sowie Inline-Tabellen { } werden jeweils zu Objekten.
Dieser Beitrag richtet sich an alle, die Konfigurationsdateien zwischen TOML und JSON übertragen. Anhand von Ein- und Ausgaben sehen Sie, was jedes Syntaxelement tatsächlich ergibt.
Zusammenfassung ①
[table]wird zu einem verschachtelten Objekt,[[table]]zu einem Array von Objekten, Schlüssel mit Punkt (.) und Inline-Tabellen{ }werden jeweils zu Objekten. ② In der Gegenrichtung (JSON → TOML) muss die oberste Ebene unbedingt ein Objekt sein, und Schlüssel mit dem Wertnullverschwinden komplett, weil TOML kein null kennt. ③ Werte, die wie ein Datum aussehen, bleiben Strings, und Zahlen mit Unterstrichen wie1_000_000werden zu1000000, also ohne Unterstriche.
Die Konfiguration liegt als TOML vor, das Tool akzeptiert aber nur JSON
TOML ist als Format für Konfigurationsdateien weit verbreitet. Typische Beispiele sind die Cargo.toml in Rust, die pyproject.toml in Python und die config.toml vieler Generatoren für statische Websites.
Probleme entstehen, wenn Sie eine solche Konfiguration an ein anderes Tool oder Skript weitergeben müssen, das nur JSON annimmt. Zum Beispiel, wenn Sie einen Teil der pyproject.toml in ein JSON-basiertes Validierungstool geben wollen oder wenn Sie eine bisher als JSON gepflegte Konfiguration in ein Tool übernehmen, das TOML verwendet.
Beim manuellen Übertragen verrutscht die Struktur leicht: Bis wohin gehört eine verschachtelte Tabelle wie [tool.black] zu einem Objekt? Ist eine doppelte eckige Klammer wie bei [[tool.poetry.source]] ein Array oder ein Objekt? Das Format selbst ist simpel, aber ohne die Zuordnungsregeln passieren genau hier Fehler.
Syntax ohne Tool Schritt für Schritt zuordnen
Zuerst das Prinzip: TOML wurde von Anfang an so entworfen, dass es eindeutig auf eine Hashtabelle (eine Sammlung von Schlüssel-Wert-Paaren, also ein Dictionary) abgebildet werden kann. Deshalb passt es gut zu JSON-Objekten, und die Zuordnung lässt sich in wenigen Regeln zusammenfassen.
Es sind fünf Regeln:
Schlüssel = Wert→ wird unverändert als Paar"Schlüssel": Wertübernommen.- Zeilen unter
[owner]→ werden zu einem verschachtelten Objekt"owner": { ... }zusammengefasst. - Schlüssel mit Punkt (.) wie
owner.name = "Max Mustermann"→ ergeben genau dasselbe wie die Schreibweise mit[owner], nämlich"owner": { "name": "Max Mustermann" }. - Wiederholtes
[[posts]]→ ergibt ein Array von Objekten:"posts": [ {...}, {...} ]. Die doppelte eckige Klammer ist das Signal für ein „Array“. - Inline-Tabelle
{ x = 1, y = 2 }→ wird zum Objekt{ "x": 1, "y": 2 }.
Das folgende TOML zum Beispiel
title = "Blog-Einstellungen"
version = 2
tags = ["seo", "auto", "blog"]
[database]
host = "127.0.0.1"
port = 5432
[[posts]]
title = "Erster Beitrag"
views = 120
[[posts]]
title = "Zweiter Beitrag"
views = 45
wird so umgewandelt:
{
"title": "Blog-Einstellungen",
"version": 2,
"tags": [
"seo",
"auto",
"blog"
],
"database": {
"host": "127.0.0.1",
"port": 5432
},
"posts": [
{
"title": "Erster Beitrag",
"views": 120
},
{
"title": "Zweiter Beitrag",
"views": 45
}
]
}
Man sieht auf einen Blick, dass [database] zum Objekt "database" und [[posts]] zum Array "posts" wurde.
Wenn Sie prüfen möchten, ob Ihr manuell übertragenes Ergebnis stimmt, können Sie es durch einen Standard-Parser laufen lassen. Ab Python 3.11 enthält die Standardbibliothek mit tomllib einen TOML-Parser, der nur lesen kann. Ohne zusätzliche Installation sehen Sie dieselbe Umwandlung mit einer einzigen Zeile:
python3 -c "import tomllib,json; print(json.dumps(tomllib.load(open('config.toml','rb')), indent=2, ensure_ascii=False))"
Der Vorteil: Es ist ein vollwertiger Parser und meldet daher Syntaxfehler als Fehler. Allerdings ist es jedes Mal umständlich, erst eine Datei anzulegen und dann den Befehl einzutippen. Für die Gegenrichtung (JSON → TOML) bietet die Standardbibliothek zudem kein Schreibwerkzeug, sodass Sie eine zusätzliche Bibliothek installieren müssen.
Mit unserem Tool prüfen.
Einfügen und direkt im Browser in beide Richtungen zwischen TOML und JSON umwandeln. Kostenlos, ohne Installation und Registrierung; Ihre Eingaben werden nicht an einen Server gesendet.
![Ansicht mit ausgewähltem Tab „TOML → JSON“: Im Eingabefeld oben steht TOML mit einer [database]-Tabelle und einem [[posts]]-Tabellen-Array, darunter das Ergebnis als JSON mit verschachteltem Objekt und Objekt-Array.](/images/blog/de/toml-converter/01-result.webp)
Typische Stolperstellen beim Lesen des Ergebnisses
Wenn Sie die Zuordnung kennen, gibt es bei der Richtung TOML → JSON kaum Missverständnisse. Unklarheiten entstehen vor allem in der Gegenrichtung und bei einigen Werten. Die häufigsten Fälle im Überblick:
| Situation | Ergebnis |
|---|---|
| JSON-Wurzel ist ein Array, eine Zahl oder ein String | Fehler „Die oberste Ebene von TOML muss ein Objekt sein“ |
Schlüssel mit dem Wert null | Der Schlüssel entfällt komplett, da TOML kein null kennt |
Datumsstring wie "2026-07-17" | Bleibt ein String in Anführungszeichen |
Zahl mit Unterstrichen wie 1_000_000 | Wird zur Zahl 1000000 ohne Unterstriche |
# Kommentar (außerhalb von Anführungszeichen) | Wird im Ergebnis entfernt |
Die oberste Ebene muss ein Objekt sein. In der Richtung JSON → TOML meldet der Konverter „Die oberste Ebene von TOML muss ein Objekt sein“, wenn die oberste Ebene wie bei [1, 2, 3] ein Array oder einfach nur eine Zahl bzw. ein String ist. Eine TOML-Datei ist insgesamt eine einzige Sammlung von Schlüssel-Wert-Paaren, daher kann ein namenloses Array nicht ganz außen stehen. Wenn Sie es wie in { "items": [1, 2, 3] } einmal in einen Schlüssel einpacken, funktioniert die Umwandlung.
Schlüssel mit null verschwinden. TOML kennt den Wert null überhaupt nicht. Steht in Ihrem JSON "nickname": null, taucht im TOML-Ergebnis die Zeile nickname gar nicht erst auf. Es wird also nicht ein leerer Wert ausgegeben, sondern der ganze Schlüssel entfällt. Wandeln Sie das Ergebnis wieder in JSON zurück, fehlt dieser Schlüssel.
Auch was wie ein Datum aussieht, ist ein String. TOML hat zwar ursprünglich eigene Datums- und Zeittypen, dieser Konverter vereinfacht das aber und speichert Werte wie 2026-07-17 als String statt als Datumstyp. Deshalb steht im JSON-Ergebnis "2026-07-17" in Anführungszeichen. Dass ein solcher Wert fälschlich als Zahl erkannt und dadurch beschädigt wird, passiert nicht.
Unterstriche in Zahlen dienen der Gliederung. In TOML können Sie Ziffern wie in 1_000_000 mit Unterstrichen gliedern, damit sie leichter lesbar sind. Der Konverter entfernt die Unterstriche und macht daraus die Zahl 1000000. Da JSON keine Schreibweise mit Unterstrichen kennt, ist das ein naheliegendes Ergebnis.
Zusammenfassung
[table]wird zu einem verschachtelten Objekt,[[table]]zu einem Array von Objekten, Schlüssel mit Punkt (.) und Inline-Tabellen{ }werden jeweils zu Objekten.- Bei JSON → TOML muss die oberste Ebene ein Objekt sein; wer nur ein Array oder eine Zahl übergibt, erhält einen Fehler.
- Schlüssel mit dem Wert
nullentfallen im Ergebnis komplett, da TOML kein null kennt. - Werte, die wie ein Datum aussehen, bleiben Strings, und Zahlen mit Unterstrichen wie
1_000_000werden zu Zahlen ohne Unterstriche. - Ein manuell übertragenes Ergebnis lässt sich mit einem Standard-Parser wie Pythons
tomllibnoch einmal gegenprüfen.
Einfügen und direkt im Browser in beide Richtungen zwischen TOML und JSON umwandeln. Kostenlos, ohne Installation und Registrierung; Ihre Eingaben werden nicht an einen Server gesendet.
Häufige Fragen
Was wird aus den doppelten eckigen Klammern [[ ]] in TOML in JSON?
Wenn ein [[posts]]-Block mit demselben Namen mehrfach vorkommt, entsteht daraus ein Array von Objekten unter diesem Namen, also "posts": [ { ... }, { ... } ]. Sie müssen nur unterscheiden: Eine einfache Klammer wie in [posts] ergibt ein einzelnes verschachteltes Objekt, doppelte Klammern wie in [[posts]] ergeben ein Array.
Beim Umwandeln von JSON in TOML erscheint eine Fehlermeldung. Woran liegt das?
Das passiert, wenn die oberste Ebene des JSON kein Objekt ist. Besteht die Eingabe aus einem Array wie [1, 2, 3] oder nur aus einer einzelnen Zahl oder Zeichenkette, erscheint die Fehlermeldung „Die oberste Ebene von TOML muss ein Objekt sein“. Eine TOML-Datei besteht insgesamt aus Schlüssel-Wert-Paaren. Wenn Sie die Daten wie in { "items": [1, 2, 3] } einmal in einen Schlüssel einpacken, lässt sich das JSON umwandeln.
Ich habe ein Datum eingegeben, und es erscheint als Zeichenkette in Anführungszeichen.
Das ist normal. Der Konverter behandelt Datum und Uhrzeit vereinfacht als Zeichenkette, daher wird aus 2026-07-17 der Wert "2026-07-17". Der Wert wird dabei weder verändert noch beschädigt, lediglich der Typ bleibt eine Zeichenkette.
Werden meine eingegebenen Einstellungen an einen Server gesendet?
Nein. Alle Umwandlungen laufen direkt in Ihrem Browser ab. Das eingegebene TOML und JSON wird weder an einen Server gesendet noch gespeichert.
Dieser Artikel basiert auf unserem koreanischen Original. Koreanisches Original lesen