Das erste Mal, dass YAML mich richtig verbrannte, war es ein Ländercode. Ich habe eine Gebietsschemakonfiguration aus einem Laravel-Projekt in ein deploymentfreundliches YAML-Format verschoben, das von Hand umgewandelt wurde, weil "es nur die Klammern in die Einrückung umwandelt." Einer der Einträge war Norwegen: "country": "NO"drohen In YAML ist dies keine Zeichenfolge - nach den YAML 1.1-Regeln, die Pyyaml und viele andere Parser noch anwenden, NO ist der Boolesche falsedrohen Das in Python geschriebene Deploy-Skript, das norwegische Benutzer fröhlich als country: false und routen sie zum Fallback-Gebietsschema. Dieser Fehler hat einen Namen - die Community nennt es das Norwegen-Problem - und ich muss ihn auf handwerkliche Weise entdecken, ein verwirrtes Support-Ticket für einmal.
Das Hand-Konvertieren von JSON in YAML sieht trivial aus und ist eigentlich ein Minenfeld, da die beiden Formate sehr unterschiedliche Vorstellungen darüber haben, was ein bloßes Wort bedeutet. In JSON ist alles explizit: Zeichenfolgen haben Anführungszeichen, Zahlen nicht, true/false/null sind Schlüsselwörter, Ende der Geschichte. In YAML wird ein nicht zitierter Skalar gedeutet: no wird falsch, 3000 wird eine ganze Zahl, 1.10 wird der Schwimmer 1.1 (Auf Wiedersehen, Versionszeichenfolge), 08 Würgt einige Parser als ungültiges Oktal, und ein Wert mit einem verstreuten Doppelpunkt wird zu einer verschachtelten Karte, wenn Sie es am wenigsten erwarten. Jedes dieser Daten ist eine stille Datenbeschädigung - die Datei analysiert gut, die Typen sind einfach falsch.
ein JSON-zu-YAML-Konverter Das versteht, dass diese Regeln Sie die Lesbarkeit erhalten, für die YAML ohne das Typ Roulette erfunden wurde. Die, die ich für toolz.dev erstellt habe, erkennt jeden mehrdeutigen Skalar - boolesche Look-Alikes, Zahlen-Look-Alikes, YAML 1.1-Legacy-Werte, Zeichenfolgen mit Sonderzeichen - und zitiert genau diese. Was eine Zeichenfolge in Ihrem JSON war, ist immer noch eine Zeichenfolge, nachdem das nächste Tool das YAML analysiert hat. Das "genau diese" zählt: alles wäre auch sicher, aber der Ausgang sieht nicht mehr wie idiomatisches YAML aus, und idiomatisch ist der springende Punkt.
In diesem Handbuch wird beschrieben, wie die Konvertierung mit den scharfen Kanten von Yaml umgeht, warum JSON technisch bereits YAML ist (und warum Ihnen diese Tatsache nicht hilft), und die Kubernetes, CI und Docker-Workflows, in denen diese Konvertierung wöchentlich erfolgt.
tl; dr: Fügen Sie JSON in die toolz.dev JSON zu YAML-Konverter, 2- oder 4-fach Einbuchtung auswählen und saubere Block-Yaml mit typsicherem Zitat erhalten —
"3000"bleibt eine Schnur,"no"bleibt eine Schnur,"1.10"Bleibt eine Version. Die Schlüsselreihenfolge bleibt erhalten, leere Sammlungen kommen als heraus[]und{}, und alles läuft clientseitig, so dass Konfigurationen mit Geheimnissen niemals Ihren Browser verlassen. Rückfahrt mit dem YAML-Validator, und formatieren Sie zuerst die Quelle mit dem JSON-Formaterdrohen
Ist JSON nicht bereits gültig?
Ja – und das ist das nutzloseste „Ja“ im Konfigurationsmanagement. YAML 1.2 wurde explizit als Superset von JSON entworfen: Jedes gültige JSON-Dokument analysiert als gültiges YAML. Sie könnten RAW JSON in ein Kubernetes-Manifest einfügen und kubectl würde es akzeptieren.
Niemand tut dies, denn der Grund, warum YAML existiert menschliche Ergonomiedrohen Kubernetes-Manifeste, GitHub-Aktions-Workflows, Docker-Compose-Dateien, Ansible-Playbooks, Home-Assistent-Konfigurationen – Dies sind YAML-Web, weil die Leute sie ständig lesen und von Hand bearbeiten, und replicas: 3 Unter einem eingerückten Block scannt besser als {"replicas":3} in Zahnspangen eingebettet. Wenn jemand "JSON in YAML umwandeln" sagt, meinen Blockstil YAML: Einbuchtung statt Zahnspange, - Striche anstelle von Arrays in Klammern, keine Anführungszeichen, bei denen keine benötigt werden.
In dieser letzten Klausel lebt die Schwierigkeit. Von JSONs Everything-Explicit-Syntax zu Yams minimaler Syntax bedeutet Entscheiden Sie für jede Zeichenfolge, ob sie ihre Anführungszeichen sicher verlieren kann - Und diese Entscheidung erfordert, dass Yamams Skalarauflösung besser weiß, als die meisten Menschen an einem Freitag um 17 Uhr zuverlässig sind. Das ist die eigentliche Aufgabe eines Konverters; der Teil der Zahnspange ist trivial.
Was bricht still, wenn Sie von Hand umwandeln?
Die Fehlerfälle fallen in vier Familien, und ich habe jeden von ihnen in echten Konfigurationen getroffen:
Boolesche Look-Alikes. YAML 1.1 wird behoben yes, no, on, off, y, n (in verschiedenen Gehäusen) als Boolesche und YAML 1.2 true/falsedrohen PyYaml — In den meisten Python-Codebasen immer noch die Standard-YAML-Bibliothek – implementiert 1.1. so "debug": "no" handverstellt zu debug: no wird debug: false in Ihrem Python-Bereitstellungstool. Das Norwegen-Problem (NO → false) und sein Cousin das Ontario-Problem (ON → true) sind die größten Hits dieser Familie.
Nummern-Alikes. "port": "3000" umgerechnet auf port: 3000 ist jetzt eine ganze Zahl. Kubernetes kümmert sich in einigen Bereichen nicht und in anderen Fällen nicht - env var-Werte müssen beispielsweise Zeichenfolgen sein, und kubectl apply wird dort eine Ganzzahl mit einem Fehler ablehnen, der das Feld benennt, aber nicht die wiesodrohen Versionszeichenfolgen sind schlimmer, weil nichts fehlschlägt: version: 1.10 Analysiert als der Float 1.1, und Ihr Deploy-Skript meldet gerne für immer die falsche Version. Führende Nullen — Postleitzahlen, Telefonnummern, Oktal aussehende IDs wie 0755 - Runden Sie die Familie ab.
Sonderzeichen. Ein Doppelpunkt, gefolgt von einem Leerzeichen in einem nicht zitierten Wert, startet eine Zuordnung (message: error: not found ist ein Parse-Fehler oder eine verschachtelte Karte, Parser abhängig). ein # Startet einen Kommentar mittiger Wert. führend *, &, ! kollidieren Sie mit Yams Anchor, Alias und Tag-Syntax. Zeichenfolgen mit Newlines müssen entkommen oder blockiert werden.
die leere Zeichenfolge. Nicht zitierte Leere in YAML ist null, nicht ""drohen Jedes JSON-Feld, das eine leere Zeichenfolge enthält, muss zitiert herauskommen oder es ändert sich den Typ.
der Konverter Überprüft jede Zeichenfolge gegen alle vier Familien und zitiert die, die sie benötigen - und nur diese. production kommt kahl heraus, weil es eindeutig ist; "3000", "no", "1.10", und "" Kommen Sie zitiert, weil sie es nicht sind. Es gibt auch ein "Zitat Alle Zeichenfolgen" umzuschalten, wenn Sie einen Parser füttern, dem Sie nicht vertrauen und der überhaupt keine skalare Auflösung finden soll.
Wie konvertiert man JSON mit dem Tool in YAML?
Schritt 1: Füge deinen JSON ein
Alle gültigen JSON-Werke - Objekte, Arrays, tiefes Verschachtelen, Unicode. Die Schaltfläche Beispiel laden bietet eine realistische Servicekonfiguration, die die interessanten Fälle ausübt: einen numerischen Zeichenfolgenport, einen Booleschen Wert, ein leeres Array, verschachtelte Karten. Wenn Ihr Eingang Syntaxprobleme hat, meldet der Konverter den genauen Fehler des Parsers, anstatt ein abgeschnittenes Dokument zu konvertieren; wohin Der Fehler ist in einem großen Blob, der JSON-Formater ist das bessere Mikroskop.
Schritt 2: Einzug wählen
zwei Räume oder vier. Zwei ist die überwältigende Konvention - Kubernetes-Dokumente, GitHub-Aktionen, Docker-Verweise und die yamllint Standardwerte verwenden alle es - aber einige Teams standardisieren auf vier, um die Lesbarkeit bei der tiefen Verschachtelung zu erreichen. Unabhängig davon, was Sie auswählen, ist der Konverter konsistent, einschließlich des subtilen Falles von Listenelementen unter einem Schlüssel, bei dem inkonsistente Handeinzug eine klassische Quelle für "Mapping-Werte" ist, die hier nicht zulässig sind.
Schritt 3: Konvertieren und überprüfen
Die Ausgabe erscheint mit Zeilen- und Byte-Zählungen. Überfliegen Sie es einmal - nicht aus Gründen der Richtigkeit (das ist der Job des Konverters), sondern die zitierten Entscheidungen anhand Ihrer Erwartungen. Sehen PORT: "3000" Während zitiert NODE_ENV: production ist das Werkzeug, das Ihnen sagt, welche Werte gefährlich waren.
Schritt 4: Kopieren oder herunterladen
In die Zwischenablage zum Einfügen in ein vorhandenes Manifest kopieren oder als Download als .yaml Akte Die Ausgabe verwendet nur Leerzeichen — YAML verbietet Registerkarten für Einrückungen, was zu wissen ist, wenn Sie die Datei später in einem für Tab-Einrückung konfigurierten Editor bearbeiten.
JSON vs YAML: Wann gewinnt jedes Format?
| json | Zank | |
|---|---|---|
| gelesen / bearbeitet von | Maschinen, APIs | Menschen, Ops-Teams |
| Kommentar | Nicht in der Spezifikation | # Kommentare — Die Killer-Funktion für Konfigurationen |
| Typ Explizitität | Total - Zitate entscheiden alles | Skalare Auflösung – Kontext entscheidet |
| Mehrzeilige Zeichenfolgen | \n entkommt nur |
Blockskalare (` |
| Parse Speed & Ampere | Am schnellsten, überall | langsamere, schwerere Parser |
| Fußwerk | Nachkomma, das ist es | Norwegen Problem, Tabs, Einzugsdrift, Versionsabbrüche |
| Natürlicher Lebensraum | API-Nutzlasten, package.json, Datenaustausch |
Kubernetes, CI-Pipelines, komponieren, Ansible |
Das Muster hinter der Tabelle: JSON gewinnt, wo immer eine Maschine schreibt und eine Maschine liest, YAML gewinnt, wo immer eine Maschine liest, aber a Mensch schreibt. Die Konfiguration liegt genau in der zweiten Kategorie, weshalb die JSON-zu-Yaml-Richtung die übliche ist - Daten beginnen das Leben in einer API oder einem Datenbankexport und müssen etwas werden, das ein Ops-Team aufrechterhalten kann. Die Rückwärtsfahrt, YAML zurück zu maschinenlesbarem JSON, ist das, was die YAML-Validator Handles — Füge YAML ein, rufe die Validierung plus die entsprechende JSON ab.
Was sind die alltäglichen Workflows für diese Konvertierung?
Kubernetes-Manifeste aus der API-Ausgabe
kubectl get deployment my-app -o json Gibt JSON; das Manifest, das Sie in git einchecken, ist YAML. Konvertierung von API-Antworten in sauberes YAML ist der schnellste Weg, um ein Manifest von einer Live-Ressource zu booten. Konvertieren, entfernen Sie den Server-Bestückten status und metadata.managedFields blockiert, und Sie haben einen deklarativen Ausgangspunkt. Das typsichere Zitat verdient hier seinen Weg: ENV-Werte in Kubernetes müssen Seien Sie Strings und der Konverter besteht darauf, zu zitieren "3000" ist der Unterschied zwischen kubectl apply Erfolg und scheitern.
CI-Pipeline-
GitHub-Aktionen und GitLab CI sind nur YAML-Aktionen. Wenn ich programmgesteuert Workflow-Schritte generiere - eine Matrix aus PHP- und Knotenversionen zum Testen von WP, die beispielsweise gegen administrieren - erzeugt der Generator natürlich JSON, und der letzte Schritt ist die Konvertierung. Versionszeichenfolgen in Testmatrizen sind genau die Werte, die durch naive Konvertierung verstümmelt werden: eine Matrix von ["1.9", "1.10", "1.11"] Hand-umgewandelt ohne Anführungstests gegen PHP 1.1 zweimal der Sammlung von Codierungstools Deckt mehr von diesem Generierung-Dann-Konvertierungsmuster ab.
Docker Componieren von Inspect Output
docker inspect emittiert JSON; docker-compose.yml will Yaml. Das Reverse-Engineering einer Compose-Datei aus einem laufenden Container — Ports, Volumes, env — ist ein Convert-and-Prune-Job. Leere Arrays und Objekte konvertieren in [] und {} Flow-Syntax, die akzeptiert und die Schnittphase lesbar hält.
Konfiguration überprüfbar machen
Dieser wird unterschätzt: JSON-Konfigurationen mit Dutzenden verschachtelten Schlüsseln sind bei der Code-Überprüfung miserabel, auch weil sie keine Kommentare übertragen können. Konvertierung in YAML ermöglicht es Ihnen, Anmerkungen zu machen wieso rateLimit ist 250 direkt neben dem Wert. Für die Überprüfung selbst, Paaren der Konvertierung mit a Strukturunterschied von vor / nach JSON hält die "Was tatsächlich geändert" -Frage ehrlich, während die YAML-Version das "Warum" behandelt.
OpenAPI- und Schemadokumente
OpenAPI-Spezifikationen werden häufig in YAML erstellt, aber als JSON generiert und dienen. Das Konvertieren einer generierten Spezifikation in YAML für die menschliche Bearbeitung - dann die Validierung der Rundreise - ist ein Standard-API-Team-Workflow, und die Wiedergabetreue (Schlüsselreihenfolge beibehalten, Typen zitiert) bedeutet, dass die YAML-Version gegen ihren JSON-Vorfahren diffus bleiben kann.
Warum ist die Erhaltung der Schlüsselauftragserscheinungen wichtig?
Gemäß der JSON-Spezifikation hat die Objektschlüsselreihenfolge keine Bedeutung — {"a":1,"b":2} und {"b":2,"a":1} sind das gleiche Objekt. Ein Konverter könnte also die Tasten alphabetisch sortieren und technisch korrekt sein. Es wäre auch praktisch feindselig, weil Konfigurationsdateien lesen In der Reihenfolge: Eine Kubernetes-Bereitstellung liest sich natürlich als apiVersion, kind, metadata, spec - Das alphabetische Sortieren erzeugt ein Manifest, das identisch analysiert und wie eine Lösegeldnote gelesen wird.
Der Konverter gibt Schlüssel in der Quellenreihenfolge aus. Ihr mentales Modell des Dokuments überlebt die Konvertierung, der YAML unterscheidet sich sauber von früheren Konvertierungen derselben Quelle und konventioneller Reihenfolge (Name vor Wert, apiVersion Ersten) bleiben konventionell. Wenn du Bedürf Kanonische Bestellung zu Vergleichszwecken, das ist ein unterschiedliches Anliegen - das JSON Diff Checker Vergleicht nach Schlüssel unabhängig von der Reihenfolge, was die richtige Ebene für dieses Problem ist.
Ist es sicher, Konfigurationen mit Geheimnissen zu konvertieren?
Die Konfiguration ist der heimlichste Text, den ein Entwickler verarbeitet – Datenbank-URLs mit eingebetteten Kennwörtern, API-Token in Env-Blöcken, interne Hostnamen, die Ihre Infrastruktur abbilden. Es ist auch genau das, was die Leute in Online-Konverter einfügen, normalerweise in der Mitte der Bereitstellung, normalerweise in Eile.
der toolz.dev-Konverter Läuft vollständig in Ihrem Browser: Parsen, Skalaranalyse, Serialisierung - alles ist clientseitiges Javascript, keine Netzwerkanforderung enthält Ihre Daten und das Tool arbeitet weiterhin mit Ihrem Verbindungsausschnitt. Das ist eine Architektur-Fakt, kein Versprechen der Privatsphäre. Die Browser-First-Design-Philosophie hinter der gesamten Toolbox ist in der Leitfaden für Webentwickler-Toolkit; Dieses Tool ist die Philosophie, die auf den sensiblesten Dokumenttyp in Ihrem Workflow angewendet wird.
Die offensichtliche Einschränkung steht: Clientseitige Umwandlung schützt die Umwandlungdrohen Wo Sie die Ausgabe danach einfügen, ist ihre eigene Sicherheitsentscheidung.
FAQ
Wie konvertiere ich JSON online in YAML?
Fügen Sie Ihren JSON in die ein JSON-zu-YAML-Konverter, Wählen Sie 2- oder 4-Space-Einrückung und klicken Sie auf Konvertieren. Sie erhalten block-style YAML mit typsicheren Zitaten, die als .yaml-Datei kopieren oder herunterladen können. Die Konvertierung läuft komplett in Ihrem Browser – nichts wird hochgeladen.
Ist JSON bereits gültig YAML?
Technisch ja - YAML 1.2 ist eine Obermenge von JSON, daher analysiert jedes gültige JSON-Dokument als YAML. Aber JSON Syntax besiegt Yamams Lesbarkeitszweck. Durch die Konvertierung wird YAML im Blockstil mit Einrückung anstelle von Klammern erzeugt. Dies ist das, was Kubernetes Manifestiert, CI-Workflows und Compose-Dateien erwarten, dass Menschen lesen und bearbeiten.
Was ist das Norwegen-Problem in YAML?
Unter YAML 1.1 Skalarregeln, die Parser wie Pyyaml weiterhin anwenden, werden die nicht zitierten Werte nein, ja, ein und aus als boolesche Werte - so wird der Ländercode NO stillschweigend falsch. Der Konverter verhindert dies, indem er automatisch eine beliebige Zeichenfolge angibt, die ein YAML-Parser als Boolesches Wert, Zahl oder NULL interpretieren kann.
Bleiben numerische Zeichenfolgen wie "3000" nach der Konvertierung strings?
Ja. Der Konverter erkennt Strings, die wie Zahlen aussehen, und zitiert sie in der Ausgabe, so dass "3000" eine Zeichenfolge bleibt, anstatt die ganze Zahl 3000 zu werden. Dies ist wichtig für Ports, Versionsnummern wie "1.10" (die sonst an den Float 1.1 abschneiden würden), Postleitzahlen und IDs mit führenden Nullen.
Behält der Konverter die Reihenfolge meiner JSON-Schlüssel bei?
Ja. Schlüssel werden in der Reihenfolge ausgegeben, in der sie in der Quelle JSON angezeigt werden. Das Sortieren von Schlüsseln wäre technisch gültig - die JSON-Objektreihenfolge hat keine Bedeutung pro RFC 8259 -, aber die Quellenreihenfolge hält die Konfigurationen in ihrer herkömmlichen Struktur lesbar und hält den YAML gegen seine JSON-Quelle diffus.
Kann ich die Ausgabe direkt in Kubernetes oder Docker Compose verwenden?
Ja. Die Ausgabe ist standardmäßig mit Leerzeichen eingerückten YAML-Stil (Niemals Tabs), die Kubectl, Docker Compose, GitHub-Aktionen und GitLab CI akzeptieren. Werte, die Strings sein müssen - wie Kubernetes env var Werte - werden zitiert, um die Typfehler zu vermeiden, die kubectl bei nicht zitierten Zahlen auslöst.
Wie konvertiere ich YAML zurück in JSON?
Verwenden Sie die YAML-Validator Auf toolz.dev — Es analysiert Ihre YAML, meldet alle Syntaxfehler und gibt das entsprechende JSON aus. Zusammen mit dem JSON to YAML-Konverter bietet es Ihnen eine vollständige Rundreise zwischen den beiden Formaten.
Ist es sicher, Konfigurationsdateien zu konvertieren, die Geheimnisse enthalten?
Ja. Die Konvertierung läuft vollständig in JavaScript in Ihrem Browser – keine Netzwerkanforderung enthält Ihre Daten, nichts wird gespeichert oder protokolliert und das Tool funktioniert offline. Konfigurationen mit Datenbankanmeldeinformationen, API-Token oder internen Hostnamen verlassen niemals Ihren Computer.
Die Lesbarkeit von Yaml ist real, ebenso wie die scharfen Kanten - das Format löst Typen aus dem Kontext auf, und der Kontext ist genau das, was Handkonvertierung falsch macht. Ein Konverter, der die skalaren Regeln kennt, gibt Ihnen die lesbare Konfiguration ohne die stille Beschädigung des Typs: Konvertieren Sie Ihren JSON, überfliegen Sie die von ihm gewählten Zitate und versenden Sie ein Manifest, in dem Norwegen noch ein Land ist.
