Convertitore JSON in CSV

Cos'è il CSV e perché convertire da JSON?

// Input JSON
[
  { "id": 1, "name": "Alice", "role": "admin" },
  { "id": 2, "name": "Bob", "role": "editor" }
]

// Output CSV (RFC 4180 preset: comma + CRLF + no BOM)
id,name,role
1,Alice,admin
2,Bob,editor

// Same input with Stringify mode + nested data
[
  { "id": 1, "tags": ["a", "b"] }
]

// Becomes
id,tags
1,"[""a"",""b""]"

Funzionalità Principali

Esempi

[{"id":1,"name":"Alice Chen","email":"alice@example.com","role":"admin"},{"id":2,"name":"Bob Garcia","email":"bob@example.com","role":"editor"},{"id":3,"name":"Carol Singh","email":"carol@example.com","role":"viewer"},{"id":4,"name":"Dan Müller","email":"dan@example.com","role":"viewer"}]

[{"id":1001,"title":"Bug: login redirects to 404","state":"open","labels":["bug","priority:high"],"user":{"login":"alice"}},{"id":1002,"title":"Feature: dark mode toggle","state":"open","labels":["enhancement"],"user":{"login":"bob"}},{"id":1003,"title":"Docs: update README","state":"closed","labels":["docs","good-first-issue"],"user":{"login":"carol"}}]

[{"_id":{"$oid":"6634a1b2c3d4e5f600000001"},"email":"alice@example.com","metadata":{"signupDate":"2026-01-15T10:30:00Z","preferences":{"newsletter":true,"theme":"dark"}}},{"_id":{"$oid":"6634a1b2c3d4e5f600000002"},"email":"bob@example.com","metadata":{"signupDate":"2026-02-20T14:15:00Z","preferences":{"newsletter":false,"theme":"light"}}}]

{"event":"signup","user":"alice","ts":1715000000}
{"event":"login","user":"alice","ts":1715000060}
{"event":"checkout","user":"alice","ts":1715000300}

[{"id":"ord-001","customer":{"name":"Alice Chen","email":"alice@example.com","address":{"city":"Seattle","country":"US"}},"items":[{"sku":"SKU-100","qty":2},{"sku":"SKU-205","qty":1}]},{"id":"ord-002","customer":{"name":"Bob Garcia","email":"bob@example.com","address":{"city":"Madrid","country":"ES"}},"items":[{"sku":"SKU-100","qty":1}]}]

[{"name":"GET /users returns 200","status":"pass","duration":142},{"name":"POST /users creates record","status":"pass","duration":287},{"name":"GET /users/999 returns 404","status":"fail","duration":98,"error":"Expected 404, got 500"},{"name":"DELETE /users/1 returns 204","status":"pass","duration":156}]

Come Usarlo

1. 1

   Incolla il tuo JSON

   Inserisci o incolla il tuo JSON nel campo di input qui sopra. Lo strumento accetta array di oggetti, singoli oggetti e NDJSON (JSON delimitato da righe) — rilevato automaticamente. Puoi anche cliccare «Carica esempio» per provare un campione come una risposta REST API, un export MongoDB o un log eventi NDJSON.

2. 2

   Scegli un preset (o regola le Opzioni)

   Clicca RFC 4180 (predefinito), Excel (punto e virgola EU + BOM), TSV (Tab) o Pipe per impostare un formato di destinazione con un clic. Apri il pannello Opzioni per il controllo fine: Delimitatore, Header, Quote (Auto/Always), Fine riga (LF/CRLF), BOM e Nidificato (Flatten/Stringify).

3. 3

   Copia o scarica il CSV

   Clicca Copia per copiare il CSV negli appunti, o Scarica per salvarlo come file .csv (.tsv con il preset TSV) pronto per Excel, Google Sheets, PostgreSQL COPY o qualsiasi pipeline di dati. Per i round-trip, clicca Inverti direzione per riconvertire il CSV in JSON sul posto.

Insidie Comuni di Conversione

42

[{"value": 42}]

[
  {"name": "GET /users", "status": "pass"},
  {"name": "GET /users/999", "status": "fail", "error": "500"}
]

// Output CSV (note empty cell in row 1)
name,status,error
GET /users,pass,
GET /users/999,fail,500

{"id": 9007199254740993}
// JavaScript reads as 9007199254740992 (precision lost)

{"id": "9007199254740993"}
// CSV preserves the string; Excel displays exactly

name,role
Smith, Jr.,admin
// Parser reads 3 columns: "Smith", " Jr.", "admin"

name,role
"Smith, Jr.",admin
// Parser reads 2 columns: "Smith, Jr.", "admin"

id,name,price
1,Alice,1,234.56
// Excel-EU mis-parses 1,234.56 as two columns

// Excel preset output: ; + CRLF + BOM
id;name;price
1;Alice;1234,56
// Excel-EU reads cleanly with comma decimal

[
  {"event": "signup"},
  {"event": "login"}
]
// Detected as a regular JSON array (works, but not NDJSON path)

{"event": "signup"}
{"event": "login"}
// Each line is one JSON value — auto-detected as NDJSON

Casi d'Uso Comuni

Risposta API in foglio di calcolo

Incolla una risposta REST API (array di oggetti utente/ordine/evento) e ottieni un CSV tabellare pulito pronto per Excel, Google Sheets o Numbers. Il caso d'uso più comune — analisti e PM hanno bisogno di dati a forma di foglio di calcolo, gli ingegneri spediscono JSON dal backend.

Export MongoDB in data warehouse

Converti l'output JSON di mongoexport (con wrapper $oid e documenti metadata nidificati) in CSV per il caricamento in BigQuery, Snowflake o Redshift. La modalità Stringify preserva la forma nidificata senza perdita quando gli strumenti a valle supportano JSON-in-cella.

