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, non nome: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.