YAML in JSON umwandeln: Regeln, Fehlerquellen, Prüfung

Inhalt
Konfigurationsdateien werden häufig in YAML geschrieben. Die Struktur ergibt sich allein aus der Einrückung, und Kommentare sind frei möglich – für Menschen ist YAML deshalb deutlich angenehmer zu lesen und zu bearbeiten. Doch sobald Sie die Werte in JavaScript-Code verwenden oder direkt in einen API-Request-Body einfügen wollen, merken Sie: YAML lässt sich dort nicht einfach so verwenden.
Zusammenfassung ① YAML lässt sich für Menschen gut lesen und schreiben, aber JavaScript-Objekte und API-Request-Bodys erwarten das JSON-Format ② Wenn Sie die Regeln kennen, mit denen sich eine einrückungsbasierte Struktur in eine Struktur mit geschweiften und eckigen Klammern überträgt, können Sie auch von Hand umwandeln ③ Bei tief verschachteltem YAML oder gemischten Listen passieren bei der manuellen Umwandlung oft Fehler, daher sollten Sie das Ergebnis immer visuell prüfen
Warum YAML-Konfigurationen im Code nicht funktionieren
YAML bildet Hierarchien über Einrückungen ab und schreibt den Wert hinter einen Doppelpunkt – das ist für Menschen gut lesbar. Auch Kommentare (#) sind jederzeit möglich, weshalb YAML als Format für Konfigurationsdateien weit verbreitet ist.
Das Problem: Stellen wie JSON.parse in JavaScript oder der Body einer fetch-Anfrage verstehen die YAML-Syntax nicht. Diese Funktionen interpretieren ausschließlich JSON-Syntax, also geschweifte Klammern, eckige Klammern und in doppelte Anführungszeichen gesetzte Schlüssel.
Wenn Sie also Werte aus einer Konfigurationsdatei unverändert in eine Test-Anfrage an eine API einfügen oder als Konstante in Frontend-Code übernehmen wollen, kommt es zu einem Syntaxfehler. Das YAML selbst ist syntaktisch einwandfrei, an einer Stelle, die JSON erwartet, führt es trotzdem zu einem Fehler.
So gehen Sie vor: Umwandlungsregeln und Überprüfung
Für die manuelle Umwandlung gelten drei Regeln. Erstens: key: value wird in doppelte Anführungszeichen gesetzt. Zweitens: Untergeordnete Einträge, die per Einrückung dargestellt sind, werden in geschweifte Klammern gefasst. Drittens: Listeneinträge mit vorangestelltem Strich werden zu einem Array in eckigen Klammern.
| YAML-Schreibweise | JSON-Schreibweise |
|---|---|
| host: localhost | Schlüssel und Wert in doppelten Anführungszeichen |
| Untergeordnete Einträge per Einrückung | In geschweifte Klammern fassen |
| Listeneintrag am Zeilenanfang | In ein Array mit eckigen Klammern umwandeln |
| true, false, null, Zahlen | Unverändert und ohne Anführungszeichen belassen |
Die Regeln sind einfach, doch sobald die Hierarchie mehr als zwei, drei Ebenen umfasst, ist es mühsam, die Klammerpaare von Hand korrekt zu setzen. Enthält eine Liste wiederum Objekte, überlagern sich die Klammern, und Fehler passieren noch leichter.
Mit unserem Tool prüfen. Fügen Sie Ihr YAML in das Eingabefeld ein, und unten erscheint sofort das JSON-Ergebnis. Als Einrückung können Sie 2 Leerzeichen, 4 Leerzeichen oder eine einzelne Zeile (komprimiert) wählen und das Ergebnis direkt kopieren und in Ihren Code einfügen.
Kostenlos · ohne Anmeldung · JSON-Umwandlung direkt im Browser

Typische Stolperstellen
| Situation | Warum es hakt |
|---|---|
| Struktur mit Objekten innerhalb einer Liste | Geschweifte Klammern innerhalb eckiger Klammern überlagern sich, die Paare sind von Hand schwer zuzuordnen |
| Doppelpunkt oder Anführungszeichen in Zeichenketten | Ohne Escaping kommt es zu einem Syntaxfehler |
| Einrückung mit gemischten Tabs und Leerzeichen | Die Hierarchie wird anders interpretiert, und es entsteht eine falsche Struktur |
| Komma nach dem letzten Eintrag | JSON erlaubt kein Komma nach dem letzten Eintrag |
Die in der Tabelle genannten Fälle fallen beim bloßen Überfliegen kaum auf; erst wenn tatsächlich geparst wird, zeigt sich die Fehlerstelle. Nach der Umwandlung sollten Sie sich daher angewöhnen, einmal zu prüfen, ob die Struktur mit dem Original übereinstimmt.
Fazit
YAML ist ein Format, das sich für Menschen gut lesen und bearbeiten lässt, JSON dagegen das Format, das Code und APIs verstehen. Wenn Sie Doppelpunkte durch Anführungszeichen, Einrückungen durch geschweifte Klammern und Listen durch eckige Klammern ersetzen, können Sie auch von Hand umwandeln.
Wird die Hierarchie jedoch tiefer oder mischen sich Listen und Objekte, passieren beim Setzen der Klammerpaare leicht Fehler. Dann geht es schneller, ein Tool zu verwenden, mit dem Sie das Ergebnis der Umwandlung direkt prüfen können.
Kostenlos · ohne Anmeldung · JSON-Umwandlung direkt im Browser
Häufig gestellte Fragen
Lässt sich die gesamte YAML-Syntax in JSON umwandeln?
Strukturen, die in Konfigurationsdateien üblich sind – Schlüssel-Wert-Paare, verschachtelte Maps und Listen –, lassen sich unverändert in JSON übertragen. Für YAML-spezifische Syntax wie Anker und Aliase gibt es in JSON jedoch kein Gegenstück, daher müssen Sie die Werte zuerst auflösen und erst dann umwandeln.
Kann ich das umgewandelte JSON direkt als API-Request-Body verwenden?
Wenn daraus eine Standard-JSON-Struktur geworden ist, können Sie es direkt als Body einer fetch- oder axios-Anfrage einsetzen. Ob die von der API erwarteten Feldnamen und Werttypen mit den Schlüsseln im ursprünglichen YAML übereinstimmen, müssen Sie allerdings separat prüfen.
Soll ich als Einrückung 2 oder 4 Leerzeichen wählen?
Die geparsten Daten selbst sind unabhängig von der Einrücktiefe identisch. Wenn Sie das Ergebnis in eine Codebasis einfügen, an der mehrere Personen arbeiten, passen Sie die Einrückung an die des Projekts an. Bei Stellen, an denen Leerraum keine Rolle spielt, etwa im API-Request-Body, ist die einzeilige (komprimierte) Option praktischer.
Dieser Artikel basiert auf unserem koreanischen Original. Koreanisches Original lesen