File YAML (.yml): cos’è e come modificarlo
- Nome completo
- YAML Ain't Markup Language
- Tipo di file
- Web e programmazione
- Si apre con
- Qualsiasi editor di testo; Visual Studio Code con controllo della sintassi
- Tipo MIME
- application/yaml
Un file .yaml o .yml contiene dati di configurazione in un formato pensato per essere leggibile dalle persone. Lo usano Docker Compose, Kubernetes, GitHub Actions, Home Assistant, molti generatori di siti statici e programmi per server. Rispetto a JSON e XML usa meno simboli: la struttura è data dai rientri.
sito:
nome: Guida PC
lingua: it
sezioni:
- glossario
- estensioni
- dos
attivo: true
Come aprirlo e modificarlo
Con qualsiasi editor di testo (Blocco note, TextEdit), ma è molto meglio un editor di codice come Visual Studio Code o Notepad++, che colora la sintassi e segnala gli errori. Su VS Code l’estensione YAML di Red Hat controlla anche la struttura dei file più comuni.
Le regole che causano più errori
- Solo spazi, mai tabulazioni per i rientri. Un Tab invisibile basta a rendere il file non valido.
- Rientro coerente: di solito 2 spazi per livello. Un elemento spostato di uno spazio cambia significato.
- Dopo i due punti serve uno spazio:
nome: Guida PC, nonnome:Guida PC. - Testi con caratteri speciali (due punti, cancelletto, apici) vanno tra virgolette:
titolo: "Ore 10: riunione". - Il cancelletto
#inizia un commento. - Valori come yes, no, on o numeri con zeri iniziali possono essere interpretati in modo inatteso: mettili tra virgolette se devono restare testo.
YAML e JSON
Ogni file JSON valido è anche YAML valido. Molti strumenti convertono dall’uno all’altro: il JSON è più rigido e adatto allo scambio tra programmi, lo YAML più comodo da scrivere a mano.
Domande frequenti
.yaml o .yml?
Sono la stessa cosa. La documentazione ufficiale consiglia .yaml, ma molti progetti usano .yml per abitudine.
Hai trovato un errore o manca qualcosa? Scrivi alla redazione: correggiamo e aggiorniamo le voci.