Convertitore da CSV a JSON

Il CSV è un formato tabellare: ogni riga rappresenta un record e i valori sono separati da un delimitatore, di solito la virgola o il punto e virgola. Il JSON, invece, è un formato strutturato e annidabile, pensato per lo scambio di dati tra applicazioni e API. Convertire da CSV a JSON significa trasformare una tabella piatta in una collezione di oggetti, dove ogni intestazione di colonna diventa una chiave e ogni riga successiva un oggetto distinto.

La differenza strutturale è sostanziale. Il CSV non conosce tipi di dato: tutto è testo. Il JSON distingue stringhe, numeri, valori booleani e null, e permette strutture annidate. Per questo la conversione è il primo passo quando porti dati da un foglio di calcolo verso un'applicazione web o un database.

Un esempio chiarisce il concetto:

diventa un array di due oggetti, ciascuno con le chiavi nome, eta e attivo. Lo stesso flusso inverso lo trovi nel convertitore da JSON a CSV.

Il processo si svolge in tre fasi. Prima il convertitore analizza il testo CSV in ingresso e individua il delimitatore: virgola, punto e virgola o tabulazione. Poi legge la prima riga come intestazione, ricavando i nomi delle chiavi. Infine percorre le righe successive e costruisce un oggetto JSON per ognuna, abbinando ogni valore alla chiave corrispondente.

Nel mezzo si gestiscono i casi limite che rendono il CSV insidioso:

• Campi tra virgolette: un valore come "Roma, Italia" contiene una virgola che non deve essere interpretata come separatore.
• Virgolette di escape: una virgoletta interna al testo viene raddoppiata, secondo lo standard RFC 4180.
• Valori su più righe: un campo tra virgolette può contenere ritorni a capo.

Il risultato può essere prodotto in due forme. La prima è un array JSON classico, comodo da passare a un'API. La seconda è il formato NDJSON, in cui ogni oggetto occupa una riga separata, ideale per flussi di elaborazione e importazioni a blocchi. Tutta l'elaborazione avviene nel browser, quindi i dati non lasciano il tuo dispositivo.

La conversione da CSV a JSON ricorre in molti scenari quotidiani per chi lavora con i dati.

Il primo è l'importazione di dati da fogli di calcolo. Un export da Excel o da Google Fogli arriva quasi sempre in CSV, ma un'applicazione web si aspetta JSON. La conversione colma questa distanza in pochi secondi.

Il secondo è la trasformazione di risposte e payload per le API. Molti servizi accettano esclusivamente JSON nel corpo delle richieste, quindi un export di database in CSV va convertito prima dell'invio.

Il terzo è la migrazione tra sistemi diversi. Quando sposti dati da un formato a file piatto verso un archivio strutturato, il JSON funge da formato intermedio neutro e leggibile.

Accanto a questo strumento trovi conversioni affini. Se parti da YAML, usa il convertitore YAML in JSON; se i tuoi dati sono in XML, il convertitore XML in JSON segue lo stesso principio. Una volta ottenuto il JSON, il formattatore JSON lo rende leggibile con indentazione corretta.

Il CSV tratta ogni valore come testo, mentre il JSON distingue i tipi. Questa differenza richiede attenzione durante la conversione, perché il significato dei dati può cambiare.

Un numero come 42 in CSV è una semplice stringa di caratteri. Quando lo converti, puoi sceglierne l'interpretazione: lasciarlo come stringa "42" oppure trasformarlo nel numero 42. La scelta dipende da come l'applicazione di destinazione userà quel campo. Lo stesso vale per valori booleani e per i campi vuoti, che possono diventare null, stringa vuota oppure essere omessi.

Ecco come lo stesso dato può apparire dopo la conversione:

Mantenere tutto come stringa garantisce una conversione fedele e prevedibile. Convertire i tipi rende invece il JSON più ergonomico per chi lo consuma. Valuta sempre il contesto prima di scegliere, soprattutto con codici come numeri di telefono o CAP che iniziano con uno zero significativo.

Una conversione affidabile parte da un CSV ben formato. Pochi accorgimenti riducono drasticamente gli errori.

Verifica che la prima riga contenga intestazioni chiare e univoche, perché diventeranno le chiavi JSON. Evita spazi superflui e duplicati: due colonne con lo stesso nome generano chiavi in conflitto.

Controlla il delimitatore effettivo del file. In Italia molti export usano il punto e virgola al posto della virgola, perché la virgola serve come separatore decimale. Indicare il delimitatore corretto evita righe interpretate male.

Assicurati che la codifica sia UTF-8, così accenti e caratteri speciali come à, è, ò restano integri nel JSON finale.

Alcuni controlli rapidi prima di convertire:

1. Stesso numero di colonne in ogni riga.
2. Campi con virgole o ritorni a capo racchiusi tra virgolette.
3. Nessuna riga vuota di troppo in fondo al file.

Dopo la conversione, valida il risultato. Se devi rileggere il JSON o controllarne la struttura, il formattatore JSON evidenzia subito eventuali problemi di sintassi.