Walidator i formater YAML

Wklej YAML, aby sprawdzić składnię, wskazać błędy i otrzymać czysty, spójnie sformatowany wynik.

Opcje wyniku

YAMLwejście

Pusto

YAMLwynik

Tutaj pojawi się wynik YAML

Działa w całości w przeglądarce: nic nie jest przesyłane. Obowiązują limity uczciwego użytkowania (5 MB na dane wejściowe, ograniczona liczba konwersji), aby zapobiegać spamowi i botom.

Wczytaj z adresu URL

Plik jest pobierany bezpośrednio przez przeglądarkę, więc serwer musi zezwalać na żądania cross-origin.

Skróty klawiszowe

Ctrl / ⌘ + Enter Konwertuj teraz
Ctrl / ⌘ + S Pobierz wynik
Alt + Shift + C Kopiuj wynik
Alt + Shift + F Napraw i sformatuj wejściowy JSON
Alt + Shift + S Zamień kierunek
Alt + Shift + T Przełączaj widoki: kod, drzewo i mapa
Ctrl / ⌘ + Z Cofnij, także po użyciu Formatuj, Napraw i Wyczyść
Esc Wyjdź z pełnego ekranu
Rozmiar tekstu w edytorze

Uporządkuj chaotyczny YAML

Mieszane wcięcia, mapy w jednym wierszu i zbędne cudzysłowy parsują się poprawnie, ale utrudniają przegląd. Sformatowany wynik nadaje każdemu plikowi ten sam kształt.

Wejście
services:
    web:
        image: "nginx:1.27"
        ports: [ "80:80" ]
        environment: {LOG_LEVEL: info, DEBUG: 'false'}
Sformatowany
services:
  web:
    image: nginx:1.27
    ports:
      - '80:80'
    environment:
      LOG_LEVEL: info
      DEBUG: 'false'

Typowe błędy YAML i jak je naprawić

To komunikaty, które zobaczysz najczęściej, w tym walidatorze i w narzędziach takich jak kubectl, Helm i docker compose.

Komunikat błęduCo oznacza i jak go naprawić
tab characters must not be used in indentation YAML dopuszcza we wcięciach tylko spacje. Zastąp każdy tabulator spacjami.
bad indentation of a mapping entry Klucz ma inne wcięcie niż sąsiednie klucze albo zwykła wartość zawiera ": ". Wyrównaj klucz z sąsiednimi albo ujmij wartość w cudzysłowy.
mapping values are not allowed in this context Ten sam problem w wersji zgłaszanej przez kubectl i Helm: zwykle wartość bez cudzysłowu zawierająca ": ", na przykład URL lub godzina. Ujmij wartość w cudzysłowy.
end of the stream or a document separator is expected Element listy lub klucz znajduje się na złym poziomie wcięcia, na przykład lista, po której następuje mapowanie na tym samym poziomie.
unexpected end of the stream within a flow collection Lista w jednym wierszu [ … ] lub mapa { … } nie zostaje zamknięta. Dodaj brakujący nawias.
duplicated mapping key Ten sam klucz występuje dwa razy w jednym mapowaniu. Usuń jeden z nich albo zmień jego nazwę.
unidentified alias Alias taki jak *defaults jest użyty przed swoją kotwicą &defaults albo bez niej.

Co sprawdza walidator

Celowo zepsuj plik przyciskami i zobacz, które sprawdzenie to wykryje.

Składnia i wcięcia

Tabulatory, źle wyrównane klucze, niezamknięte cudzysłowy i nawiasy są zgłaszane z dokładnym wierszem i kolumną.

Zduplikowane klucze

Klucz zdefiniowany dwa razy w tym samym mapowaniu to błąd, choć niektóre parsery po cichu zachowują ostatnią wartość.

Kotwice i aliasy

Każdy alias musi wskazywać na kotwicę zdefiniowaną wcześniej w dokumencie, a klucze scalania muszą odwoływać się do mapowań.

Wiele dokumentów

Każdy dokument w pliku rozdzielonym przez --- jest parsowany, a notatki pokazują, ile ich znaleziono.

Prywatnie z założenia

Walidacja odbywa się w przeglądarce, więc sekrety w plikach CI i manifestach nigdy nie opuszczają Twojego komputera.

Więcej narzędzi

Konwertery, walidatory i przewodniki krok po kroku dla każdego miejsca, w którym spotykają się JSON i YAML.

Najczęściej zadawane pytania

Jak zwalidować YAML online?

Wklej swój YAML lub upuść plik .yaml albo .yml. Podczas pisania znacznik pokazuje Poprawny YAML lub Niepoprawny YAML. Dla niepoprawnego pliku otrzymasz komunikat błędu z dokładnym wierszem i kolumną, a wiersz zostanie podświetlony w edytorze.

Co robi sformatowany wynik?

Zapisuje te same dane ze spójnymi wcięciami i cudzysłowami: w stylu blokowym, z wybranym wcięciem i z cudzysłowami tylko tam, gdzie są potrzebne. To szybki sposób na ujednolicenie pliku przed commitem.

Czy komentarze są zachowywane w sformatowanym wyniku?

Nie. Walidator parsuje YAML do danych i zapisuje je ponownie, a komentarze nie są częścią danych. Używaj wyniku do sprawdzania struktury i zachowaj oryginalny plik, jeśli jego komentarze są ważne.

Czy mogę zwalidować plik YAML z wieloma dokumentami?

Tak. Każdy z dokumentów rozdzielonych przez --- jest sprawdzany, a sformatowany wynik zachowuje je jako osobne dokumenty. Notatki pod edytorem pokazują, ile dokumentów znaleziono.

Czy sprawdza schematy Kubernetes lub Docker Compose?

Sprawdza składnię YAML, a nie konkretny schemat. Plik może być poprawnym YAML, a mimo to zostać odrzucony przez kubectl lub docker compose z powodu nieznanego pola. Do sprawdzania schematu użyj kubectl apply --dry-run=server lub docker compose config.

Której wersji YAML używa walidator?

Parsowanie odbywa się według schematu core YAML 1.2, więc yes, no, on i off pozostają ciągami znaków. Przy włączonej opcji „Zgodność z YAML 1.1” wynik ujmuje te słowa w cudzysłowy, aby starsze parsery, takie jak PyYAML, również odczytywały je jako ciągi znaków.