YAML Syntax Check i walidator YAML oraz Ansible

Sprawdź YAML online, wykryj błędy składni, problemy z wcięciami, ostrzeżenia jakościowe i szybciej napraw typowe problemy YAML oraz Ansible.

Język

Walidacja na żywo Pokaż sformatowany wynik Rozwiązuj aliasy podczas formatowania Obsługuj klucz merge <<

Wejściowy YAML

Sformatowany wynik

Uwaga: zwykły textarea nie potrafi podświetlać fragmentów tekstu w środku pola. Dlatego edytor oznacza numery linii i przechodzi do miejsca błędu.

Co sprawdza ten walidator YAML

To narzędzie online sprawdza zwykłe pliki YAML oraz playbooki Ansible. Pomaga wykryć problemy, które często psują parsowanie, wdrożenia i automatyzację.

Błędy składni YAML i błędy parsera
Problemy z wcięciami spowodowane spacjami lub tabulatorami
Zduplikowane klucze w tej samej mapie YAML
Problemy z aliasami, anchorami i kluczem merge
Formatowanie wyniku dla łatwiejszego debugowania
Typowe ostrzeżenia jakościowe dla playbooków Ansible

Najczęstsze błędy YAML z przykładami

Błędne wcięcia

YAML jest wrażliwy na wcięcia. Nawet jedna źle ustawiona spacja może zepsuć cały dokument.

Błędnie

items:
 - apple
  - banana

Poprawnie

items:
  - apple
  - banana

Brak dwukropka po kluczu

Klucz mapy zwykle potrzebuje dwukropka przed wartością.

Błędnie

name Jan
age: 30

Poprawnie

name: Jan
age: 30

Tabulatory we wcięciach

YAML powinien używać spacji do wcięć. Tabulatory często powodują błędy parsera.

Błędnie

tasks:
	- debug:
	    msg: hello

Poprawnie

tasks:
  - debug:
      msg: hello

Zduplikowane klucze

Użycie tego samego klucza dwa razy w jednej mapie może ukrywać wartości i psuć automatyzację.

Błędnie

service:
  enabled: true
  enabled: false

Poprawnie

service:
  enabled: false

Błędne anchory i aliasy

Alias musi wskazywać anchor, który został wcześniej zdefiniowany.

Błędnie

defaults: *base

Poprawnie

defaults: &base
  retries: 3
copy: *base

Cudzysłowy zmieniają typ danych

Boolean, null albo liczba w cudzysłowie staje się tekstem, a nie natywną wartością YAML.

Błędnie

enabled: "true"
port: "8080"

Poprawnie

enabled: true
port: 8080

Typowe problemy YAML w Ansible

Playbooki Ansible często przestają działać, bo struktura YAML wygląda dobrze na pierwszy rzut oka, ale nie pasuje do tego, czego oczekuje narzędzie. Ten walidator pomaga wychwycić zarówno błędy składni, jak i typowe problemy w playbookach.

Taski bez czytelnej nazwy
Brak hosts w definicji play
Handlers albo vars zapisane w złej strukturze YAML
Listy commands wcięte na złym poziomie
Liczby, booleany i null w cudzysłowach zmieniające typ danych

FAQ o walidacji YAML

Jakie są najczęstsze błędy składni YAML?

Najczęstsze błędy YAML to złe wcięcia, brakujące dwukropki, zduplikowane klucze, uszkodzone listy oraz niepoprawne użycie anchorów i aliasów.

Jak naprawić błędy wcięć w YAML?

Używaj spacji w sposób spójny, wyrównuj elementy na tym samym poziomie i unikaj tabulatorów we wcięciach.

Czy ten walidator obsługuje pliki Ansible?

Tak. Walidator sprawdza standardową składnię YAML oraz wiele typowych problemów spotykanych w playbookach Ansible.

Dlaczego YAML jest poprawny w jednym narzędziu, a błędny w innym?

Różne narzędzia mogą stosować różne wersje YAML albo dodatkowe reguły. Częstymi źródłami różnic są zduplikowane klucze, merge key oraz typy niejawne.

Czy można automatycznie naprawić problemy w YAML?

To narzędzie potrafi automatycznie naprawić część prostych problemów, ale problemy strukturalne nadal mogą wymagać ręcznej poprawy.

Czy "true" i "false" w cudzysłowie pozostają booleanem?

Nie. W większości przypadków wartości takie jak "true" lub "false" zapisane w cudzysłowie stają się tekstem.