Convertitore da JSON a CSV

Incolla un array JSON di oggetti e ottieni in cambio un file CSV pulito e con caratteri di escape corretti, pronto per essere copiato o scaricato. Le intestazioni delle colonne vengono generate automaticamente da ogni chiave presente nell'array, quindi le righe con campi mancanti o in eccesso vengono gestite correttamente. Tutto avviene nel tuo browser; i dati non lasciano mai il tuo dispositivo.

Che cos'è questo strumento?

Le API e i database restituiscono solitamente i dati in formato JSON, ma i fogli di calcolo, Excel, Google Sheets e la maggior parte degli strumenti di importazione dati richiedono il formato CSV. Questo strumento colma tale divario: basta incollare un array di oggetti JSON (come una risposta API) e il programma genera un file CSV con una colonna per ogni chiave univoca e una riga per ogni oggetto.

La conversione gestisce i dettagli che compromettono gli approcci semplicistici: i valori contenenti virgole o virgolette vengono correttamente codificati, i campi mancanti vengono sostituiti da celle vuote anziché causare un errore di conversione, e gli oggetti o gli array annidati all'interno di un campo vengono serializzati come stringa JSON in quella cella anziché essere ignorati senza alcun avviso.

Perché usarlo?

Rilevamento automatico delle intestazioni: l'elenco delle colonne viene generato dall'unione delle chiavi di tutti gli oggetti, quindi i record non coerenti non compromettono il risultato finale.
Corretta codifica CSV: i valori contenenti virgole, virgolette o interruzioni di riga vengono racchiusi tra virgolette in modo corretto, in modo che il file si apra correttamente in Excel o Google Sheets.
Gestisce i dati annidati: un oggetto o un array contenuto in un campo viene serializzato in formato JSON anziché generare un errore.
Copia negli appunti o scarica direttamente come file .csv.
Al 100% lato client: i tuoi dati (risposte API, record esportati) non vengono mai caricati da nessuna parte.

Come si usa

Inserisci un array JSON di oggetti, ad esempio [{"name":"Alice","age":30},{"name":"Bob","age":25}].
Fai clic su "Converti in CSV".
Controlla il risultato: copialo o clicca su "Scarica CSV" per salvare un file.
Apri il file scaricato in Excel, Google Sheets o qualsiasi altro programma per fogli di calcolo.

Esempio

Input

[{"name":"Alice","age":30},{"name":"Bob","city":"NYC"}]

Risultato

name,age,city
Alice,30,
Bob,,NYC

Si noti come sia “città” che “età” diventino colonne, anche se nessun singolo oggetto presenta entrambi i dati: i valori mancanti vengono semplicemente lasciati in bianco.

Consigli pratici

Conversione della risposta di un'API per un report in formato foglio di calcolo: incolla l'array JSON direttamente dalla scheda "Rete" del browser o da uno strumento di test delle API, converti e scarica — senza bisogno di script intermedi.
Quando si lavora con record non uniformi (ad esempio, campi facoltativi provenienti dall'esportazione di un modulo): il rilevamento automatico delle intestazioni consente di evitare di dover prima allineare manualmente gli schemi.
Se il tuo JSON è un unico oggetto di grandi dimensioni contenente un array annidato al suo interno (ad es. {"users": [...]}), estrai solo la parte relativa all'array (la porzione [...] ) prima di incollarla qui.

Perché l'ordine delle colonne e la completezza sono importanti

Un bug del CSV, sottile ma comune, si verifica quando i dati vengono esportati inserendo manualmente le intestazioni all’inizio e sperando che ogni riga corrisponda: se la riga 50 su 1000 presenta un campo in più che nessuna delle righe precedenti aveva, uno strumento di scrittura CSV ingenuo che opera riga per riga o tralascia quel campo senza avvisare oppure sposta tutte le colonne successive fuori allineamento. Questo strumento evita tale errore analizzando prima ogni oggetto nell’array per costruire la riga di intestazione completa e corretta prima di scrivere una singola riga di output — in questo modo, un campo che compare una sola volta, sull’ultimo oggetto, ottiene comunque una propria colonna e il valore corrispondente in ogni altra riga viene correttamente visualizzato come vuoto, anziché compromettere la struttura della riga.

Domande frequenti

Funziona anche con un singolo oggetto JSON invece che con un array?

Si aspetta un array: racchiudi un singolo oggetto tra parentesi quadre, ad esempio modifica {"name":"Alice"} in [{"name":"Alice"}], e verrà convertito in un CSV a una riga.

Cosa succede agli oggetti o agli array annidati all'interno di un campo?

Vengono serializzati come stringa JSON all’interno di quella cella (ad esempio, un campo contenente {"a":1} diventa il testo "{""a"":1}" nel CSV, con le virgolette correttamente sostituite) anziché generare un errore o essere tralasciati. Se hai bisogno di dati annidati appiattiti in colonne separate, ciò richiede uno strumento diverso, specifico per lo schema.

I miei dati vengono caricati su un server?

No. La conversione avviene interamente tramite JavaScript nel browser: non viene inviato nulla da nessuna parte, il che rende questa funzione sicura da utilizzare con i dati dei clienti o aziendali esportati.

Perché il mio file CSV presenta delle celle vuote?

Se alcuni oggetti dell'array non dispongono di una chiave presente in altri, quella colonna esiste ma la cella rimane vuota per gli oggetti che non la possiedono: in questo modo vengono preservati tutti i dati, invece di generare un errore a causa di record incoerenti.

I valori separati da virgole compromettono il file CSV?

No. Qualsiasi valore contenente una virgola, un apice o un'interruzione di riga viene automaticamente racchiuso tra virgolette (con le virgolette interne sostituite) secondo le regole standard del formato CSV, in modo che possa essere aperto correttamente in Excel e Google Sheets.