Come fare JSON to CSV online: fallo in questa scheda in 30 secondi (Guida 2026)

Il percorso di 30 secondi, clic dopo clic

Hai cercato una query abbreviata, quindi ecco la risposta abbreviata, con ogni clic indicato per nome. Primo passo: scorri fino al convertitore in cima a questa pagina. Vedrai due caselle affiancate. Quella di sinistra si chiama Input JSON e il suo segnaposto dice Paste raw JSON data here or drag and drop a .json file. Fai clic al suo interno e incolla il tuo JSON con Ctrl+V o Cmd+V.

Il secondo passo non è affatto un clic, perché Auto Convert è attivato per impostazione predefinita. Nel momento in cui incolli, la casella di destra, denominata Output CSV, si riempie con il risultato convertito, e il badge di stato sopra la casella di sinistra passa da Ready a Valid (N rows), dove N è il numero delle tue righe. Se mai disattivi Auto Convert, il pulsante Convert to CSV nella barra delle impostazioni svolge lo stesso compito su richiesta.

Terzo passo: fai clic su Download .csv nell’angolo in alto a destra della casella Output CSV. Il file viene scaricato immediatamente, con il nome data-export-YYYY-MM-DD.csv e la data di oggi, come semplice testo UTF-8. Aprilo in Excel, Fogli Google o qualsiasi editor di testo. Non c’è alcuna registrazione, alcun caricamento e alcuna sala d’attesa: la conversione avviene sul tuo computer, all’interno di questa scheda del browser.

Questo è l’intero percorso, ed è quello giusto per una conversione occasionale. Il resto di questa guida esiste per i tre momenti in cui le persone si bloccano: non sapere cosa conta come JSON incollabile, non fidarsi del risultato e trovarsi di fronte al badge rosso Invalid JSON. Ognuno di questi intoppi ha una soluzione breve e concreta qui sotto.

Cosa incollare: quattro forme che funzionano tutte

Il convertitore accetta più forme di quante la maggior parte delle persone si aspetti, e conoscerle ti risparmia un giro di riformattazione. La forma più comune è un array di oggetti: un elenco racchiuso tra parentesi quadre, in cui ogni elemento è una riga. Incollalo e ogni oggetto diventa una riga, con la riga di intestazione ricavata dall’unione di tutte le chiavi trovate in qualsiasi punto dei dati.

La seconda forma è un singolo oggetto, senza alcuna parentesi quadra. Incolla un oggetto solo e ottieni un CSV di una riga: le chiavi diventano la riga di intestazione e i valori diventano l’unica riga di dati. La terza forma è la risposta API incapsulata, in cui l’array si trova sotto una chiave, come {"users": [...]}. Il convertitore trova il primo array di oggetti di livello superiore e converte quello, così puoi incollare la risposta API grezza senza scartarla a mano.

La quarta forma è JSON Lines, detta anche NDJSON: un oggetto JSON per riga, senza virgole né parentesi esterne. Incollala e ogni riga diventa una riga del CSV. E se incolli un semplice array di valori puri, come ["apple", "banana", "cherry"], ottieni due colonne, index e value, numerate a partire da uno. Tutte e cinque le forme descritte qui sono state eseguite nel vero motore del convertitore prima della pubblicazione di questa guida, quindi gli output sono esatti.

L’esempio pratico qui sotto è la forma incapsulata, perché è quella che confonde di più: due utenti, ciascuno con un oggetto address annidato e un elenco tags. Con le impostazioni predefinite, l’indirizzo viene appiattito in address.city e address.zip, e l’elenco tags viene unito in una sola cella con un punto e virgola seguito da uno spazio.

Try it: the wrapped users file, and what the converter returns (verified)

{
  "users": [
    { "id": 1, "name": "Ana", "address": { "city": "Lima", "zip": "15001" }, "tags": ["new", "vip"] },
    { "id": 2, "name": "Ken", "address": { "city": "Osaka", "zip": "530-0001" }, "tags": ["new"] }
  ]
}

# Output CSV, default settings (verified):
# id,name,address.city,address.zip,tags
# 1,Ana,Lima,15001,new; vip
# 2,Ken,Osaka,530-0001,new

Il controllo di 10 secondi prima di scaricare

Prima di fare clic su Download .csv, dedica dieci secondi a quattro controlli. Individuano ogni sorpresa comune mentre la soluzione è ancora a un clic di distanza. Primo, leggi il badge di stato: dovrebbe dire Valid (N rows), con N uguale al numero di record che hai incollato. Se N è uno e hai incollato cinquanta record, il convertitore ha visto un oggetto solo, non cinquanta, e probabilmente hai incollato una risposta incapsulata con una forma inattesa.

