Beispiel für einen YAML-Einrückungsfehler: Off-by-One-Leerzeichen

Auf dieser Seite wird der YAML-Validator geöffnet, der mit einer kurzen Serverkonfiguration vorinstalliert ist, die einen echten, häufigen Fehler enthält: Nachdem zwei Schlüssel vier Leerzeichen tief verschachtelt sind, fällt ein folgender Schlüssel auf drei Leerzeichen zurück, anstatt auf die Zwei-Leerzeichen-Ebene des umschließenden Blocks zurückzukehren. YAML hat keine Tabulator-/Leerzeichen-Toleranz und keine feste Einzugsbreite, sodass ein einzelnes Leerzeichen wie dieses nicht gemittelt wird – es passt einfach zu keinem offenen Block und die Datei ist ungültig. Die unten aufgeführte Fehlerprüfung wird live ausgeführt, sobald die Seite geladen wird.

Dies ist in der Praxis eine der häufigsten Ursachen für echte YAML-Fehler: die manuelle Bearbeitung einer Datei in einem Editor, der keine konsistente Einzugsgröße erzwingt, oder das Einfügen eines Fragments von einer Stelle mit einem anderen Abstand als der umgebende Block. Im Gegensatz zu einem doppelten Schlüssel oder einem verirrten Tabulator kann ein Verrutschen bei der Einrückung um eins mit bloßem Auge leicht übersehen werden, insbesondere in einem tief verschachtelten Kubernetes-Manifest oder einer CI-Pipeline-Datei – genau aus diesem Grund erkennt er eine automatisierte Prüfung schneller als ein menschlicher Prüfer, der ein Diff scannt.

Ersetzen Sie den Beispieltext durch Ihre eigene Datei, um die gleichen Zeilen- und Spaltenberichte auf Ihre Konfiguration anzuwenden. Wenn Sie das Fehlermuster hier verstanden haben, vergleichen Sie es mit der Voreinstellung yaml-config-example, um die gleiche Struktur mit konsistenter Einrückung zu sehen, die sauber verläuft.