Come creare un CSV da JSON: 7 decisioni che trasformano i dati grezzi in un file funzionante (Guida 2026)

Creare non è la stessa cosa che convertire

Si dice \"creare un CSV\" e \"convertire JSON in CSV\" come se fossero la stessa cosa. Non lo sono. La conversione è meccanica: lo stesso JSON produce sempre lo stesso CSV con le stesse impostazioni. Creare è un atto autoriale: il file che consegni a un collega, importi in un database o dai in pasto a uno strumento di analisi deve sopravvivere in ambienti che non controlli — Excel in un altro paese, un caricatore di database con regole rigide, un collega che apre tutto con un doppio clic.

Tra \"convertito\" e \"creato\" ci sono sette decisioni. Saltale e il file si convertirà comunque; si romperà solo più avanti, nel momento peggiore possibile. La buona notizia: ogni decisione richiede pochi secondi, e una volta capito di cosa si tratta non smetterai più di vederla. Ogni esempio qui sotto è stato eseguito sul vero motore di conversione di questo sito — lo stesso JavaScript che gira quando premi Converti — quindi gli output mostrati sono esattamente quelli che otterrai.

Decisione 1: appiattisci l'albero prima di costruire la griglia

Non puoi costruire colonne da un JSON annidato. Un CSV è una griglia — righe e colonne, ogni cella un singolo valore piatto — e gli oggetti annidati non hanno una colonna in cui vivere. Quindi la prima decisione è appiattire: gli oggetti annidati diventano colonne con notazione a punti (customer diventa customer.name e customer.city), gli elenchi di valori semplici si uniscono in un'unica cella e i null diventano celle vuote. Questo è il passaggio meccanico, ed è quello che il convertitore fa per te con il suo interruttore di appiattimento.

Perché farlo prima di tutto? Perché ogni decisione successiva — nomi delle intestazioni, delimitatori, quotatura — opera sul risultato appiattito. Se rinomini le intestazioni prima di appiattire, stai dando nomi a colonne che non esistono ancora. Il motore qui appiattisce per impostazione predefinita con l'opzione chiamata flattenNested, quindi in pratica questa decisione è: lasciala attiva, dai un'occhiata all'anteprima e conferma che i nomi delle colonne siano quelli che ti aspetti.

Decisione 2: dai alle colonne nomi da contratto

I nomi della riga di intestazione sono un contratto con ogni strumento che toccherà mai il file. I nomi di intestazione sbagliati sono il modo più silenzioso per creare un CSV cattivo: non falliscono mai al momento della conversione, falliscono nell'importazione nel database tre settimane dopo. Quattro regole coprono quasi tutto:

Niente spazi nei nomi di intestazione. \"order id\" è leggibile per te e una segnalazione di bug per un caricatore SQL; usa invece orderId o order_id. Il motore di appiattimento produce già nomi puntati senza spazi (customer.name), quindi solo le tue chiavi di primo livello richiedono attenzione.
Niente nomi duplicati. Due intestazioni identiche fanno sì che la seconda colonna sovrascriva silenziosamente la prima in molti importatori. Se il tuo JSON ha sia \"user.name\" come chiave letterale sia un user: { name } annidato, l'appiattimento li unisce in un'unica colonna — vince il valore annidato e l'altro va perso. Rinomina prima di convertire se entrambi i valori contano.
Niente cifre iniziali. Nomi di colonna come \"2024-sales\" si rompono in molti dialetti SQL e in alcuni strumenti di BI. Preferisci sales_2024.
Stabili e per esteso. Un'intestazione è un'API: abbreviare \"qty\" va bene, ma \"q\" confonderà qualcuno tra sei mesi. Scegli parole intere una volta sola e riutilizzale in tutti i file.

Una cosa da non temere: i nomi di intestazione non ASCII. Se le tue colonne sono product_name ed etichette giapponesi come \"商品名\", UTF-8 le gestisce benissimo (la Decisione 6 copre la codifica). Il motore scrive le celle di intestazione con le stesse regole di quotatura delle celle di dati, quindi anche un'intestazione contenente una virgola o un apice viene protetta correttamente — abbiamo verificato la logica di escape nel sorgente; la quotatura si applica per cella, intestazioni incluse.

Decisione 3: scegli il delimitatore con intenzione