Secondo, leggi la riga di intestazione nella casella Output CSV. Dovrebbe indicare le colonne che ti aspetti. Una colonna chiamata address quando ti aspettavi address.city significa che Flatten Nested Objects è disattivato, e questo è trattato nella sezione sulle impostazioni qui sotto. Terzo, leggi una cella annidata: se un elenco che ti aspettavi di vedere come new; vip appare come testo JSON con virgolette raddoppiate, anche in questo caso l’appiattimento è disattivato.

Quarto, dai un’occhiata alle statistiche di output sotto la casella del CSV: righe, colonne, dimensione del file e tempo di conversione. Righe e colonne dovrebbero corrispondere all’immagine che hai in mente dei dati, e il tempo di conversione per i file ordinari è di pochi millisecondi, quindi un valore elevato indica un file insolitamente grande, non uno strumento lento. L’output si apre in Table View per impostazione predefinita, che è la vista più comoda per questi controlli; Raw CSV mostra gli stessi dati come testo semplice, esattamente come appariranno nel file scaricato.

Se tutti e quattro i controlli vanno a buon fine, scarica. Se uno fallisce, la soluzione sta nelle impostazioni o nel JSON stesso, ed entrambe sono trattate di seguito. L’abitudine da costruire è questa: prima controlla, poi scarica. Ci vogliono dieci secondi ed è la differenza tra un CSV che si apre correttamente al primo tentativo e uno che devi convertire due volte.

Impostazione 1: Flatten Nested Objects

La barra delle impostazioni sopra le due caselle contiene tre interruttori e un menu a discesa per il delimitatore, e tutti e tre gli interruttori partono attivati. Il primo interruttore, Flatten Nested Objects, cioè Appiattisci oggetti annidati, è quello che cambia di più il risultato. Quando è attivato, gli oggetti annidati diventano colonne con notazione a punti: address diventa address.city e address.zip, e ogni valore finisce in una vera colonna che puoi ordinare e filtrare.

Quando è disattivato, i valori annidati restano esattamente come sono: l’oggetto address finisce in un’unica cella address come testo JSON, e l’elenco tags finisce in un’unica cella tags come array JSON. Le virgolette raddoppiate che vedi in quell’output non sono un danneggiamento; sono l’escaping CSV che fa il suo lavoro, perché una cella che contiene virgolette deve raddoppiarle e racchiudere l’intera cella tra virgolette. I dati sono intatti, ma non è una tabella che puoi filtrare, ed è per questo che l’appiattimento resta attivo per quasi ogni conversione.

Lo stesso file con l’appiattimento disattivato è mostrato qui sotto, così puoi riconoscere la differenza a colpo d’occhio. Se il tuo CSV risulta pieno di testo {"city": ...}, la causa è questo interruttore, e riattivarlo è l’intera soluzione. La nostra guida su come appiattire JSON in CSV documenta l’interruttore cella per cella, compresi i casi limite in cui lasciarlo disattivato è la scelta giusta.

Same file, Flatten Nested Objects switched off (verified)

# Output CSV, flattening off (verified):
# id,name,address,tags
# 1,Ana,"{""city"":""Lima"",""zip"":""15001""}","[""new"",""vip""]"
# 2,Ken,"{""city"":""Osaka"",""zip"":""530-0001""}","[""new""]"

Impostazione 2: Delimiter

Il menu a discesa Delimiter, cioè Delimitatore, sceglie il carattere tra le colonne: Comma (,), Semicolon (;), Tab o Pipe (|). Comma, la virgola, è l’impostazione predefinita, ed è la scelta giusta a meno che il tuo foglio di calcolo non si aspetti qualcos’altro. Cambialo solo quando hai un motivo, perché il delimitatore è l’impostazione che più probabilmente produce un CSV che sembra rotto nel programma successivo.

Il sintomo classico è un file che si apre in Excel come un’unica colonna alta: ogni riga c’è, ma tutti i valori sono stipati nella colonna A. Significa che il delimitatore del file e il delimitatore che Excel si aspetta non coincidono. La soluzione è scaricare di nuovo con Delimiter impostato su Comma, oppure aprire il file tramite Dati di Excel, Da testo/CSV, dove puoi scegliere il delimitatore in modo esplicito invece di lasciare che sia Excel a indovinarlo.

