Che cos'è il formato di file YAML?
.yaml è un formato di file di testo utilizzato per lo scambio di dati tra varie applicazioni. YAML - acronimo di *YAML Ain't Markup Language* - è uno standard per organizzare le informazioni in un formato leggibile dall'uomo e indipendente dalla piattaforma, utilizzando coppie key: value basate sull'indentazione e codificate in UTF-8. L'analisi dei file .yaml richiede l'installazione di una libreria YAML; tra le librerie più popolari figurano PyYAML (Python), js-yaml (JavaScript) e SnakeYAML (Java). I file .yaml vengono talvolta salvati con l'estensione .yml, che è funzionalmente identica. Oltre allo scambio di dati, i file .yaml sono tipicamente utilizzati per la serializzazione dei dati e per la scrittura di file di configurazione in strumenti come Docker Compose, Kubernetes e GitHub Actions.
Serializzazione
La serializzazione è un termine utilizzato nell'informatica. È il processo di traduzione di dati o oggetti in un formato che può essere memorizzato, trasmesso e ricostruito in seguito. Ad esempio, due istituzioni che scambiano dati in un formato standardizzato utilizzando applicazioni diverse devono serializzare tali dati prima di inviarli. I dati serializzati possono anche essere memorizzati in un file - .yaml, .xml, .json, .toml, ecc. - e poi inviati ai destinatari.
Un documento .yaml può facoltativamente iniziare con il marcatore di inizio documento --- e terminare con ...; questo consente anche la presenza di più documenti all'interno di un singolo file. A partire da YAML 1.2 (2009, revisionato nel 2021), ogni file JSON valido è anche un file YAML valido.
Sicurezza e incolumità
RISCHIO: MEDIUMUn file YAML è testo semplice e non si esegue da solo, quindi leggerne uno è sicuro. Due rischi reali: (1) i file YAML di configurazione (pipeline CI, Compose, K8s, Ansible) contengono spesso segreti - token, password, chiavi - quindi non incollarli in validatori online non attendibili né pubblicarli. (2) Pericolo programmatico: caricare YAML non attendibile con un parser non sicuro (es. yaml.load di PyYAML invece di yaml.safe_load) può eseguire oggetti o codice arbitrari - usa sempre il caricatore sicuro per i file di cui non ti fidi. Rischio di modifica: un tabulatore o uno spazio disallineato cambiano silenziosamente il significato, quindi convalida dopo la modifica.
Dettagli del formato
in sintesiNOME COMPLETOYAML Ain't Markup Language file
SVILUPPATOREClark Evans, Ingy döt Net, Oren Ben-Kiki (YAML spec)dal 2001 (YAML 1.0); YAML 1.1 (2005); current YAML 1.2 (2009, revised 2021)
CATEGORIAFile di sviluppo
TIPO MIMEapplication/yaml
TIPOTesto per la serializzazione dei dati leggibile dall'uomo (basato su indentazione, UTF-8)
STANDARDAperto · royalty-free
Programmi che aprono file YAML
Windows4 apps
Sublime Text
Freemium Apri il file .yaml per una modifica rapida con evidenziazione YAML; configura «translate tabs to spaces» affinché l'indentazione rimanga valida. 
Windows Notepad
Integrato Apre lo YAML come testo per una rapida occhiata, ma non mostra spazi bianchi o tabulatori, quindi è rischioso per modificare YAML sensibili all'indentazione. 
Notepad
Open-source Apri con l'evidenziazione della sintassi YAML; attiva Visualizza > Mostra simbolo > Mostra spazi bianchi per mantenere corretta l'indentazione. 
Visual Studio Code
Gratuito Apri il file; l'estensione YAML integrata o di Red Hat offre evidenziazione, guide all'indentazione, validazione dello schema e segnalazione degli errori. La scelta migliore per YAML. 
macOS3 apps
TextEdit
Integrato Usa prima Formato > Converti in formato solo testo e disabilita le virgolette intelligenti - ma non mostrerà gli spazi bianchi, quindi preferisci un editor di codice per le modifiche.
Visual Studio Code
Gratuito Apri il file; l'estensione YAML integrata o di Red Hat offre evidenziazione, guide all'indentazione, validazione dello schema e segnalazione degli errori. La scelta migliore per YAML. 
Sublime Text / BBEdit
Freemium Apri il file .yaml in un editor di codice per una corretta evidenziazione YAML e un'indentazione basata sugli spazi. 
Linux3 apps
Visual Studio Code
Gratuito Apri il file; l'estensione YAML integrata o di Red Hat offre evidenziazione, guide all'indentazione, validazione dello schema e segnalazione degli errori. La scelta migliore per YAML.
GNOME Text Editor / gedit
Open-source Apri con evidenziazione YAML; impostalo per inserire spazi (non tabulatori) prima di modificare.
vim / nano
Open-source Modifica nel terminale; in Vim usa «:set expandtab» in modo che l'indentazione utilizzi gli spazi. Standard per i file di configurazione del server.
Web1 app
YAML Lint / online YAML validators
Gratuito Incolla il file per convalidare la sintassi e formattarlo nel browser. Non incollare segreti: i file YAML di configurazione spesso contengono credenziali. Dettagli tecnici
specifiche approfondite| Estensione del file | .yaml (anche .yml) |
| Tipo MIME | application/yaml |
| Codifica | Testo semplice UTF-8; nessun header binario o magic bytes |
| Struttura | Coppie chiave: valore basate sull'indentazione; l'indentazione usa solo spazi - i tabulatori sono vietati dalle specifiche |
| Marcatori di documento | --- segna l'inizio del documento, ... segna la fine; più documenti possono coesistere in un unico file |
| Tipi di dati nativi | Stringhe, interi, float, booleani, null, sequenze (liste), mappature (dizionari), timestamp |
| Versione specifica | YAML 1.2 (2009, revisionato nel 2021); sostituisce YAML 1.1 (2005) e YAML 1.0 (2001) |
| Compatibilità JSON | A partire da YAML 1.2, ogni documento JSON valido è anche un documento YAML valido - JSON è un sottoinsieme rigoroso |
| Commenti | Commenti su riga singola introdotti da # ; possono apparire su una riga propria o in linea dopo un valore |
| Stringhe multilinea | Lo scalare a blocchi letterale (|) preserva i ritorni a capo; lo scalare ripiegato (>) converte i ritorni a capo in spazi |
| Ancore e alias | & definisce un'ancora con nome e * vi fa riferimento (alias), consentendo il riutilizzo dei valori senza duplicazioni |
| Sviluppatori | Clark Evans, Ingy döt Net, Oren Ben-Kiki |
| Casi d'uso comuni | File di configurazione (Kubernetes, Docker Compose, GitHub Actions, Ansible), serializzazione dei dati, definizioni OpenAPI |
| Virgolette | Supportate stringhe senza virgolette, con virgolette singole ('...') e doppie ("..."); le virgolette doppie consentono sequenze di escape |
| Rilasciato | 2001 (YAML 1.0); YAML 1.1 (2005); current YAML 1.2 (2009, revised 2021) |
| Standard aperto | Sì · royalty-free |
| Specifica | yaml.org |
Conversioni YAML
Possibile
.YAML .JSONGUIDA
Sì - YAML e JSON condividono lo stesso modello di dati, quindi la conversione è senza perdita (lossless);…
Come convertire
.YAML .XMLGUIDA
Sì - YAML e XML descrivono entrambi dati gerarchici, quindi la conversione è semplice, sebbene ogni chiave…
Come convertire
.YAML .TOMLGUIDA
Sì, YAML può essere convertito in TOML - il metodo più veloce è un comando yq: yq -o=toml file.yaml >…
Come convertire
.YAML .CSVGUIDA
Sì - ma solo quando il file .yaml è un elenco piatto e uniforme di record; le configurazioni nidificate come…
Come convertire
.YAML .YMLGUIDA
Sì - .yaml e .yml sono lo stesso formato; rinominare il file è tutto ciò che devi fare.
Come convertire
Non possibile
Domande e risposte della community
chiesto dagli utenti
I
Domande frequenti
Qual è la differenza tra .yaml e .yml?
Nessuna - sono lo stesso formato YAML con due estensioni diverse. .yml è la vecchia forma a 3 lettere. Usa quella richiesta dallo strumento; puoi semplicemente rinominare il file.
Come si apre un file .yaml?
Con qualsiasi editor di codice o di testo. VS Code (con l'estensione YAML) è l'ideale perché evidenzia la struttura e segnala gli errori di indentazione; anche Notepad++ e Sublime funzionano bene. È testo semplice, quindi anche Notepad lo apre, ma non mostrerà gli spazi bianchi, che sono fondamentali per YAML.
Perché il mio YAML restituisce un errore di indentazione o di analisi?
YAML utilizza gli spazi per la struttura e vieta i tabulatori, quindi un tabulatore o una riga disallineata interrompono il codice. Aprilo in un editor compatibile con YAML (che mostri gli spazi bianchi e converta i tabulatori in spazi) o incollalo in un validatore YAML online per trovare la riga esatta.
Come si converte YAML in JSON?
Usa «yq -o=json file.yaml», un comando di VS Code o un convertitore online. È essenzialmente una conversione lossless poiché JSON è un sottoinsieme di YAML - vengono eliminati solo i commenti.
Posso usare i tabulatori in YAML?
No. YAML consente solo spazi per l'indentazione; i tabulatori causano un errore di analisi. Imposta il tuo editor per inserire spazi (es. «:set expandtab» in Vim, o «translate tabs to spaces» in Sublime).
YAML è solo per Python?
No - è un malinteso comune. YAML è indipendente dal linguaggio e viene utilizzato ovunque: Docker Compose, Kubernetes, GitHub Actions, Ansible, app Go/Java/JS e altro ancora. Python ha semplicemente una libreria YAML molto popolare (PyYAML).
Riferimenti
1YAML 1.2.2 Specification (yaml.org)yaml.org
2yaml.org - official site & resourcesyaml.org
