YAML prüfen online
Prüfe YAML auf Syntaxfehler und erhalte Zeile und Spalte, an der das Parsen gescheitert ist. Dahinter steckt meist ein Einrückungsfehler und kein Tippfehler.
Browser-Tool
YAML
Füge YAML ein oder lade eine Datei hoch.
Einstellungen
Mehrere durch --- getrennte Dokumente werden zusammen geprüft. Die Auflösung von Aliassen ist auf 100 Verweise pro Dokument begrenzt.
Über YAML prüfen
YAML scheitert auf schwer erkennbare Weise: ein Tabulator, wo Leerzeichen erwartet werden, ein Schlüssel, der ein Leerzeichen zu weit eingerückt ist, ein Doppelpunkt in einem String ohne Anführungszeichen. Der Parser weiß genau, wo er aufgegeben hat, und diese Seite zeigt dir diese Stelle samt Grund, statt nur zu melden, dass die Datei ungültig ist. Sie prüft auch jedes Dokument einer Datei mit mehreren, durch --- getrennten Dokumenten, so wie Kubernetes-Manifeste und CI-Konfigurationen meist geschrieben sind. Kostenlos, online und sofort nutzbar. Dein YAML wird lokal geparst, eine Datei voller Zugangsdaten wird also nie hochgeladen, und ein Konto braucht es nicht.
So nutzt du YAML prüfen
- YAML einfügen oder Datei öffnenEine ganze Konfiguration oder das Stück, das du verdächtigst.
- Die Position lesen, nicht nur die MeldungZeile und Spalte geben an, wo das Parsen gescheitert ist, und das liegt oft ein oder zwei Zeilen unter dem eigentlichen Fehler: Ein zu wenig eingerückter Schlüssel fällt erst auf, wenn der nächste Schlüssel kommt.
- Einen Fehler beheben und erneut prüfenEin einziger Einrückungsfehler kann weiter unten mehrere Fehler auslösen. Behebe den ersten gemeldeten, prüfe erneut, und der Rest verschwindet oft gleich mit.
Die Fehler hinter den meisten kaputten YAML-Dateien
Tabulatoren zum Einrücken sind schlicht verboten („Tabulatoren sind als Einrückung nicht erlaubt“). Ein Wert mit Doppelpunkt und Leerzeichen, etwa title: Note: read this, lässt den Parser glauben, ein zweiter Schlüssel habe begonnen („Verschachtelte Maps sind in kompakten Maps nicht erlaubt“); Anführungszeichen um den Wert beheben das. Ein Schlüssel, der in derselben Map zweimal vorkommt, ist ein Fehler und kein Überschreiben („Schlüssel in einer Map müssen eindeutig sein“). Und eine mit [ oder { geöffnete Flow-Liste oder ein Flow-Objekt, das nie geschlossen wird, wird dort gemeldet, wo dem Parser die Eingabe ausgeht, und das kann weit von der vergessenen Klammer entfernt sein.
Gültig ist nicht dasselbe wie richtig
Manche Fehler ergeben YAML, das sich klaglos parsen lässt. Rück das zweite Element einer Liste ein Leerzeichen weiter ein als das erste, also „- a“ gefolgt von „ - b“, und viele Parser, auch dieser, lesen das als einen einzigen String „a - b“ statt als Liste mit zwei Einträgen. Nichts meldet einen Fehler; die Anwendung bekommt einfach falsche Daten. Wenn eine Datei gültig ist und dein Programm sich trotzdem seltsam verhält, öffne sie im YAML-Betrachter und sieh dir die Struktur an, die der Parser tatsächlich gebaut hat.
Warum fast immer die Einrückung schuld ist
YAML drückt Struktur durch Einrückung aus, Leerraum ist also keine Kosmetik, sondern Syntax. Geschwister-Schlüssel müssen in genau derselben Spalte beginnen, Listeneinträge müssen untereinander bündig sein, und die gewählte Einrückungstiefe muss innerhalb eines Blocks gleich bleiben. Editoren, die Tabulatoren und Leerzeichen mischen oder eingefügten Text neu einrücken, sind die häufigste Ursache für eine Datei, die richtig aussieht und sich nicht parsen lässt.
Was das Tool nicht kann
- Gültiges YAML ist noch keine richtige Konfiguration. Diese Seite bestätigt, dass sich die Datei parsen lässt; ob die Schlüssel die sind, die deine Anwendung erwartet, kann nur diese Anwendung beantworten.
- Wenn ein Dokument viele Tags oder Anker verwendet, kann ein Parse-Fehler an der Stelle der Verwendung gemeldet werden statt an der Definition.
- Der Wortlaut der Fehler stammt vom Parser, den diese Seite verwendet. Andere Werkzeuge wie PyYAML oder Kubernetes beschreiben dasselbe Problem mit anderen Worten, an derselben Stelle.
YAML prüfen: häufige Fragen
- Warum scheitert meine Datei an einer Zeile, die gut aussieht?
- Weil der Fehler dort auftaucht, wo der Parser nicht mehr weiterkam, und das ist meist knapp hinter dem eigentlichen Fehler. Prüfe die Einrückung der Zeilen direkt über der gemeldeten Position.
- Darf ich in YAML Tabulatoren verwenden?
- Nein. Die Spezifikation verbietet Tabulatoren zum Einrücken, und ein Editor, der stillschweigend einen einfügt, ist eine häufige Ursache für eine Datei, die richtig aussieht und sich nicht parsen lässt.
- Was bedeutet „Verschachtelte Maps sind in kompakten Maps nicht erlaubt“ (nested mappings are not allowed in compact mappings)?
- Ein Wert in dieser Zeile enthält einen Doppelpunkt mit folgendem Leerzeichen, deshalb liest der Parser ihn als Anfang eines weiteren Schlüssels. Setz den ganzen Wert in Anführungszeichen, also title: "Note: read this", dann wird er ein einfacher String.
- Darf eine YAML-Datei denselben Schlüssel zweimal enthalten?
- Nicht in derselben Map. Doppelte Schlüssel sind laut YAML-Spezifikation ein Fehler, auch wenn manche älteren Werkzeuge stillschweigend den letzten behalten. Benenne einen davon um oder führe die beiden Blöcke zusammen.
- Kann der YAML-Validator meine Datei reparieren oder neu formatieren?
- Nein, er meldet Probleme und lässt dein YAML genau so, wie es geschrieben ist. Zu jedem Fehler gibt es Zeile und Spalte, damit du ihn selbst beheben kannst, und sobald die Datei die Prüfung besteht, kannst du sie als JSON herunterladen. Um die geparste Struktur neben dem Quelltext durchzusehen, nimm den YAML-Betrachter.
Fragen zu ToolsVerse selbst – Datenschutz, Kosten, was mit deinen Dateien passiert – beantworten die häufig gestellten Fragen.
Ähnliche Tools
Die Tools, die man zusammen mit YAML prüfen am häufigsten braucht.
Du findest das passende Tool nicht?
Sag uns, was du suchst, und wir prüfen, ob wir es hinzufügen.