what is JSON to CSV converter online: anatomia dello strumento (guida 2026)

what is JSON to CSV converter online: cinque macchine, non una

Quando incolli JSON in un convertitore e ne esce un CSV, sembra un'unica azione. Non lo è. Ogni convertitore JSON in CSV online, questa pagina inclusa, esegue gli stessi cinque passaggi nello stesso ordine: analisi (parse), ricerca delle righe, appiattimento, serializzazione, download. Sapere quale fase fa cosa cambia il modo in cui leggi ogni messaggio di errore e ogni cella dall'aspetto strano, perché ogni tipo di problema appartiene esattamente a una fase.

La pipeline conta per un secondo motivo: le opzioni nella pagina non sono impostazioni magiche. Ogni interruttore e menu a tendina si collega a una fase precisa. L'interruttore di appiattimento controlla la fase tre. La scelta del delimitatore controlla la fase quattro. Una volta vista la corrispondenza, le opzioni smettono di essere tentativi e diventano decisioni.

Questa guida percorre le cinque fasi in ordine sullo stesso piccolo record di ordine, così puoi vedere ogni macchina fare il suo lavoro. Ogni output mostrato è stato prodotto dal convertitore reale di questa pagina, non illustrato.

Parte 1: il parser, il buttafuori all'ingresso

La fase uno legge ciò che incolli e decide se è davvero JSON. È la macchina più rigida della pipeline e la meno indulgente: JSON con una virgoletta mancante, una virgola finale di troppo o un carattere estraneo viene respinto qui, prima che altro venga eseguito. Ed è un pregio. Un convertitore che indovinasse l'input rotto produrrebbe in silenzio una tabella sbagliata.

Quando il parser rifiuta il tuo input, ti dice dove si è fermato, di solito a un carattere o due dall'errore vero. I due rifiuti più comuni sono la casella vuota e il JSON malformato, e i messaggi sono semplici:

What the parser reports

Input: (empty box)
Output: Input is empty. Please paste or upload JSON data.

In questa fase i tuoi dati non cambiano per niente. Il parser accetta il JSON e passa i valori strutturati alla fase due, oppure ferma l'intera pipeline con un errore. Se mai vedi un convertitore produrre una tabella da un input che sai essere rotto, quel convertitore ha saltato la convalida, e non dovresti fidarti del suo output.

Parte 2: il cercatore di righe, da dove nascono le righe

La fase due guarda il JSON analizzato e risponde a una domanda: cosa diventa una riga? Un CSV è un elenco di righe, quindi il convertitore deve trovare un elenco da qualche parte nei tuoi dati. Il caso facile è un array di oggetti al livello superiore: ogni oggetto diventa una riga, punto e basta.

I dati reali raramente sono così ordinati. Le API adorano incartare i loro elenchi: {"users": [...], "total": 2}. Un buon cercatore di righe individua l'elenco incartato, lo usa come righe e ignora i campi dell'involucro. Un singolo oggetto senza alcun elenco diventa esattamente una riga. Il JSON delimitato da newline, un oggetto per riga, viene letto come una riga per riga.

Input: a wrapped list, as APIs return it

{"users": [{"name": "Amelia", "city": "Austin"}, {"name": "Bruno", "city": "Berlin"}], "total": 2}

Il cercatore di righe estrae l'elenco users e crea due righe con le colonne name e city. Il campo total non è una riga e non è una colonna, quindi viene scartato. È questa la fase da incolpare quando l'output ha meno righe del previsto, o quando mancano colonne che ti aspettavi: il convertitore ha trovato un elenco diverso da quello che intendevi.

Parte 3: l'appiattitore, l'unica vera trasformazione

La fase tre è l'unica che cambia la forma dei tuoi dati. Le celle CSV non possono contenere oggetti o elenchi, quindi tutto ciò che è annidato va riscritto prima di entrare in una tabella. L'appiattitore porta ogni valore annidato al livello superiore con regole fisse: gli oggetti annidati diventano colonne in notazione puntata, gli elenchi brevi di valori semplici diventano un'unica cella con i valori uniti, e gli elenchi di oggetti diventano testo JSON dentro una cella tra virgolette.

Ecco il record di input usato da questa guida, con un oggetto customer annidato, un elenco tags e una nota che contiene una virgola:

Input JSON (nested)

[{"id": "A-101", "customer": {"name": "Amelia", "city": "Austin"}, "tags": ["new", "vip"], "note": "ships, fast"}]

Parte 3: l'appiattitore, l'unica vera trasformazione (continua)

Ed ecco cosa l'appiattitore passa alla fase successiva, verificato sul convertitore reale:

Flattened output (verified against the real engine)

id,customer.name,customer.city,tags,note
A-101,Amelia,Austin,new; vip,"ships, fast"