La virgola è il delimitatore predefinito e per la maggior parte dei file è quello giusto. Ma il delimitatore non è una formalità: è il carattere in base al quale viene analizzato l'intero file. Il convertitore offre virgola, punto e virgola, tabulazione, pipe e personalizzato, ed ecco quando ciascuno merita il suo posto:

Virgola: il predefinito. Usala a meno che tu non abbia un motivo per non farlo. Ogni strumento la legge.
Punto e virgola: quando i dati sono pieni di virgole. Le esportazioni europee lo usano molto — non a caso, perché molte impostazioni locali europee usano la virgola come separatore decimale, quindi un file delimitato da virgole sarebbe ambiguo. Se i tuoi campi di testo sono pieni di virgole, il punto e virgola mantiene le celle leggibili senza affidarsi alla quotatura.
Tabulazione: quando degli esseri umani leggeranno il file grezzo. I valori separati da tabulazione si incollano direttamente nei fogli di calcolo e restano leggibili in un editor di testo. Utile per i flussi di copia-incolla.
Pipe: quando il testo contiene virgole, apici E punti e virgola — messaggi di log, indirizzi, prosa. La pipe è rara nel testo naturale, quindi collide raramente.

La verità onesta: la quotatura esiste proprio per rendere sopravvivibile la scelta del delimitatore. Quando una cella contiene il delimitatore, il motore la racchiude automaticamente tra virgolette (Decisione 4), quindi un indirizzo pieno di virgole in un file delimitato da virgole viene comunque analizzato. La scelta del delimitatore riguarda la leggibilità e le abitudini del tuo pubblico, non la correttezza — la correttezza è compito del motore di quotatura. Un vero avvertimento, però: se scegli il punto e virgola per un pubblico in USA o Regno Unito, diglielo — il loro Excel potrebbe aspettarsi per impostazione predefinita le virgole e aprire il tuo file come un'unica lunga colonna.

Decisione 4: lascia la quotatura automatica

La quotatura è la parte più fraintesa del CSV. La regola è semplice: una cella che contiene il delimitatore, un carattere di virgoletta o un'interruzione di riga deve essere racchiusa tra doppi apici, e ogni apice al suo interno deve essere raddoppiato. Ecco cosa produce davvero il motore — verificato, non illustrato:

Quotatura in azione (verificata contro il motore reale)

name,city,qty
"Say ""hi"", friend",Oslo,3

Leggilo con attenzione: la cella Say \"hi\", friend è diventata \"Say \"\"hi\"\", friend\" — racchiusa tra virgolette perché contiene una virgola, e i suoi apici interni sono stati raddoppiati. Questo è l'output corretto, conforme agli standard, e ogni vero programma di fogli di calcolo lo analizza restituendo esattamente il testo originale.

Decisione 4: lascia la quotatura automatica (continua)

Cambia il delimitatore in punto e virgola e guarda come si adatta la quotatura:

Stessi dati, delimitatore punto e virgola (verificato)

name;city;qty
"Say ""hi"", friend";Oslo;3

La virgola non fa più scattare la protezione, ma il carattere di virgoletta sì — il motore quota in base al delimitatore effettivamente in uso, non in base a un'idea fissa di ciò che è \"speciale\". Questa consapevolezza per-delimitatore è ciò che significa \"automatico\", ed è l'impostazione che dovresti lasciare in pace. Il motore offre anche le modalità di quotatura always e never; never è una trappola, ed ecco la prova:

Decisione 4: lascia la quotatura automatica (continua)

quoteMode \"never\" — la trappola (verificata)

note,code
line1
line2,007

Con la quotatura disabilitata, una cella contenente una vera interruzione di riga resta grezza — e quell'interruzione di riga ora sembra un confine di riga per ogni parser sulla Terra. Il tuo file da 2 righe viene letto come 3 righe, una delle quali spazzatura. Gli apici vengono comunque raddoppiati (il motore lo fa incondizionatamente), ma nulla viene racchiuso. Usa \"never\" solo quando un sistema a valle richiede esplicitamente un output senza virgolette e hai verificato che nessuna delle tue celle contenga delimitatori, apici o interruzioni di riga. In ogni altro caso: automatico.

Decisione 5: rendi i valori testo nel modo in cui vuoi vederli

