YAML-zu-JSON-Konverter

Den YAML-zu-JSON-Konverter verwenden

1. YAML einfügen in den Eingabebereich. Docker-Compose-Dateien, GitHub-Actions-Workflows, Kubernetes-Manifeste, Ansible-Playbooks und .yml-Konfigurationen aus Rails, Django oder Hugo funktionieren alle.
2. Einen Ausgabe-Stil wählen: 2-stelliges JSON (am häufigsten), 4-stelliges JSON (älterer Python-Stil) oder minimiertes JSON in einer einzigen Zeile (gut zum Weiterleiten in ein anderes Werkzeug).
3. Auf Konvertieren klicken. Gültiges YAML wird zu strukturiertem JSON auf der rechten Seite; fehlerhafter Input erhält eine Fehlermeldung, die auf die fehlerhafte Zeile zeigt.
4. Das JSON kopieren mit der Zwischenablage-Schaltfläche oder es in den Geschwister-JSON-zu-YAML-Konverter einfügen, um es hin-und-herzukonvertieren und zu bestätigen, dass die Semantik beibehalten wurde.

Was es tut und wie es funktioniert

YAML ist durch Einrückung blockstrukturiert, was einen einfachen Parser aufwendiger macht, als es aussieht. Der Konverter tokenisiert Zeilen in eine von vier Kategorien: Block-Sequenz-Elemente (beginnend mit - ), Block-Mapping-Einträge (ein Schlüssel gefolgt von :), Skalar-Fortsetzungen und strukturelle Marker (---, ...). Einrückung wird mit einem Stapel von Spaltenoffsets verfolgt, sodass verschachtelte Sequenzen in Mappings und Mappings in Sequenzen korrekt geschachtelt werden. Skalare Werte werden klassifiziert: nicht gequotete Token, die der YAML-Zahlengrammatik entsprechen, werden zu JSON-Zahlen; die literalen Token true, false und null werden zu den JSON-Äquivalenten; und alles andere bleibt als JSON-String.

Sobald die Eingabe in ein JavaScript-Objekt geparst wurde, übernimmt JSON.stringify die Ausgabeformatierung mit dem von dir gewählten Einzug. Gequotete Strings in der Quelle (einfach oder doppelt) werden immer als Strings behandelt, unabhängig vom Inhalt, was so ist, wie du numerisch aussehende Strings wie Postleitzahlen oder Versionsnummern bewahrst. Flow-Stil-Sammlungen ({ key: value } und [ a, b ]) werden neben dem Block-Stil behandelt. Gefaltete und Literal-Block-Skalare (> und |) falten oder bewahren Zeilenwechsel gemäß YAML 1.2.

Echte Anwendungsfälle

• Ein Kubernetes-Manifest in ein Werkzeug kopieren, das nur JSON-API-Payloads akzeptiert, wie curl gegen /api/v1/namespaces.
• Einen CI-Workflow debuggen, indem .github/workflows/ci.yml zu JSON konvertiert und in einem JSON-Pfad-Explorer betrachtet wird.
• Eine Konfigurationsdatei in einen JSON-Schema-Validator einspeisen, der kein YAML nativ unterstützt.
• Den Unterschied zwischen YAML-Tag-Inferenz und expliziter Typisierung lehren, indem gesehen wird, welche JSON-Typen herauskommen.
• Ein kleines Konfigurationsschnipsel in JavaScript-Code einbetten, der JSON.parse für Portabilität verwendet.
• Ein Helm-Chart oder Terraform override.yml auf versteckte doppelte Schlüssel prüfen, die JSON verbietet, aber einige YAML-Parser still akzeptieren.

Grenzfälle und Fallstricke

• Das Norwegen-Problem. YAML 1.1 parste berüchtigterweise ungequotetes no als boolesches false, was dazu führte, dass der Ländercode "NO" "deaktiviert" bedeutete. YAML 1.2 entfernte diese Aliase, aber viele Parser sind noch im 1.1-Modus. Dieser Konverter folgt YAML 1.2: nur true, false, True, False, TRUE und FALSE sind boolesche Werte.
• Tabulatoren sind für Einrückung illegal. YAML 1.2 schreibt Leerzeichen vor. Ein versteckter Tabulator erzeugt entweder einen Fehler oder verschachtelt deinen Baum still falsch. Tabulatoren in Leerzeichen konvertieren, bevor sie eingefügt werden, wenn dein Editor sie eingefügt hat.
• Multi-Dokument-Dateien. YAML kann mehrere durch --- getrennte Dokumente enthalten. Der Konverter verwendet nur das erste Dokument; um alle zu konvertieren, sie manuell in ein JSON-Array einwickeln.
• Anker und Referenzen. &anker und *ref sind grundlegende YAML-Funktionen, die dieser leichtgewichtige Parser je nach Komplexität möglicherweise abflacht oder verwirft. Sehr enge Helm-Templates, die auf Ankern beruhen, sollten zuerst vollständig gerendert werden.
• Schlüssel mit Null-Wert. foo: mit nichts nach dem Doppelpunkt ist ein Schlüssel, der auf Null gemappt wird, was durch JSON als "foo": null hin-und-herwandert. Einige Verbraucher erwarten stattdessen, dass der Schlüssel fehlt - beide prüfen.

YAML 1.2 Spezifikation im Überblick

YAML ist definiert unter yaml.org/spec/1.2.2. Das wichtigste Designziel ist, dass jedes gültige JSON-Dokument auch gültiges YAML ist, sodass YAML eine echte Obermenge ist. Die Ergänzungen, die YAML mitbringt, sind Block-Einrückung, Kommentare (#), Anker und Aliase, explizite Tags (!!str, !!int) und gefaltete/literale mehrzeilige Strings. Die 1.2-Revision verfeinerte die Typ-Inferenz, um das YAML-1.1-Booleans-überall-Problem zu vermeiden, und machte JSON ausdrücklich zu einer Untermenge. Die YAML-Test-Matrix verfolgt, wie verschiedene Parser mit dem Standard umgehen; insbesondere standardmäßig Python's PyYAML im YAML-1.1-Modus und go-yaml v2 hatte Grenzfälle, die v3 behoben hat.

Wann ein anderes Werkzeug verwendet werden soll

Für Produktionskonvertierungen yq (Go- oder Python-Editionen) auf der Befehlszeile verwenden; es behandelt Anker, Merges (<<:) und Multi-Dokument-Dateien in voller Spec-Konformität. yq eval -o=json file.yml ist ein einzeiliges Äquivalent. In JavaScript ist die Bibliothek js-yaml der de-facto-Parser und unterstützt sowohl 1.1- als auch 1.2-Modus. Python hat ruamel.yaml, das Kommentare und Reihenfolge besser bewahrt als PyYAML. Dieses Web-Werkzeug ist schneller als alle davon für schnelle Spot-Konvertierungen, besonders auf einem Laptop ohne Node oder Python bei der Hand, aber es als Betrachter statt als kanonischen Konverter für geschäftskritische Konfigurationen behandeln.