Leggilo colonna per colonna. L'oggetto customer è diventato due colonne, customer.name e customer.city. L'elenco tags è diventato un'unica cella, new; vip, con i valori uniti da punto e virgola e spazio. La nota ha conservato la sua virgola, e la fase quattro se ne occuperà. I valori null e gli elenchi vuoti diventano celle vuote. Nulla è inventato e nulla è cancellato, ma un albero è diventato una tabella.

Spegni l'interruttore di appiattimento e la fase tre viene saltata: i valori annidati restano come testo JSON dentro le loro celle, tra virgolette così la tabella resta valida. A volte è quello che vuoi, quando il sistema ricevente riespande il JSON, e a volte è un disastro. In ogni caso, è questa fase a farlo.

Parte 4: il serializzatore, il motore delle virgolette

La fase quattro trasforma le righe appiattite in testo CSV, e il suo unico compito è tenere valida la tabella. La regola che segue è semplice: una cella che contiene il delimitatore, un carattere di virgoletta o un ritorno a capo viene racchiusa tra virgolette doppie, e ogni virgoletta al suo interno viene raddoppiata. Tutto il resto viene scritto senza protezioni.

La parte sottile è che le virgolette seguono il delimitatore in uso, non un'idea fissa di cosa sia speciale. Guarda lo stesso record serializzato con il delimitatore punto e virgola, verificato sul convertitore reale:

Semicolon output (verified against the real engine)

id;customer.name;customer.city;tags;note
A-101;Amelia;Austin;"new; vip";ships, fast

La cella tags ora è tra virgolette, perché new; vip contiene un punto e virgola. Ma la nota ships, fast è senza protezioni: con i punti e virgola come delimitatore, una virgola è un carattere ordinario e non ha bisogno di protezione. Il motore racchiude in base al delimitatore effettivamente in uso. È anche il motivo per cui un CSV dall'aspetto perfetto può aprirsi come un'unica colonna in Excel: Excel l'ha diviso su un delimitatore diverso da quello usato dal serializzatore, ed è una discrepanza di fase quattro, non dati rotti.

Parte 4: il serializzatore, il motore delle virgolette (continua)

Un altro delimitatore, perché sorprende la gente: il tab. I tab quasi mai compaiono nei dati reali, quindi l'output separato da tab di solito non ha bisogno di alcuna virgoletta:

Tab output (verified against the real engine)

id	customer.name	customer.city	tags	note
A-101	Amelia	Austin	new; vip	ships, fast

Nessuna virgoletta da nessuna parte. Anche l'interruttore dell'intestazione è un'opzione di fase quattro: decide semplicemente se i nomi delle colonne vengono scritti come prima riga. Nient'altro cambia.

Parte 5: il download, UTF-8 semplice e un nome file

La fase cinque è la meno interessante e la più facile da sbagliare. Prende il testo finito e te lo consegna come file. Questa pagina lo chiama data-export-YYYY-MM-DD.csv, così i download ripetuti si ordinano per data, e lo scrive come UTF-8 semplice senza byte-order mark.

Il dettaglio del BOM assente vale la pena di conoscerlo perché morde in Excel. Alcuni programmi si aspettano un BOM per riconoscere l'UTF-8; senza, i caratteri accentati possono mostrarsi come testo illeggibile (mojibake) quando fai doppio clic sul file. La correzione sta dal lato dell'apertura, non del file: in Excel, importa il file come importazione testo e scegli la codifica 65001: Unicode (UTF-8). Il file in sé va bene.

Dove si collegano le opzioni della pagina

Con le cinque fasi mappate, le opzioni del convertitore si leggono come uno schema elettrico. L'interruttore appiattisci i valori annidati abilita o salta la fase tre. La scelta del delimitatore, virgola, punto e virgola, tab o pipe, imposta il carattere su cui la fase quattro basa le virgolette. L'interruttore includi riga di intestazione aggiunge o toglie la riga dei nomi di colonna nella fase quattro. Conversione automatica riesegue semplicemente l'intera pipeline a ogni battitura invece di aspettare un pulsante.

Non c'è opzione che tocchi il parser, ed è voluto: la convalida non è una preferenza. Un convertitore che ti lasciasse disabilitare la fase uno produrrebbe spazzatura dall'aspetto autorevole a partire da input rotto.

Quando l'output sembra sbagliato, la colpa è di una sola parte

La diagnosi è tutto il senso di conoscere la pipeline. Abbina il sintomo alla fase e sai dove guardare:

Un messaggio di errore che nomina una posizione: fase uno, il parser. Il tuo JSON è malformato vicino al punto segnalato; convalidalo e correggi l'origine.
Meno righe o colonne mancanti: fase due, il cercatore di righe. Il convertitore ha scelto un elenco diverso da quello che intendevi, oppure la forma del tuo involucro l'ha confuso.
Dati annidati come testo JSON illeggibile nelle celle: fase tre, l'appiattitore, è spento o i dati erano troppo profondi. Attiva l'appiattimento.
Tutto finisce in un'unica colonna all'apertura: fase quattro, il serializzatore, ha usato un delimitatore diverso da quello che il tuo foglio di calcolo si aspetta. Reimporta e scegli il delimitatore giusto, oppure rigenera con punto e virgola o tab.
Virgolette spurie o righe spezzate: virgolette di fase quattro, di solito dall'opzione quoteMode never o da CSV modificati a mano. Lascia le virgolette su automatico.
Caratteri strani all'apertura: fase cinque, la codifica del download. Reimporta come UTF-8 (65001) invece di fare doppio clic.

Cosa NON è un convertitore JSON in CSV online

La pipeline definisce anche i confini. Un convertitore non è un editor JSON: non può correggere i tuoi dati, rinominare i tuoi campi o decidere cosa significa una colonna. Non è neanche un formattatore JSON, anche se il parser convalida come effetto collaterale; se vuoi JSON stampato in modo leggibile, quello è un altro strumento. Non è un foglio di calcolo: una volta scaricato il CSV, ordinamento, filtri e formule avvengono in Excel o Fogli Google, non nel convertitore.

E non può cambiare ciò che i tuoi dati significano. L'appiattimento conserva i valori ma appiattisce i tipi: numeri, booleani e null diventano tutti testo, la struttura annidata diventa nomi di colonna, e non c'è modo di tornare all'albero originale dal solo CSV. Quando le righe hanno forme diverse, il convertitore prende l'unione di tutte le colonne e lascia vuoti dove a una riga manca un campo. È un comportamento onesto, ma vale la pena saperlo prima di convertire: un convertitore riorganizza i tuoi dati fedelmente, e fedelmente è tutto ciò che promette.

Guide correlate

Domande frequenti

Cos'è un convertitore JSON in CSV online in una frase?

È una pagina web che trasforma dati JSON in un file CSV in cinque passaggi, parser, cercatore di righe, appiattitore, motore delle virgolette e download, con l'intera pipeline che gira nella tua scheda del browser.

Quali sono le cinque parti di un convertitore JSON in CSV?

Il parser, che convalida il JSON; il cercatore di righe, che decide cosa diventa una riga; l'appiattitore, che trasforma i valori annidati in celle semplici; il serializzatore, che scrive testo CSV valido con le virgolette corrette; e la fase di download, che ti consegna il file. Le opzioni della pagina si collegano alle tre centrali.

Perché il convertitore racchiude tra virgolette alcune celle e altre no?

Le virgolette seguono il delimitatore in uso. Una cella viene racchiusa tra virgolette solo se contiene il delimitatore attivo, un carattere di virgoletta o un ritorno a capo, e le virgolette interne vengono raddoppiate. Cambia il delimitatore e verranno racchiuse celle diverse: è un comportamento corretto, non un'incoerenza.

Perché il mio CSV si è aperto come un'unica colonna in Excel?

È una discrepanza di delimitatore alla fase del serializzatore, non dati rotti. Excel divide le colonne sul separatore di elenco del tuo sistema, che è una virgola in alcune regioni e un punto e virgola in altre. Reimporta il file e scegli il delimitatore corrispondente, oppure rigenera il CSV con l'opzione punto e virgola o tab.

Un convertitore JSON in CSV è la stessa cosa di un formattatore JSON?

No. Un formattatore stampa il JSON in modo leggibile per gli umani; un convertitore ristruttura il JSON in una tabella che i fogli di calcolo possano aprire. Il parser del convertitore convalida comunque il tuo JSON come effetto collaterale, ed è per questo che un input non valido riceve un errore invece di una tabella, ma la formattazione non è il suo lavoro.

Un convertitore può correggere JSON rotto o non valido?

No, e dovresti diffidare di uno che ci prova. La fase del parser rifiuta il JSON malformato con un errore che nomina la posizione in cui si è fermato. Correggi il JSON all'origine, una virgoletta mancante o una virgola di troppo vicino alla posizione segnalata, poi converti di nuovo.

Il convertitore cambia i miei dati, o solo il formato?

I valori sono conservati ma la forma cambia. L'appiattimento trasforma gli oggetti annidati in colonne in notazione puntata e gli elenchi in celle unite, e ogni valore diventa testo: numeri, booleani e null perdono i loro tipi. Le righe con forme diverse ottengono l'unione di tutte le colonne, con vuoti dove manca un campo.

Guarda le cinque parti in azione

Incolla qualsiasi JSON nel convertitore in questa pagina e guarda il parser, l'appiattitore e il motore delle virgolette fare il loro lavoro. Gratis, senza registrazione, gira interamente nel tuo browser.

Apri il convertitore JSON in CSV

Tutte le guide