Il JSON ha i tipi — numeri, booleani, null. Il CSV ha esattamente un tipo: il testo. Il momento della conversione è quando ogni valore diventa la sua forma testuale finale, e questa è la decisione che la maggior parte delle persone non prende mai consapevolmente. Tre forme di valore meritano la tua attenzione:

Primo, gli zeri iniziali. Una stringa JSON come \"007\" resta 007 nel CSV — l'abbiamo verificato, senza virgolette, esattamente come digitata. Ma aprire quel file in Excel mostrerà comunque 7, perché Excel reinterpreta le celle all'apertura. Il CSV è corretto; il visualizzatore è supponente. Se gli zeri iniziali devono sopravvivere a Excel, la soluzione è sul lato ricevente (importa come testo), non nel file — sappilo prima di dare la colpa al convertitore.

Secondo, le date. Il JSON non ha un tipo data, quindi le tue \"date\" sono stringhe come 2026-10-14 o timestamp come 1697000000. Qualunque forma converti è la forma che il CSV mantiene, quindi scegli quella leggibile dall'uomo prima di esportare: la ISO 2026-10-14 si ordina correttamente come testo; 10/14/2026 no, e verrà letta male da mezzo mondo. Prendi la decisione nel JSON, non dopo che il CSV esiste.

Terzo, decimali e booleani. Un numero come 19.99000001 diventa esattamente quel testo; i booleani diventano true/false. Se i tuoi dati sorgente hanno rumore di float, arrotonda prima della conversione — il CSV non arrotonderà per te.

Decisione 6: scegli UTF-8 deliberatamente — e conosci la questione BOM

La codifica è la decisione che nessuno prende finché il mojibake non la impone. UTF-8 è la risposta nel 2026: trasporta ogni lingua, e ogni strumento moderno la legge. La sottigliezza è il BOM — l'invisibile marchio di ordine dei byte che alcuni strumenti Windows vogliono all'inizio del file.

Ecco il fatto onesto sul convertitore di questo sito: il download è UTF-8 puro, senza BOM — abbiamo letto il codice di download, che crea un Blob text/csv con charset=utf-8 e senza marchio iniziale. È corretto per caricamenti web, database, Fogli Google e Python. L'unico punto in cui morde: il doppio clic sul file in alcune versioni di Excel per Windows, che potrebbe indovinare la codifica sbagliata e storpiare i caratteri non ASCII.

La soluzione non è pretendere un BOM dal convertitore — è un'importazione da 20 secondi: in Excel, Dati → Da testo/CSV → scegli 65001 (UTF-8) nel menu a discesa della codifica. I tuoi caratteri escono perfetti e il file resta pulito per ogni altro strumento. Decidi la codifica una volta per flusso di lavoro e documentala accanto al file; le sorprese di codifica sono sempre un fallimento di comunicazione, mai un fallimento di dati.

Decisione 7: convalida il file finito prima che lasci le tue mani

La creazione finisce con un controllo, e richiede meno di un minuto. Quattro passaggi:

Aprilo prima in un editor di testo, non in un foglio di calcolo. Un editor di testo ti mostra il file; un foglio di calcolo ti mostra la sua interpretazione. Verifica la riga di intestazione, il delimitatore e che le celle quotate sembrino sensate.
Conta le righe. Il motore riporta conteggi di righe e colonne nelle sue statistiche — confrontali con la lunghezza del tuo array JSON. Una discrepanza significa una sorpresa di analisi (di solito un'interruzione di riga non quotata in modalità quoteMode \"never\", o JSON di input malformato).
Reimportalo. Incolla di nuovo il CSV o aprilo nello strumento a cui lo stai inviando. Se lì si apre correttamente, si aprirà correttamente per il destinatario.
Controlla i bordi: prima riga, ultima riga e una riga con i caratteri più strani. La corruzione si concentra ai confini.

Questa checklist è anche la risposta a \"perché il mio CSV sembra rotto\": nella nostra esperienza nove volte su dieci è il visualizzatore o le impostazioni di importazione, e il file stesso la decima. L'abitudine di aprire prima l'editor di testo è ciò che distingue i due in pochi secondi.

La ricetta da 60 secondi, con tutte e sette le decisioni

Incolla o carica il tuo JSON nel convertitore. Lascia attivo l'appiattimento e dai un'occhiata all'anteprima delle colonne — quei nomi puntati sono le tue intestazioni, quindi rinomina prima nel sorgente le chiavi problematiche. Mantieni il delimitatore virgola a meno che il testo non sia pieno di virgole (allora punto e virgola). Lascia la quotatura automatica. Fai in modo che date e numeri appaiano come vuoi vederli in testo semplice prima di convertire. Scarica il file UTF-8, aprilo una volta in un editor di testo, reimportalo dove deve andare. Fatto — un file creato, non meramente convertito.

Apri il convertitore gratuito da JSON a CSV

Guide correlate

Domande frequenti

Come si crea un file CSV da JSON?

Incolla o carica il tuo JSON in un convertitore, appiattisci i dati annidati in colonne, controlla i nomi delle intestazioni e il delimitatore, poi scarica. La checklist completa: appiattisci prima, dai alle colonne nomi senza spazi, mantieni il delimitatore virgola a meno che i dati non siano pieni di virgole, lascia la quotatura automatica, formatta date e numeri come il testo che vuoi vedere, scarica in UTF-8 e reimporta il file una volta per convalidarlo.

Qual è il miglior delimitatore per un CSV creato da JSON?

La virgola è il predefinito e la scelta giusta per la maggior parte dei file. Usa il punto e virgola quando i campi di testo sono pieni di virgole (comune nelle esportazioni europee, dove la virgola è anche il separatore decimale), la tabulazione per la leggibilità del copia-incolla e la pipe quando il testo contiene virgole, apici e punti e virgola. Una quotatura corretta fa sì che qualsiasi opzione venga analizzata in sicurezza — la scelta riguarda le abitudini del tuo pubblico, non la correttezza.

Come dovrei chiamare le colonne CSV create da JSON?

Tratta i nomi di intestazione come un contratto: niente spazi (order_id, non \"order id\"), niente duplicati, niente cifre iniziali (sales_2024, non 2024-sales) e parole intere invece di abbreviazioni criptiche. Le chiavi annidate appiattite escono già come nomi puntati senza spazi come customer.name — di solito solo le chiavi di primo livello richiedono attenzione.

Perché il mio CSV si apre male in Excel dopo averlo creato da JSON?

Nove volte su dieci il file è a posto ed è il visualizzatore il problema. Cause comuni: Excel che indovina il delimitatore sbagliato (un file con punto e virgola aperto come virgola), codifica indovinata male sul testo non ASCII (reimporta via Dati → Da testo/CSV con 65001 UTF-8), o Excel che reinterpreta le celle (elimina gli zeri iniziali come 007, o riformatta le date). Apri prima il file in un editor di testo — se lì sembra giusto, il file è giusto.

Servono le virgolette attorno a ogni cella in un CSV?

No — la quotatura automatica (quando serve) è corretta e sufficiente: le celle contenenti il delimitatore, apici o interruzioni di riga vengono racchiuse tra doppi apici, con gli apici interni raddoppiati. \"Always\" aggiunge rumore, e \"never\" è pericoloso: un'interruzione di riga non quotata dentro una cella sembra un confine di riga per ogni parser e corrompe silenziosamente il conteggio delle righe.

Il mio CSV da JSON dovrebbe avere un BOM?

Di solito no. Un file UTF-8 senza BOM funziona ovunque: database, caricamenti web, Fogli Google, Python. Alcune versioni di Excel per Windows leggono male i file senza BOM al doppio clic — la soluzione è un'importazione corretta (Dati → Da testo/CSV, codifica 65001) piuttosto che aggiungere un BOM, che può confondere altri strumenti. Il convertitore di questo sito scarica UTF-8 puro senza BOM.

Come controllo che il CSV generato sia corretto?

Quattro passaggi rapidi: aprilo in un editor di testo (non in un foglio di calcolo) per vedere il file reale, confronta il conteggio delle righe con la lunghezza del tuo array JSON, reimportalo nello strumento a cui lo stai inviando e ispeziona la prima riga, l'ultima riga e la riga con i caratteri più strani. La corruzione si concentra ai confini — se i bordi sono giusti, il file è giusto.

Crea ora il tuo CSV — appiattimento, quotatura e intestazioni gestiti per te

Incolla il JSON o carica un file: i dati annidati si appiattiscono in colonne pulite, delimitatori e quotatura sono automatici e il download è UTF-8 puro. Gratis, senza registrazione, tutto nel browser.

Apri il convertitore da JSON a CSV

Tutte le guide