In questo articolo
Cos'è YAML e perché validarlo
YAML, che sta per YAML Ain't Markup Language, è un formato di serializzazione dati leggibile usato ampiamente per file di configurazione, pipeline CI/CD, infrastruttura come codice e scambio dati. La sua sintassi basata sull'indentazione lo rende leggibile ma anche altamente sensibile agli errori di spazi bianchi che sono invisibili a occhio nudo.
Validare il YAML prima del deployment è fondamentale perché anche un singolo spazio fuori posto o un livello di indentazione errato può causare un parsing della configurazione diverso da quello previsto, o un fallimento totale del parsing. Un file YAML corrotto in un manifest Kubernetes, uno stack Docker Compose o un workflow GitHub Actions può far cadere i servizi o bloccare i deployment.
Come funziona il validatore YAML
Il validatore analizza il tuo input YAML e riporta errori di sintassi con numeri di riga e colonna precisi per correggere i problemi istantaneamente.
- Incolla il tuo YAML — inserisci o incolla contenuto YAML di qualsiasi dimensione e il validatore lo analizza immediatamente nel browser
- Visualizza i dettagli dell'errore — se il YAML è malformato, il validatore evidenzia la riga e la colonna esatte dove il parser ha fallito, con un messaggio di errore chiaro
- Valida la struttura — oltre alla sintassi, il validatore controlla chiavi duplicate, tipi errati e altri problemi strutturali che potrebbero causare comportamenti inattesi
- Formatta l'output — il YAML valido viene automaticamente formattato con indentazione coerente in modo da poter copiare una versione pulita nel tuo progetto
Prova gratuitamente — nessuna registrazione richiesta
Apri il validatore YAML →Errori YAML comuni e come correggerli
La sintassi YAML è ingannevolmente semplice, e diversi pattern di errore si ripresentano frequentemente nei file di configurazione reali.
- Errori di indentazione — YAML usa spazi per la nidificazione, e mischiare tabulazioni con spazi o usare livelli di indentazione incoerenti è la causa più comune di fallimenti di parsing
- Caratteri speciali senza apici — i valori che contengono due punti, cancelletti o parentesi graffe devono essere racchiusi tra apici per impedire al parser di interpretarli come sintassi YAML
- Chiavi duplicate — YAML consente chiavi duplicate allo stesso livello ma solo l'ultimo valore viene mantenuto, il che sovrascrive silenziosamente i valori precedenti e causa bug difficili da trovare
Domande frequenti
Qual è la differenza tra YAML e JSON?
YAML è un superset di JSON, il che significa che ogni documento JSON valido è anche YAML valido. YAML aggiunge funzionalità come commenti, stringhe multiriga, ancoraggi e nidificazione basata sull'indentazione che lo rendono più leggibile. JSON è più rigoroso e più ampiamente supportato dalle API, mentre YAML è preferito per i file di configurazione dove la leggibilità è importante.
Posso usare le tabulazioni per l'indentazione in YAML?
No. La specifica YAML proibisce esplicitamente i caratteri di tabulazione per l'indentazione. Devi usare spazi, e il numero di spazi per livello di indentazione deve essere coerente all'interno di un documento. La maggior parte degli editor può essere configurata per inserire spazi quando premi il tasto Tab.
Il validatore supporta YAML multi-documento?
Sì. I file YAML possono contenere più documenti separati da un separatore a tre trattini. Il validatore analizza ogni documento indipendentemente e riporta errori con i numeri di riga corretti relativi al file completo.