Convertitore CSV in JSON
Introduzione
Il Convertitore da CSV a JSON colma il divario tra i dati in formato foglio di calcolo e il JSON strutturato. Che tu stia importando dati da Excel in un'applicazione web, preparando payload API da esportazioni di database o trasformando file di configurazione, questo strumento gestisce la conversione con precisione e flessibilità.
A differenza degli strumenti da riga di comando che richiedono installazione o dei servizi online che caricano i tuoi dati su un server, il Convertitore da CSV a JSON di Toollect opera interamente all'interno del tuo browser. Ogni tasto premuto aggiorna l'output JSON in tempo reale, dandoti un feedback immediato. Con zero dati trasmessi in rete, offre sia velocità che privacy.
Con il rilevamento intelligente dei delimitatori, l'inferenza dei tipi, molteplici formati di output e una tabella di anteprima live, questo convertitore gestisce i casi limite che rendono frustrante la conversione CSV: campi tra virgolette contenenti virgole, valori su più righe, conteggi di colonne incoerenti e altro ancora.
Casi d'uso
Il modello di conversione da CSV a JSON appare in molti flussi di lavoro reali. Comprendere questi scenari ti aiuta a riconoscere quando questo strumento si adatta alle tue esigenze.
Esportazione database per integrazione API
La maggior parte dei sistemi di database può esportare i risultati delle query come CSV. Quando devi alimentare un'API REST o un frontend JavaScript con questi dati, la conversione in JSON è il ponte naturale. Esporta un elenco di utenti, prodotti o ordini da MySQL o PostgreSQL come CSV, converti in JSON, e la struttura è immediatamente compatibile con i framework web.
Excel e Google Sheets verso applicazioni web
I dati dei fogli di calcolo spesso devono essere trasferiti in applicazioni web che consumano JSON. Esporta il tuo foglio come CSV, converti in JSON, e le intestazioni delle colonne diventano nomi di proprietà pronti per JavaScript, TypeScript o qualsiasi framework moderno. Questo è comune durante la migrazione dalla gestione manuale nei fogli di calcolo a software dedicato.
Dati di configurazione e migrazione
Le configurazioni di sistema, le mappature delle variabili d'ambiente e i dati di migrazione sono frequentemente memorizzati o scambiati come CSV. La conversione in JSON consente validazione, trasformazione e integrazione con strumenti di infrastruttura come codice e sistemi di gestione della configurazione.
Pipeline ETL e elaborazione dati
Le pipeline di Estrazione-Trasformazione-Caricamento spesso iniziano con file CSV da fonti esterne. Convertire in JSON in una fase precoce consente un'elaborazione strutturata, la validazione dello schema e l'integrazione a valle con strumenti e database nativi JSON.
Privacy dei dati
Il Convertitore da CSV a JSON di Toollect elabora ogni byte di dati localmente nel tuo browser. Nessun contenuto CSV viene trasmesso a nessun server, memorizzato in alcun database o registrato in alcun sistema.
Tutte le letture dei file avvengono tramite l'API FileReader del browser, che carica il file nella memoria del tuo dispositivo. L'output JSON generato rimane nel tuo browser fino a quando non lo copi esplicitamente negli appunti o lo scarichi come file. Non ci sono richieste di rete in background, nessuno script di analisi sulla pagina dello strumento e nessun cookie o archiviazione locale utilizzato dal convertitore.
Questa architettura a zero trasmissioni rende lo strumento adatto per dati sensibili, documenti aziendali interni e qualsiasi scenario in cui la residenza dei dati o la conformità alla privacy sia importante.
Come funziona
Il Convertitore elabora i tuoi dati CSV attraverso una pipeline multi-stadio progettata per precisione e flessibilità.
Analisi sintattica
Lo strumento legge l'input CSV riga per riga usando un parser personalizzato che segue le convenzioni RFC 4180. Gestisce correttamente:
- Campi tra virgolette: I campi racchiusi tra virgolette doppie possono contenere delimitatori, interruzioni di riga e altri caratteri speciali
- Virgolette escapate: Le virgolette doppie all'interno di un campo sono rappresentate da due virgolette doppie consecutive (
"") - Campi vuoti: Delimitatori consecutivi producono valori di stringa vuoti
- Spazi bianchi finali: Gli spazi al di fuori delle virgolette vengono rimossi per un output pulito
Rilevamento del delimitatore
In modalità di rilevamento automatico, lo strumento analizza le prime righe dei tuoi dati, testando ogni delimitatore candidato (virgola, tabulazione, punto e virgola) e selezionando quello che produce il conteggio di colonne più coerente. Puoi sempre sovrascrivere manualmente il delimitatore rilevato.
Inferenza dei tipi
Con l'inferenza dei tipi attivata, lo strumento analizza ogni valore e converte i pattern riconosciuti:
- Numeri: Interi e decimali (
42,3.14,-1.5,1e10) diventano numeri JSON - Booleani:
trueefalse(senza distinzione maiuscole/minuscole) diventano booleani JSON - Nullo:
null(senza distinzione maiuscole/minuscole) diventanullJSON - Stringhe: Tutto il resto rimane una stringa
Puoi anche attivare l'analisi dei valori JSON, che tenta di analizzare i campi che assomigliano a oggetti o array JSON.
Formattazione dell'output
L'output JSON finale viene generato secondo le opzioni selezionate:
- Array di oggetti: Ogni riga diventa un oggetto con i valori della riga di intestazione come chiavi (predefinito)
- Array 2D: Output come array di array, ignorando la riga di intestazione
- Chiave dalla prima colonna: Un oggetto in cui il valore della prima colonna di ogni riga di dati diventa la chiave
L'output può essere formattato (con indentazione di 2 o 4 spazi) o minimizzato su una singola riga.
Riferimento del formato di input
Comprendere le regole di formattazione CSV ti aiuta a preparare dati che si convertono pulitamente senza sorprese.
Opzioni delimitatore
| Delimitatore | Simbolo | Auto-rilevato | Utilizzo tipico |
|---|---|---|---|
| Virgola | , |
Sì | Esportazione CSV standard |
| Tabulazione | \t |
Sì | File TSV, appunti foglio di calcolo |
| Punto e virgola | ; |
Sì | Impostazioni locali CSV europee (Excel) |
| Personalizzato | Qualsiasi carattere | No | Pipe (` |
Regole per le virgolette
Il CSV utilizza virgolette doppie per racchiudere i campi che contengono caratteri speciali:
- Un campo contenente il delimitatore deve essere tra virgolette:
"Rossi, Mario" - Un campo contenente un'interruzione di riga deve essere tra virgolette:
"Riga 1\nRiga 2" - Un campo contenente una virgoletta doppia la escape raddoppiandola:
"""Testo citato"""diventa"Testo citato" - I campi non tra virgolette vengono privati degli spazi circostanti
Riga di intestazione
La prima riga viene trattata come intestazione per impostazione predefinita. Ogni valore di intestazione diventa una chiave di proprietà JSON. Le intestazioni vengono pulite e non vuote. I nomi di intestazione duplicati vengono deduplicati con un suffisso numerico (es., nome, nome_2).
Codifica
Lo strumento prevede input codificato in UTF-8. I file salvati con BOM UTF-8 (byte order mark) vengono elaborati in modo trasparente — il BOM viene rimosso durante l'analisi. Altre codifiche (Latin-1, Windows-1252) possono produrre caratteri illeggibili; riconverti in UTF-8 prima della conversione.
Galleria dei casi limite CSV
I dati CSV reali raramente corrispondono agli esempi dei manuali. Ecco come il convertitore gestisce i casi limite più comuni.
Virgole all'interno di campi tra virgolette
Nome,Descrizione,Prezzo
Widget Pro,"Include cavo, manuale e custodia",29.99
La virgola all'interno della descrizione tra virgolette viene correttamente trattata come parte del valore, non come delimitatore di colonna. L'output JSON mantiene la stringa completa intatta.
Valori su più righe
ID,Note
001,"Questo prodotto richiede
assemblaggio da due persone.
Utensili non inclusi."
I valori contenenti interruzioni di riga tra virgolette vengono analizzati come un singolo campo che si estende su più righe. L'output JSON preserva le interruzioni di riga come sequenze di escape \n.
Conteggio colonne incoerente
Nome,Email,Telefono
Alice,[email protected],555-0100
Bob,[email protected]
Charlie,[email protected],555-0200,extra
Le righe con meno colonne producono stringhe vuote per i campi mancanti. Le righe con colonne aggiuntive producono chiavi indicizzate aggiuntive. Viene mostrato un avviso quando viene rilevata un'incoerenza nel conteggio delle colonne.
Zeri iniziali
CAP,Città
00123,New York
02134,Boston
Con l'inferenza dei tipi attivata, 00123 diventa il numero 123 (perdendo gli zeri iniziali). Disattiva l'inferenza dei tipi per conservare la stringa originale "00123" — essenziale per codici postali, numeri di telefono e ID prodotto.
Caratteri BOM
I file esportati da Excel per Windows spesso includono un BOM UTF-8 (\uFEFF) come primi byte. Il convertitore rimuove il BOM automaticamente, quindi il primo valore di intestazione è pulito. Non è richiesta alcuna azione da parte tua.
Righe vuote
Nome,Valore
Alpha,1
Beta,2
Le righe vuote e le righe contenenti solo spazi vengono saltate. Non producono voci JSON né generano errori.
Utilizzo
Usare il Convertitore da CSV a JSON di Toollect non richiede configurazione o registrazione. Segui questi passaggi:
-
Apri lo strumento — Vai alla pagina del Convertitore da CSV a JSON. L'interfaccia mostra una zona di upload, un'area di testo di input, un pannello delle impostazioni e un'area di output.
-
Inserisci i tuoi dati — Incolla il testo CSV direttamente nell'area di testo, o clicca sulla zona di upload (o trascina un file .csv) per caricare un file.
-
Controlla le impostazioni — Lo strumento rileva automaticamente il delimitatore e attiva intestazioni e inferenza dei tipi per impostazione predefinita. Regola queste impostazioni in base ai tuoi dati:
- Seleziona un delimitatore diverso se il rilevamento automatico non è corretto
- Attiva o disattiva "Prima riga come intestazioni" se i tuoi dati non hanno una riga di intestazione
- Disattiva l'inferenza dei tipi per mantenere tutti i valori come stringhe
-
Anteprima dei dati analizzati — Clicca su "Mostra anteprima" per vedere una vista tabellare dei tuoi dati CSV analizzati. Questo aiuta a verificare che il delimitatore e le impostazioni delle intestazioni siano corretti.
-
Controlla l'output JSON — L'output JSON si aggiorna automaticamente mentre scrivi. L'area di testo di output è in sola lettura per prevenire modifiche accidentali.
-
Copia o scarica — Clicca su "Copia" per copiare il JSON negli appunti, o su "Scarica JSON" per salvarlo come file .json.
Riferimento del formato di output
Lo stesso input CSV può produrre tre diverse strutture JSON. Ogni formato si adatta a un diverso modello di consumo.
Input di esempio:
Prodotto,Prezzo,In Magazzino
Widget,29.99,true
Gadget,49.95,false
Array di oggetti
Ogni riga di dati diventa un oggetto con i valori dell'intestazione come chiavi. Questo è il formato predefinito e più comunemente utilizzato. Si mappa direttamente sugli array JavaScript e sulla maggior parte dei payload delle API REST.
[
{
"Prodotto": "Widget",
"Prezzo": 29.99,
"In Magazzino": true
},
{
"Prodotto": "Gadget",
"Prezzo": 49.95,
"In Magazzino": false
}
]
Array 2D
L'output è un array di array. La riga di intestazione viene esclusa a meno che non si disattivino esplicitamente le intestazioni. Utile per dati matriciali e componenti Grid/DataTable.
[
["Prodotto", "Prezzo", "In Magazzino"],
["Widget", 29.99, true],
["Gadget", 49.95, false]
]
Chiave dalla prima colonna
Il valore della prima colonna diventa la chiave dell'oggetto e le colonne rimanenti formano l'oggetto valore. Utile per tabelle di ricerca e accesso ai dati in formato dizionario.
{
"Widget": {
"Prezzo": 29.99,
"In Magazzino": true
},
"Gadget": {
"Prezzo": 49.95,
"In Magazzino": false
}
}
I valori della prima colonna devono essere univoci. I duplicati causano la sovrascrittura delle occorrenze precedenti da parte dell'ultima — viene mostrato un avviso quando ciò accade.
Tutorial
Questo tutorial illustra la conversione di un file CSV esportato da Excel in un array JSON per un'applicazione web.
Scenario: Hai un foglio Excel con l'inventario dei prodotti e vuoi importarlo in un'app web che accetta JSON.
- Esporta da Excel — Salva il tuo foglio di calcolo come file CSV. Dovresti ottenere qualcosa come:
Product Name, SKU, Price, In Stock, Category
Widget Pro, WDG-001, 29.99, true, Tools
Gadget X, GDG-002, 49.95, false, Electronics
Super Tool, SUP-003, 99.00, true, Tools
Accessory Pack, ACC-004, 14.99, true, Accessories
-
Apri il Convertitore da CSV a JSON e trascina il file CSV sulla zona di upload. Lo strumento carica il file, rileva il delimitatore virgola e converte i dati istantaneamente.
-
Controlla l'anteprima — Clicca su "Mostra anteprima" per vedere la rappresentazione tabellare. Conferma che la riga di intestazione sia analizzata correttamente.
-
L'output JSON appare come:
[
{
"Product Name": "Widget Pro",
"SKU": "WDG-001",
"Price": 29.99,
"In Stock": true,
"Category": "Tools"
},
{
"Product Name": "Gadget X",
"SKU": "GDG-002",
"Price": 49.95,
"In Stock": false,
"Category": "Electronics"
},
{
"Product Name": "Super Tool",
"SKU": "SUP-003",
"Price": 99,
"Category": "Tools"
},
{
"Product Name": "Accessory Pack",
"SKU": "ACC-004",
"Price": 14.99,
"In Stock": true,
"Category": "Accessories"
}
]
Nota che i valori di Price sono numeri (non stringhe), i valori In Stock sono booleani e il valore "In Stock" mancante per "Super Tool" viene omesso.
- Prova le trasformazioni delle chiavi — Seleziona "snake_case" dal menu a discesa della formattazione chiavi. L'output diventa:
[
{
"product_name": "Widget Pro",
"sku": "WDG-001",
"price": 29.99,
"in_stock": true,
"category": "Tools"
}
]
- Prova il formato con chiave — Seleziona "Chiave dalla prima colonna" per ottenere un oggetto indicizzato per nome prodotto:
{
"Widget Pro": {
"SKU": "WDG-001",
"Price": 29.99,
"In Stock": true,
"Category": "Tools"
},
"Gadget X": { ... }
}
- Scarica il risultato — Clicca su "Scarica JSON" per salvare l'output come file .json pronto per la tua applicazione web.
Consigli avanzati
Padroneggia queste tecniche per ottenere il massimo dal Convertitore da CSV a JSON di Toollect:
-
Usa prima l'anteprima: Controlla sempre la tabella di anteprima prima di fare affidamento sull'output JSON. Colonne disallineate, delimitatori errati o problemi di codifica sono immediatamente visibili nell'anteprima tabellare
-
Gestisci gli zeri iniziali: I codici postali, i numeri di telefono e gli ID hanno spesso zeri iniziali. Disattiva l'inferenza dei tipi per mantenerli come stringhe — altrimenti
00123diventa il numero123 -
Normalizza i nomi delle colonne: Usa l'impostazione della formattazione chiavi per trasformare intestazioni inconsistenti in un formato uniforme. Per l'integrazione API, camelCase o snake_case sono generalmente preferiti
-
Pulisci prima il tuo CSV: Rimuovi le righe vuote finali, verifica la coerenza del conteggio delle colonne e assicurati che i campi tra virgolette usino virgolette doppie per risultati migliori
-
Combina con altri strumenti: Converti CSV in JSON qui, poi usa il Formattatore JSON per validare e ispezionare la struttura
-
Scorciatoie da tastiera: Usa Tab per spostarti tra i campi. Premi Ctrl+A (Cmd+A) per selezionare tutto il testo nell'area di output per una copia rapida quando il pulsante Copia non è disponibile
Guida per file grandi
Il Convertitore da CSV a JSON gestisce file fino a 10 MB tramite l'interfaccia di upload. Oltre questo limite, o quando hai bisogno di prestazioni ottimali, segui queste linee guida.
Limiti di upload
| Metodo | Limite dimensione | Note |
|---|---|---|
| Trascinamento upload | 10 MB | Limite rigido imposto da FileReader |
| Incolla in area di testo | Memoria browser | Dipende dalla RAM disponibile, rendering più lento |
| Finestra di apertura file | 10 MB | Stesso limite FileReader |
Prestazioni per dimensione dati
| Righe | Colonne | Metodo | Tempo previsto |
|---|---|---|---|
| 1.000 | 20 | Qualsiasi | Istantaneo |
| 10.000 | 20 | Qualsiasi | < 100 ms |
| 100.000 | 20 | Incolla testo | < 1 secondo |
| 500.000 | 20 | Incolla testo | 2-5 secondi |
Lavorare con file grandi
- File oltre 10 MB: incolla il contenuto direttamente nell'area di testo invece di caricarlo. L'area di testo bypassa il limite di dimensione di FileReader e utilizza la memoria disponibile del browser
- Per file che superano le 100.000 righe, considera di dividere il CSV in parti più piccole prima della conversione
- L'anteprima live diventa più lenta all'aumentare del numero di righe — disattiva l'anteprima per set di dati grandi lasciando il pannello di anteprima chiuso
- L'inferenza dei tipi aggiunge overhead di elaborazione. Se hai solo bisogno di output come stringhe, disattiva l'inferenza dei tipi per una conversione più veloce su file grandi
Considerazioni sulla memoria del browser
Ogni megabyte di CSV consuma circa 2-4 MB di memoria di lavoro durante la conversione (input + struttura analizzata + output JSON). Un file CSV di 10 MB può utilizzare 30-40 MB di memoria del browser. Chiudi altre schede ad alta intensità di memoria quando lavori con file grandi.
Alternative
Sebbene il Convertitore da CSV a JSON di Toollect offra un set completo di funzionalità, esistono diverse alternative per diversi casi d'uso.
| Strumento / Metodo | Ideale per | Limitazioni |
|---|---|---|
| Convertitore da CSV a JSON di Toollect | Conversione nel browser, privacy, personalizzabile | Richiede caricamento iniziale della pagina |
| PapaParse (libreria JavaScript) | Analisi CSV programmatica in Node.js o browser | Richiede codifica, nessuna interfaccia grafica |
| csvkit (riga di comando) | Elaborazione e conversione CSV con Python | Richiede installazione di Python, solo riga di comando |
| Servizi di conversione online | Conversioni rapide una tantum | I dati vengono caricati su server, problemi di privacy |
| Excel Power Query | Conversione CSV in JSON all'interno di Excel | Richiede Excel, limitato a set di dati piccoli |
| jq (riga di comando) | Elaborazione dell'output JSON da conversioni CSV | Richiede passaggio separato CSV-JSON, solo riga di comando |
Per la maggior parte degli utenti che necessitano di una conversione rapida, privata e ricca di funzionalità da CSV a JSON senza lasciare il browser, il convertitore Toollect offre il miglior equilibrio tra funzionalità e praticità.
Risoluzione dei problemi
| Problema | Causa probabile | Soluzione |
|---|---|---|
| JSON mostra "[null]" o oggetti vuoti | Rilevamento delimitatore fallito o delimitatore errato selezionato | Seleziona manualmente il delimitatore corretto dal menu a discesa |
| Valori colonna mancanti/spostati | Un campo contiene il delimitatore senza virgolette | Racchiudi i campi contenenti delimitatori tra virgolette doppie nel file CSV originale |
| I numeri con zeri iniziali perdono gli zeri | L'inferenza dei tipi li converte in valori numerici | Disattiva l'inferenza dei tipi per mantenere tutti i valori come stringhe |
| Errore "La riga X ha Y colonne, attese Z" | Conteggio colonne incoerente tra le righe | Controlla il CSV per delimitatori extra/mancanti; i campi tra virgolette con a capo possono estendersi su più righe |
| L'anteprima mostra caratteri illeggibili | La codifica del file non è UTF-8 | Riesporta il CSV come UTF-8 dal tuo foglio di calcolo |
| Il caricamento di file grandi fallisce | Il file supera il limite di 10 MB | Incolla i dati direttamente nell'area di testo invece di caricarli |
| L'output JSON è vuoto | Il campo di input è vuoto o contiene solo spazi | Assicurati che i dati CSV siano incollati correttamente |
| Il pulsante Copia non risponde | Autorizzazioni degli appunti del browser | Controlla le impostazioni del browser; usa Ctrl+C (Cmd+C) come alternativa |
Specifiche tecniche
Benchmark delle prestazioni
| Dimensione dati | Tempo di elaborazione | Utilizzo memoria |
|---|---|---|
| 1 KB (10 righe) | < 1 ms | < 1 MB |
| 100 KB (1000 righe) | < 10 ms | < 5 MB |
| 1 MB (10000 righe) | < 100 ms | < 50 MB |
Dettagli tecnici
- Parser: Parser CSV personalizzato conforme RFC 4180 con gestione completa di virgolette ed escape
- Inferenza dei tipi: Rilevamento basato su regex per numeri, booleani, valori nulli
- Rilevamento delimitatore: Punteggio euristico sulle prime 10 righe, test virgola/tabulazione/punto e virgola
- Motore di output:
JSON.stringify()nativo con indentazione configurabile - Gestione file: API
FileReadercon limite di dimensione 10 MB - Appunti:
navigator.clipboard.writeText()con indicatore di feedback di 2 secondi - Download:
Blob+URL.createObjectURL()per generazione file in memoria
Compatibilità browser
| Browser | Versione minima | Stato |
|---|---|---|
| Google Chrome | 80+ | Supporto completo |
| Mozilla Firefox | 75+ | Supporto completo |
| Apple Safari | 13+ | Supporto completo |
| Microsoft Edge | 80+ | Supporto completo |
| Samsung Internet | 13+ | Supporto completo |
| Opera | 67+ | Supporto completo |
Caratteristiche
- Conversione istantanea da CSV a JSON con anteprima live
- Rilevamento intelligente automatico del delimitatore con override manuale
- Inferenza dei tipi per numeri, booleani e valori nulli
- Molteplici formati di output: array di oggetti, array 2D e oggetti con chiave
- Trasformazione maiuscole/minuscole delle chiavi (camelCase, snake_case, lowercase, UPPERCASE, Capitalize)
- Anteprima dati comprimibile per verificare il CSV prima della conversione