Come convertire un CSV in JSON: trasforma le righe del foglio di calcolo in oggetti puliti

I fogli di calcolo e il codice parlano lingue diverse. Un file CSV è perfetto per chi scorre le righe in Excel, ma nel momento in cui devi inserire quei dati in un’API, in un file di configurazione o in un’applicazione JavaScript, ciò che ti serve è il JSON. Convertire dall’uno all’altro è una parte ordinaria dello sviluppo e dovrebbe richiedere pochi secondi. Questa guida spiega che cosa succede davvero durante la conversione e come farlo in modo privato con lo strumento gratuito da CSV a JSON.

A cosa servono meglio CSV e JSON

CSV (valori separati da virgola) è un formato piatto e tabellare. Ogni riga è un record e le virgole separano le colonne. È compatto, si apre in qualsiasi programma di foglio di calcolo ed è facile da leggere e modificare anche per chi non è sviluppatore. Ciò che non può fare è esprimere una struttura: non c’è un modo pulito per annidare i dati o per indicare il significato di ciascun valore al di là di una riga di intestazione.

JSON (JavaScript Object Notation) è pensato per la struttura. Usa chiavi denominate, supporta l’annidamento ed è il linguaggio predefinito delle API web e delle applicazioni JavaScript. Quando il tuo codice deve scorrere i record e leggere i campi per nome, è il JSON che si aspetta.

Quindi la conversione è in realtà una traduzione da ‘una griglia che legge una persona’ a ‘record etichettati che legge un programma’.

Come le righe diventano oggetti

Il meccanismo è semplice una volta che lo vedi. Prendi questo CSV:

• name,email,age
• Ada,[email protected],36
• Linus,[email protected],29

La prima riga è l’intestazione. Ogni riga rimanente diventa un oggetto JSON e ogni cella dell’intestazione diventa una chiave. Il risultato è un array di oggetti: [{"name": "Ada", "email": "[email protected]", "age": "36"}, ...]. Entra una riga, esce un oggetto, e i nomi delle colonne fanno da etichetta.

Quella forma ad array è esattamente ciò che la maggior parte delle API e dei framework front-end vuole ricevere, ed è per questo che questa conversione capita così spesso.

Perché gli sviluppatori convertono il CSV in JSON

Ricorri a questa operazione ogni volta che dati in forma di foglio di calcolo devono incontrare il codice. I casi comuni includono:

• Popolare un’applicazione o un database a partire da un elenco che qualcuno mantiene in Excel o in Google Sheets.
• Inviare dati a un’API che accetta solo un corpo in JSON.
• Alimentare un front end, dove un array JSON si mappa direttamente su un elenco di componenti.
• Scrivere dati di test (fixture), trasformando un rapido foglio di calcolo di casi in un input strutturato.

In ogni caso un collega può tenere la sorgente comoda come foglio di calcolo mentre il tuo codice consuma il JSON.

Come convertire un CSV in JSON nel tuo browser

Lo strumento gratuito da CSV a JSON funziona interamente nel tuo browser, quindi i tuoi dati non vengono mai caricati su un server. Questo è importante quando le righe contengono record di clienti, indirizzi e-mail o qualsiasi cosa che non incolleresti in un sito web qualsiasi.

1. Apri lo strumento e incolla il tuo CSV, oppure carica un file .csv.
2. Assicurati che la prima riga sia la tua intestazione. Quelle celle diventano le chiavi di ogni oggetto.
3. Leggi l’output JSON, un array di oggetti, e copialo direttamente nel tuo codice o nella tua configurazione.

Poiché il lavoro avviene nella scheda, puoi convertire dati sensibili in tutta sicurezza senza che lascino la tua macchina.

Intestazioni, tipi e qualche insidia

Una conversione pulita dipende soprattutto da un input pulito. Tieni a mente questi punti:

• La riga di intestazione governa tutto. Se una colonna non ha intestazione, i suoi valori non hanno un posto sensato dove finire. Dai un nome a ogni colonna.
• I valori escono come stringhe. Un CSV non registra i tipi, quindi 36 arriva come "36". Convertilo in numero nel tuo codice se ti serve fare calcoli.
• Metti tra virgolette i campi che contengono virgole. Un valore come Smith, Jr. deve essere racchiuso tra virgolette nel CSV, altrimenti verrà letto come due colonne.

Quando l’output sembra sbagliato, la causa è quasi sempre un’intestazione mancante o una virgola non racchiusa tra virgolette nella sorgente.

Strumenti correlati che probabilmente vorrai

La conversione funziona in entrambe le direzioni. Quando devi restituire dati strutturati a qualcuno in un foglio di calcolo, lo strumento da JSON a CSV li riappiattisce in righe. Una volta che hai il JSON, il Formattatore JSON lo indenta e lo convalida, così puoi davvero leggere la struttura e individuare una parentesi vagante. E se i tuoi dati di origine sono arrivati in XML invece che in un foglio di calcolo, lo strumento da XML a JSON li porta nella stessa forma a oggetti che il tuo codice si aspetta.

La versione breve

Il CSV è una griglia per le persone; il JSON sono record etichettati per il codice. Convertire significa trasformare ogni riga in un oggetto, con la riga di intestazione che fornisce le chiavi. Mantieni pulite le intestazioni, metti tra virgolette qualsiasi campo con virgole e ricorda che i numeri arrivano come stringhe. Quando ti serve una conversione rapida e privata, lo strumento gratuito da CSV a JSON la esegue nel tuo browser senza caricare nulla.