DevToolPal
IT

Formattatore e validatore YAML

Controlla la sintassi YAML, elenca ogni errore con riga e colonna e riformatta lo YAML valido con un rientro uniforme.

Eseguito in locale, mai caricato

Opzioni

Rientro

YAML

0 caratteri · 0 B

Validazione

Il risultato apparirà qui

Cosa fa

YAML è molto usato nei file di configurazione — manifest Kubernetes, workflow di GitHub Actions e GitLab CI, Docker Compose, playbook Ansible, documenti OpenAPI — perché è facile da leggere. È anche facile da rompere: un rientro sbagliato, una tabulazione, una virgoletta non chiusa o uno spazio mancante dopo i due punti possono cambiare il significato di un file o impedirne il caricamento.

Questo validatore analizza il tuo YAML e segnala ogni errore di sintassi con riga e colonna, oltre ad avvisi come le direttive sconosciute. Quando lo YAML è valido, mostra il numero di documenti e il tipo di ogni valore radice, e può produrre una copia riformattata con rientro uniforme.

Come si usa

  1. Incolla lo YAML nell’input, carica un file .yaml o .yml, oppure fai clic su Esempio.
  2. Il risultato appare mentre scrivi: un badge verde YAML valido o un elenco di errori come Riga 3, colonna 2.
  3. Lascia attivo Mostra YAML formattato per ottenere una copia ordinata e scegli un rientro di 2 o 4 spazi. Copiala con il pulsante sopra il blocco.
  4. Disattiva Chiavi duplicate come errore solo se i tuoi strumenti ammettono chiavi ripetute.

Errori comuni

server:
  port: 8080
   host: localhost   # indented one space too far
tags: [web, api      # missing closing bracket
  • Rientro incoerente: gli elementi dello stesso livello devono iniziare nella stessa colonna. YAML non ammette tabulazioni per il rientro.
  • Spazio mancante dopo i due punti: key:value è una semplice stringa, non una chiave con un valore.
  • Caratteri speciali senza virgolette: i valori che iniziano con *, &, !, %, @ o un backtick, o che contengono : o #, vanno tra virgolette.
  • Tipi inattesi: yes, no, on e off sono stringhe in YAML 1.2 ma booleani nei vecchi parser YAML 1.1; mettili tra virgolette per sicurezza. Numeri di versione come 1.10 diventano il numero 1.1 senza virgolette.

Validare la struttura

Questo strumento controlla la sintassi, cioè se il testo è YAML ben formato. Per verificare che un file abbia le chiavi e i tipi giusti, convertilo con lo strumento YAML in JSON e valida il risultato con il Validatore JSON Schema.

Domande frequenti

› Quale versione di YAML segue il validatore?

YAML 1.2, la versione attuale usata dalla maggior parte degli strumenti moderni. Gli input con più documenti separati da --- vengono controllati un documento alla volta.

› Perché le chiavi duplicate sono segnalate come errori?

La specifica YAML richiede che le chiavi di una mappa siano uniche, e molti parser tengono in silenzio solo l’ultimo valore, nascondendo gli errori. Se il tuo strumento accetta i duplicati di proposito, disattiva Chiavi duplicate come errore.

› La formattazione mantiene i commenti?

Sì. Commenti, ordine delle chiavi, ancore e stringhe tra virgolette vengono conservati; si uniformano solo rientri e spazi. Le stringhe lunghe non vengono spezzate.

› Il mio YAML viene caricato da qualche parte?

No. L’analisi avviene nel browser, quindi i file di configurazione con segreti non lasciano mai il tuo computer.