PK Systems PK Systems
Strumenti per sviluppatori

Convertitore JSON ↔ CSV

Trasforma un array JSON in un CSV pulito (o viceversa). Scegli un delimitatore, appiattisci oggetti annidati con la dot-notation, attiva o disattiva la riga di intestazione.

Convertitore JSON ↔ CSV

Output

L'output appare qui mentre digiti o incolli.

Cosa fa questo convertitore

JSON e CSV sono i due formati più spesso scambiati tra API, fogli di calcolo, job ETL e dashboard. JSON mantiene tipi e nidificazione; CSV è piatto e amico di Excel, Google Sheets, tool BI e della maggior parte dei data warehouse. Questo convertitore va in entrambe le direzioni. JSON a CSV prende un array di oggetti ed emette una riga per oggetto, con intestazioni di colonna costruite dall'unione di ogni chiave incontrata. Gli oggetti annidati vengono appiattiti con la dot-notation (user.city), così non perdi informazioni. Gli array vengono emessi nella loro forma JSON-encoded di default. CSV a JSON fa il viaggio inverso: interpreta i campi con virgolette in stile RFC 4180 (virgolette doppie escapate, a capo incorporati), converte true, false, null e numeri puri ai loro valori JSON tipizzati e ricostruisce gli oggetti annidati a partire da chiavi puntate trovate nell'intestazione. L'intera conversione gira in locale sul tuo dispositivo — i tuoi dati non lasciano mai il browser, non viaggiano mai sui nostri server e non vengono memorizzati, indicizzati, registrati o condivisi. Questa garanzia di privacy conta per il tipo di dati che le persone passano più spesso a un convertitore: risposte API con PII, esportazioni di clienti, analytics interni, qualsiasi cosa proveniente da un database di produzione.

Come usarlo

Scegli una direzione, scegli un delimitatore, incolla i tuoi dati e l'output si aggiorna live.

  1. Scegli la direzione — Usa JSON → CSV quando hai una risposta API o un export JSON e vuoi un foglio di calcolo. Usa CSV → JSON quando hai esportato una tabella da Excel, Sheets o un database e vuoi dati strutturati.
  2. Scegli un delimitatore — La virgola è il default universale. Usa il punto e virgola per gli export Excel europei, Tab per i dati copiati da Excel/Sheets, oppure pipe per i file di log dove le virgole compaiono già nei dati.
  3. Decidi sull'appiattimento — Lascia Appiattisci oggetti annidati attivo se il tuo JSON ha dati annidati — otterrai colonne come address.city e address.zip. Disattivalo se preferisci incorporare gli oggetti annidati come stringhe JSON dentro una sola cella CSV.
  4. Copia o reincolla — Usa il pulsante di copia per portare il risultato negli appunti. Il CSV si incolla direttamente in Excel, Sheets o in un editor di codice; il JSON si incolla in Postman, nel tuo IDE o ovunque ci si aspetti un body JSON.

Regole di escape e quoting

Il CSV non ha una singola specifica ufficiale, ma la RFC 4180 cattura le regole di consenso che ogni parser moderno segue. Un campo viene avvolto tra virgolette doppie se e solo se contiene un delimitatore, una virgoletta doppia, un a capo o un ritorno carrello. Dentro un campo tra virgolette, le virgolette doppie vengono escapate raddoppiandole (say "hi" diventa "say ""hi"""). Gli a capo dentro un campo tra virgolette vengono mantenuti come a capo letterali — il parser conta le virgolette non escapate per sapere se è ancora dentro un campo. I valori null e undefined diventano celle vuote, il che significa che un round-trip JSON → CSV → JSON non può distinguere stringa vuota da null. Numeri, booleani e il letterale null vengono riconosciuti durante la conversione CSV → JSON, quindi una cella CSV contenente true diventa un booleano JSON.

Come vengono escapati i valori

Alcuni esempi che mostrano cosa fa il convertitore in casi insidiosi. Il delimitatore in questi esempi è la virgola.

Valore di input Cella CSV
hellohello
a,b"a,b"
say "hi""say ""hi"""
line1\nline2"line1\nline2"
null(vuoto)
{a: 1, b: 2}1,2 con appiattimento attivo

Domande frequenti

I miei dati vengono caricati da qualche parte?

No. La conversione avviene interamente nel tuo browser. La pagina non importa alcuna libreria CSV di terze parti — il parser e il serializzatore fanno parte della pagina stessa. Apri DevTools → Network e non vedrai partire alcuna richiesta quando incolli o converti.

Cosa succede se i miei oggetti hanno chiavi diverse?

La riga di intestazione è l'unione di ogni chiave vista in tutti gli oggetti, in ordine di prima apparizione. Le righe a cui manca una chiave producono una cella vuota per quella colonna. È così che Pandas, gli import di Excel e la maggior parte degli ETL gestiscono la stessa situazione.

Come vengono esportati gli array dentro JSON?

Gli array vengono serializzati in JSON dentro una singola cella CSV, quindi un oggetto come {tags: ["a","b"]} diventa una cella con il testo letterale ["a","b"]. Questo preserva tutti i dati ma non è ottimo per i pivot del foglio — se ti serve una riga per tag, espandi l'array a mano prima di convertire.

Perché il mio file Excel europeo si apre come una sola colonna?

Excel in molte locale europee usa il punto e virgola come delimitatore CSV così la virgola può restare libera per i decimali. Passa al chip ; nel convertitore e il file farà il round-trip in modo pulito.

CSV → JSON rileva numeri e booleani?

Sì. Le celle il cui contenuto è interamente un numero, true, false o null vengono convertite al tipo JSON corrispondente. Tutto il resto resta una stringa. Gli zeri iniziali sono tenuti come stringhe per evitare di rovinare numeri di telefono e CAP.

Posso usarlo per file molto grandi?

Fino a qualche megabyte, sì. Oltre, la scheda del browser potrebbe rallentare perché tutto avviene in modo sincrono sul thread principale. Per esportazioni da centinaia di megabyte usa un tool da riga di comando in streaming come jq, csvkit o miller.