Vale la pena conoscere una sottigliezza. Quando passi a Semicolon, il punto e virgola, qualsiasi cella che a sua volta contiene un punto e virgola viene racchiusa automaticamente tra virgolette, così il file resta analizzabile. La cella tags new; vip diventa "new; vip" nella versione con punto e virgola qui sotto. Quella quotatura è CSV corretto, e ogni foglio di calcolo la rilegge come il singolo valore new; vip. Non togliere le virgolette a mano; sono portanti.

Same file, Delimiter set to Semicolon (verified)

# Output CSV, semicolon delimiter (verified):
# id;name;address.city;address.zip;tags
# 1;Ana;Lima;15001;"new; vip"
# 2;Ken;Osaka;530-0001;new

Impostazione 3: Include Headers

Il terzo interruttore, Include Headers, cioè Includi intestazioni, controlla se la prima riga del CSV nomina le colonne. Lascialo attivo, che è l’impostazione predefinita, e la prima riga sarà id,name,address.city,address.zip,tags. Disattivalo e lo stesso file restituisce solo le due righe di dati, senza alcuna riga di intestazione: 1,Ana,Lima,15001,new; vip e poi 2,Ken,Osaka,530-0001,new.

Intestazioni disattivate è un’impostazione di nicchia, ed esiste per una sola situazione: l’aggiunta a un CSV esistente che ha già una riga di intestazione. Se incolli un secondo gruppo di record in un file che nomina già le sue colonne, una seconda riga di intestazione nel mezzo lo danneggerebbe, quindi converti il nuovo gruppo senza intestazioni e accodi le righe nude. Per ogni altra situazione, tieni le intestazioni attive: un CSV senza riga di intestazione è una tabella senza nomi di colonna, e la prossima persona che lo aprirà dovrà indovinare cosa significa ogni colonna.

Il quarto controllo nella barra delle impostazioni non è un interruttore ma il pulsante Convert to CSV, e conta solo quando Auto Convert è disattivato. Con Auto Convert attivo, che è l’impostazione predefinita, l’output si aggiorna mentre scrivi. Con esso disattivato, nulla viene convertito finché non premi il pulsante. Se mai incolli del JSON e l’output resta vuoto, controlla prima Auto Convert: è il motivo più comune di una casella di destra vuota, e la soluzione è un solo clic.

Quando il badge dice Invalid JSON

