Jak używać
- Wklej tekst YAML do edytora.
- W opcji „Powtórzone klucze” wybierz „Ostrzeżenie” lub „Błąd”.
- Opcja „Wskazówki YAML 1.1” jest domyślnie włączona. Zostaw ją zaznaczoną, jeśli chcesz zobaczyć wartości, które narzędzia YAML 1.1 odczytują inaczej niż YAML 1.2, np. no albo 010.
- Kliknij komunikat błędu, aby przejść do wskazanej pozycji w edytorze i poprawić tekst.
Przykłady
Konfiguracja usługi Docker Compose
Dane wejściowe
services:
sklep:
image: nginx:alpine
ports:
- "8080:80"
Wynik
Poprawny YAML YAML 1.2 · 1 dokument · 4 klucze · głębokość 4
Nieprawidłowe wcięcie
Dane wejściowe
sklep: nazwa: Księgarnia adres: Kraków
Wynik
Znaleziono 1 błąd Linia 3, kolumna 1: Złe wcięcie. Elementy na tym samym poziomie muszą zaczynać się w tej samej kolumnie.
Powtórzony klucz jako błąd
Dane wejściowe
miasto: Warszawa miasto: Gdańsk
Wynik
Znaleziono 1 błąd Linia 2, kolumna 1: Powtórzony klucz „miasto” (pierwszy raz w linii 1, kolumnie 1).
Typowe błędy YAML i jak je naprawić
| Błąd | Przykład | Jak naprawić |
|---|---|---|
| Złe wcięcie | a:↵ b: 1↵ c: 2 | Klucze tej samej mapy muszą zaczynać się w tej samej kolumnie. |
| Tabulator użyty do wcięcia | →x: 1 | YAML dopuszcza do wcięć tylko spacje. |
| Mapa w tej samej linii co klucz | a: b: c | Ujmij wartość w cudzysłów (a: "b: c") lub przenieś b: c do wciętej linii. |
| Niezamknięty cudzysłów lub nawias | a: "text | Dodaj zamykający ", ', ] lub }. |
| Wartość zaczyna się zarezerwowanym znakiem | k: @x | Ujmij wartość w cudzysłów: k: "@x". |
| Powtórzony klucz | a: 1↵a: 2 | Usuń lub zmień nazwę jednego z kluczy – większość parserów zachowuje tylko jedną wartość. |
| „Problem Norwegii” (YAML 1.1) | country: no | Narzędzia YAML 1.1 odczytują no jako false. Ujmij w cudzysłów: "no". |
FAQ
Czy walidator sprawdzi konfigurację Kubernetes lub Docker Compose?
Sprawdza składnię YAML i reguły danych, ale nie schematy Kubernetes, Docker Compose ani OpenAPI. Poprawny YAML nie oznacza, że konfiguracja zostanie zaakceptowana przez daną aplikację.
Czy w YAML można używać tabulatorów?
Do wcięć używaj spacji: tabulator we wcięciu jest błędem. Tabulator wewnątrz wartości może być poprawny.
Czy treść YAML jest wysyłana na serwer?
Walidacja odbywa się w przeglądarce. Kod narzędzia nie wysyła treści YAML w żądaniach sieciowych.
Jaki jest maksymalny rozmiar pliku YAML?
Limit wynosi 10 MB i dotyczy zarówno plików, jak i wklejonego tekstu liczonego w bajtach UTF-8. Plik musi być poprawnym tekstem UTF-8.