Vai al contenuto

Formattatore YAML

Convalida e riformatta YAML con indicazione chiara degli errori di riga e colonna.

Ingresso

Formattatore YAML

YAML appare ovunque: dai manifesti Kubernetes ai flussi di lavoro GitHub Actions ai file di configurazione delle applicazioni. È spietato con gli spazi bianchi: un singolo spazio mal allineato distrugge l'intero documento. Questo strumento controlla la sintassi di un documento YAML e lo riformatta in modo coerente, in modo da poter rilevare una pipeline o un file di configurazione difettoso prima che venga eseguito.

Incolla un documento e viene analizzato istantaneamente. L'input valido viene restituito riformattato con la larghezza di rientro scelta; l'input non valido restituisce la riga e la colonna esatte del problema insieme a ciò che il parser si aspettava lì, quindi non dovrai indovinare quale delle quaranta righe ha la tabulazione smarrita. Due controlli vengono eseguiti automaticamente su ogni documento valido: un avvertimento se una riga utilizza una tabulazione per il rientro (la specifica YAML la vieta anche se molti editor la inseriscono per impostazione predefinita) e un conteggio delle chiavi duplicate nello stesso mapping (YAML lo consente, ma generalmente significa che solo l'ultimo valore rimane e gli altri sono peso morto).

Le opzioni controllano sia la forma che gli spazi bianchi. Ordina le chiavi in ordine alfabetico per ottenere un documento deterministico e confrontabile, utile quando la configurazione generata produce continuamente diff git rumorosi senza motivo funzionale. Comprimere gli elenchi brevi trasforma una sequenza scalare come un elenco di tag su tre righe in una singola riga in stile flusso come tags: [a, b, c]; lascialo disabilitato e tutti gli elenchi di flusso in linea nell'input verranno espansi a un elemento per riga, il che è generalmente più facile da rivedere e unire. Rimuovi commenti rimuove sia i commenti su riga intera che i commenti hash finali per una versione minificata, mentre mantenerli preserva i commenti del documento esattamente come sono scritti.

La formattazione avviene interamente nel tuo browser. Lo YAML che incolli non viene mai caricato, registrato o inviato da nessuna parte: viene analizzato, riformattato e visualizzato localmente, e scompare quando chiudi o ricarichi la scheda.

FAQ

Il mio YAML viene caricato da qualche parte?
No. L'analisi e la formattazione avvengono interamente nel motore JavaScript del tuo browser. Nulla di ciò che incolli viene inviato a un server, registrato o archiviato al di fuori del tuo dispositivo.
Cosa significano la riga e la colonna nell'errore?
Indicano il punto esatto nel tuo documento in cui il parser ha smesso di capire, contando dall'alto e da sinistra del testo che hai incollato. Indica anche ciò che si aspettava lì, come un rientro coerente o un valore dopo i due punti.
Perché avverte le tabulazioni?
La specifica YAML vieta l'uso di caratteri di tabulazione per il rientro: sono consentiti solo spazi. Un documento con rientro a tabulazione può essere analizzato in modo incoerente o fallire completamente in un'altra implementazione YAML, quindi lo strumento lo segnala anche se il tuo input viene ancora analizzato qui.
Cosa succede con le chiavi duplicate?
YAML consente di ripetere una chiave nello stesso mapping e la maggior parte dei parser mantiene silenziosamente solo l'ultimo valore. Lo strumento non lo rifiuta, ma conta i duplicati e contrassegna la riga interessata in modo che tu possa decidere se era intenzionale.
Può correggere YAML non valido per me?
No: ti dice esattamente dove l'analisi ha fallito in modo da poter riparare la fonte. Indovinare automaticamente una correzione per un rientro interrotto rischia di cambiare il significato del documento.