Se il JSON che incolli non è JSON valido, il badge di stato diventa rosso e dice Invalid JSON, e sotto la casella di input appare una riga di errore rossa con il messaggio esatto del parser. Per esempio, incollando {bad json si ottiene il messaggio Expected property name or '}' in JSON at position 1 (line 1 column 2). Incollando assolutamente nulla si ottiene Input is empty. Please paste or upload JSON data. Il messaggio ti dice dove si trova il problema, quindi leggilo prima di riscrivere qualsiasi cosa.

Tre errori causano quasi ogni badge Invalid JSON. Il primo è una virgola finale: una virgola dopo l’ultimo elemento di un oggetto o di un array, come {"id": 1,}. JSON la vieta, anche se JavaScript la consente, quindi elimina la virgola. Il secondo è l’uso di virgolette singole intorno a chiavi o stringhe: JSON richiede le virgolette doppie, quindi {'id': 1} non è valido mentre {"id": 1} è valido. Il terzo è una parentesi di chiusura mancante: un oggetto aperto con { e mai chiuso, o un array aperto con [ e mai chiuso. Conta le parentesi aperte e quelle chiuse, e di solito il divario si mostra da sé.

Una quarta causa è invisibile: le virgolette intelligenti. Se hai copiato il JSON da una pagina web, da un documento o da un messaggio di chat, le virgolette doppie dritte potrebbero essere state sostituite con quelle curve, che JSON non accetta. La soluzione è riscrivere le virgolette a mano nella casella di input, oppure passare prima per un editor di testo semplice. Una volta che il JSON è valido, il badge passa a Valid (N rows) e il CSV appare, senza bisogno di alcun altro passaggio.

Un’altra via d’uscita: la barra degli strumenti dell’input ha un pulsante Format che rende il JSON valido in forma indentata, molto più facile da leggere e da correggere in un file grande. Funziona solo su JSON valido, quindi se il badge dice Invalid JSON, correggi prima l’errore e poi formatta. E se il file proviene da altrove, prova il pulsante Upload File o il trascinamento: un file .json o .txt trascinato direttamente nella casella di input si converte allo stesso modo del testo incollato.

Se preferisci non usare questa pagina

Questa guida riguarda deliberatamente un solo percorso: il convertitore di questa pagina. Ma non è l’unico percorso, e due situazioni richiedono un percorso diverso. Se la conversione deve ripetersi — la stessa esportazione ogni mattina, o una conversione dentro un software che distribuisci — uno script batte una scheda del browser, e le nostre guide ai tre metodi affidabili e ai cinque modi per convertire trattano Python, jq, Power Query e le chiamate di libreria, tutti testati sullo stesso file.

Se vivi già in VS Code e il JSON è un file che stai modificando lì, convertire dentro l’editor ti mantiene nel contesto, e la nostra guida a VS Code illustra i percorsi tramite estensione, terminale e pressione di un tasto. Per tutto il resto — un file, una volta, proprio adesso — il percorso in cima a questa guida è il più veloce, ed è quello per cui questa pagina è stata costruita.

E se hai già usato questa pagina e sei tornato solo per verificare un dettaglio, la lista di controllo è: incolla, verifica che il badge dica Valid (N rows), verifica la riga di intestazione, scarica. Tutto il resto della pagina esiste per il giorno in cui ti servirà, non per oggi.

Guide correlate

Domande frequenti

Come converto JSON in CSV online gratis?

Apri questa pagina, incolla il tuo JSON nella casella Input JSON e fai clic su Download .csv. Il convertitore è gratuito, senza registrazione, senza limiti sui file ordinari e senza filigrana sull’output. La conversione avviene interamente nel tuo browser, quindi nulla viene caricato e nulla viene addebitato.

Come fare JSON to CSV online senza installare nulla?

Usa il convertitore di questa pagina: è un sito web, non un programma, quindi non c’è nulla da scaricare o installare. Incolla il JSON, verifica che il badge dica Valid (N rows) e scarica il CSV. Funziona in qualsiasi browser moderno su desktop o dispositivi mobili, e l’unica cosa che lascia il tuo dispositivo è assolutamente nulla, perché la conversione avviene in locale.

Posso convertire un file JSON in CSV online, non solo testo incollato?

Sì. Fai clic su Upload File nella barra degli strumenti dell’input e scegli un file .json o .txt, oppure trascina il file direttamente nella casella Input JSON. Per JSON ospitato a un URL pubblico, fai clic su Fetch URL e inserisci l’indirizzo: la pagina carica il JSON da quell’endpoint nella casella di input, e da lì la conversione è identica a quella del testo incollato.

Perché il mio CSV scaricato si apre come una sola colonna in Excel?

Il delimitatore del file e il delimitatore che Excel si aspetta non coincidono. Scarica di nuovo con Delimiter impostato su Comma, che è l’impostazione predefinita, oppure apri il file tramite Dati di Excel, Da testo/CSV, dove puoi scegliere il delimitatore in modo esplicito invece di lasciare che sia Excel a indovinarlo. Se hai convertito con Semicolon di proposito, bisogna dire a Excel di aspettarsi punti e virgola, altrimenti mostrerà l’intera riga nella colonna A.

Perché il mio CSV è pieno di testo {"city": ...}?

Flatten Nested Objects è disattivato. Con esso disattivato, gli oggetti annidati e gli elenchi restano come testo JSON dentro singole celle: sono dati intatti, ma non una tabella ordinabile. Riattiva l’interruttore e i valori annidati diventano vere colonne come address.city, con gli elenchi uniti in una sola cella. Le virgolette raddoppiate nell’output con appiattimento disattivato sono un escaping CSV corretto, non un danneggiamento.

È sicuro convertire JSON in CSV online?

Con questo convertitore, sì: funziona interamente nel tuo browser, quindi il JSON non lascia mai il tuo computer e non viene mai inviato a un server. Non c’è alcun account, alcun caricamento e alcuna copia conservata da nessuna parte. Questo non vale per ogni convertitore online, quindi la domanda merita di essere posta a qualsiasi strumento: se carica il tuo file su un server, chi gestisce quel server può vedere i tuoi dati.

Cosa faccio se il mio file JSON è troppo grande per una scheda del browser?

Una scheda del browser gestisce comodamente i file ordinari, ma per i file di decine di megabyte e oltre, passa a uno strumento che elabora in streaming: jq con il flag --stream elabora il file record per record invece di caricarlo tutto in una volta, oppure uno script Python a blocchi che legge e scrive in lotti. Anche dividere un file enorme in file più piccoli e convertire ogni parte funziona, e mantiene disponibile il percorso tramite browser.

Il tuo JSON è a 30 secondi da un CSV

Incollalo nel convertitore di questa pagina: gli oggetti annidati si appiattiscono in colonne con notazione a punti, gli elenchi si uniscono in celle pulite e il download è semplice UTF-8. Gratuito, senza registrazione, funziona interamente nel tuo browser.

Apri il convertitore JSON to CSV

Tutte le guide