Triage delle issue GitHub

Scarica le issue da /repos/{owner}/{repo}/issues, incolla il JSON e ottieni un CSV piatto con id, title, state, labels e user.login come colonne. Caricalo in Sheets per filtrare, ordinare e assegnare durante lo sprint planning.

Revisione di log eventi NDJSON

I log in streaming da Cloud Logging, Datadog, Vector o dalla tua pipeline arrivano spesso come NDJSON (.ndjson, .jsonl). Incolla il contenuto del file direttamente — rilevato automaticamente — e ottieni un CSV per l'analisi ad-hoc senza tirare su una vera pipeline ETL.

Estrazione di ordini e-commerce

Converti il JSON di ordini nidificati (customer.address.city, array items) in un CSV piatto per finance, fulfillment o revisione antifrode. La modalità Flatten produce una colonna per campo foglia, pronta per essere caricata in Excel per la reportistica ad-hoc.

Report di test Postman/Newman

Gli export dei test Postman includono righe a forma mista (alcune con campi error opzionali). Incolla il JSON, ottieni un CSV con tutte le chiavi unite e le celle mancanti riempite — perfetto per condividere i report di test falliti con i non-ingegneri in Sheets.

Dettagli Tecnici

Parser RFC 4180 a macchina a stati

Entrambe le direzioni usano un vero parser a macchina a stati finiti che segue l'RFC 4180. Gli stati includono UnquotedField, QuotedField, AfterQuote, RowEnd e EndOfInput. Il parser gestisce correttamente i campi quotati che contengono il delimitatore, i CR/LF incorporati all'interno dei campi quotati, le virgolette doppie escapate (raddoppiate, come "") e i newline finali. Questo produce output che esegue il round-trip senza perdita attraverso il modulo csv di Python, PostgreSQL COPY, AWS S3 SELECT e qualsiasi parser conforme.

Algoritmo di rilevamento interi grandi

Prima di passare il JSON attraverso JSON.parse() (che arrotonderebbe silenziosamente gli interi grandi tramite IEEE 754), lo strumento esegue una scansione regex sul testo JSON grezzo cercando letterali interi fuori dall'intervallo sicuro (-2^53+1 a 2^53-1). Quando vengono rilevati, i percorsi dei campi interessati vengono registrati e un banner di avviso «Intero grande» compare sotto l'output. Lo scrittore CSV preserva poi questi valori come stringhe, garantendo precisione esatta attraverso Excel, Google Sheets e qualsiasi consumatore a valle che gestisce il testo.

BOM e codifica UTF-8 per Excel

Tutto l'input e l'output è UTF-8. Il BOM UTF-8 opzionale (0xEF 0xBB 0xBF) viene anteposto all'output quando l'interruttore BOM è attivo o quando è selezionato il preset Excel. Excel su Windows usa il BOM per rilevare la codifica UTF-8 — senza di esso, Excel ricade sulla locale di sistema (Windows-1252 negli USA, Windows-1251 in Russia, ecc.) e mangia i caratteri non-ASCII. I parser moderni (Python csv, Pandas, jq, PostgreSQL) generalmente non hanno bisogno del BOM e potrebbero includerlo come carattere sparso all'inizio della prima cella, quindi lascia il BOM disattivato per le pipeline non-Excel.

Buone Pratiche

Scegli un preset prima di regolare le opzioni

I preset RFC 4180, Excel, TSV e Pipe impostano cinque opzioni in una volta sola (delimitatore, fine riga, modalità quote, BOM, header). Scegli prima il preset più vicino, poi regola le singole opzioni solo se necessario — questo evita l'errore comune di cambiare un'opzione e dimenticarne un'altra (ad esempio, passare al punto e virgola ma lasciare LF, che Excel-EU su Windows analizza ancora male).

Flatten per l'analisi, Stringify per i round-trip

Usa Flatten quando la destinazione è Excel, Sheets o un'analisi una tantum — le chiavi puntate producono la disposizione più pulita in foglio di calcolo. Usa Stringify quando hai bisogno di un round-trip CSV → JSON → CSV senza perdita di dati — array e oggetti sopravvivono come JSON in una singola cella. Cambiare a metà export e rieseguire costa poco; scegli in base al consumatore.

Usa il BOM solo per Excel

Il BOM UTF-8 è richiesto da Excel su Windows per rilevare correttamente la codifica. Ogni altro parser (Python csv, Pandas, jq, PostgreSQL COPY, BigQuery) ignora il BOM o lo include come carattere sparso all'inizio della prima cella, rompendo i nomi delle colonne. Lascia il BOM disattivato per le pipeline e attivalo (o usa il preset Excel) solo quando la destinazione è Excel.

Mantieni gli ID grandi come stringhe nel JSON

Gli ID snowflake di Twitter, gli ID di Discord, i campi MongoDB Long e il resourceVersion di K8s sono interi a 64 bit che superano l'intervallo sicuro di JavaScript (2^53 - 1). Memorizzali come stringhe JSON ("id": "9007199254740993") prima di convertire — il CSV preserverà esattamente le cifre, mentre un letterale numerico verrebbe arrotondato silenziosamente da JSON.parse().

Valida la forma delle righe prima di caricare

Le righe a forma mista (alcuni oggetti con chiavi che altri non hanno) vengono unite con celle vuote nell'output, e lo strumento mostra un avviso nelle note di schema. Per i consumatori a schema rigoroso (BigQuery, Redshift COPY), valida che tutte le righe condividano le stesse chiavi prima di esportare — oppure gestisci esplicitamente i valori mancanti nella tua pipeline. Usa il nostro Formattatore JSON per ispezionare prima la forma dell'input.

Domande Frequenti