Vai al contenuto

Convertitore JSON ↔ CSV

Convertitore JSON ↔ CSV

Conversione bidirezionale tra CSV/TSV e JSON con rilevamento automatico del delimitatore, mappatura dell'intestazione, rimozione degli spazi e salto delle righe vuote. Utile per importazione/esportazione dati, elaborazione fogli di calcolo e preparazione payload API.

Convertitore JSON ↔ CSV

🚀 Avvio rapido

  • Incolla o inserisci i dati CSV/TSV nell'editor CSV a destra e il JSON a sinistra verrà automaticamente sincronizzato
  • Puoi anche inserire JSON nell'editor JSON a sinistra e anche il CSV a destra verrà sincronizzato automaticamente.
  • Il delimitatore è impostato su "Auto" per impostazione predefinita. Lo strumento esamina la prima riga e rileva la virgola, la tabulazione, il punto e virgola o la barra verticale (|).
  • Quando "Usa riga di intestazione" è attivo, la prima riga del CSV viene usata come chiavi dell'oggetto JSON; quando è disattivo, l'output viene convertito in un array bidimensionale.
  • Utilizza "Taglia campi" e "Salta righe vuote" per ripulire i dati CSV disordinati.
  • Ogni editor può essere scaricato separatamente: il lato JSON scarica un file .json e il lato CSV scarica un file .csv o .tsv in base al delimitatore corrente.

📌 Scenari comuni

  • Da Excel a JSON: copia celle separate da tabulazioni da Excel nel riquadro CSV e convertile immediatamente in un array di oggetti JSON.
  • Risposta API al foglio di calcolo: converti le risposte JSON in CSV per l'analisi in Excel o Fogli Google.
  • Preparazione all'importazione del database: conversione di set di dati CSV in JSON per importazioni API batch.
  • Analisi dei log: converti i log CSV in JSON per interrogazioni strutturate con strumenti come jq.
  • Migrazione della configurazione: passa dalle tabelle di mappatura CSV ai file di configurazione JSON.
  • Pulizia dei dati: pulisci rapidamente i dati esportati con il taglio dei campi e il salto delle righe vuote.

🧭 Consigli d'uso

  • I dati incollati da Excel sono generalmente delimitati da tabulazioni e vengono rilevati correttamente. Se il rilevamento è errato, scegliere manualmente il delimitatore.
  • Con "Usa riga di intestazione" attivo, la prima riga viene trattata come nomi di colonna e non come dati. Se il CSV non ha intestazione, disattiva questa opzione per non perdere la prima riga di dati.
  • Se esistono nomi di intestazione duplicati, i suffissi vengono aggiunti automaticamente (ad esempio nome, nome_2) per mantenere univoche le chiavi JSON.
  • JSON → CSV funziona meglio con array di oggetti piatti. Gli oggetti/matrici nidificati vengono serializzati come stringhe JSON nelle celle.
  • I campi contenenti delimitatori, ritorni a capo o virgolette doppie vengono automaticamente racchiusi tra virgolette e caratteri di escape in base alle regole CSV.

⚠️ Limitazioni e compatibilità

  • CSV è un formato tabulare piatto e non può rappresentare in modo nativo strutture nidificate. Gli oggetti/matrici JSON nidificati vengono serializzati come stringhe e non possono essere completamente ripristinati durante la conversione inversa.
  • CSV memorizza i valori come testo. Dopo un viaggio di andata e ritorno JSON → CSV → JSON, numeri e valori booleani potrebbero tornare come stringhe.
  • La distinta base UTF-8 (\uFEFF) viene rimossa automaticamente. Altre codifiche (ad esempio GBK o Shift-JIS) non sono supportate; converti prima in UTF-8.
  • Come JSON in JavaScript, questo strumento segue i limiti IEEE 754. I numeri interi oltre l'intervallo sicuro di 53 bit potrebbero perdere precisione.

🔒 Privacy e sicurezza

  • Tutta l'elaborazione avviene localmente nel tuo browser. I tuoi dati non lasciano mai il tuo dispositivo.

❓ Domande frequenti

Cos'è CSV e in che modo è correlato a TSV ed Excel?

CSV (Comma-Separated Values) è un formato di tabella di testo semplice in cui ogni riga è un record e i campi sono separati da virgole. TSV è la variante delimitata da tabulazioni. Excel può aprire ed esportare entrambi i formati, ma .xlsx stesso è un formato di cartella di lavoro binario. Questo strumento funziona con file CSV/TSV di testo semplice, non con file .xlsx. Storicamente, il CSV non aveva uno standard unico e rigoroso. Nel 2005, RFC 4180 ha definito regole comuni: i campi sono separati da virgole, i campi con caratteri speciali sono racchiusi tra virgolette doppie e le virgolette all'interno dei campi tra virgolette vengono separate da due virgolette doppie. Diverse app implementano ancora CSV con piccole differenze, motivo per cui i problemi di importazione/esportazione sono comuni.

Come funziona il rilevamento dei delimitatori "Automatico"? Può essere sbagliato?

Lo strumento analizza la prima riga del CSV, conta quante virgole, tab, punti e virgola e barre verticali (|) compaiono fuori dalle virgolette e sceglie come delimitatore quello più frequente. Per la maggior parte dei CSV/TSV ben formati, il riconoscimento automatico è accurato. Può fallire quando c'è una sola colonna (nessun delimitatore visibile) o quando il contenuto dei campi contiene molti caratteri delimitatori. In questi casi, seleziona il delimitatore manualmente.

Cosa cambia quando l'opzione "Usa riga di intestazione" è attivata o disattivata?

Quando è attivo, la prima riga del CSV viene trattata come nomi di colonna e ogni record viene convertito in un oggetto JSON con quei nomi come chiavi (ad esempio {"name": "Alice", "age": "30"}). Quando è disattivo, tutte le righe, inclusa la prima, vengono trattate come dati e convertite in un array bidimensionale (ad esempio [["name", "age"], ["Alice", "30"]]). Nella conversione JSON → CSV, attivare l'intestazione scrive le chiavi dell'oggetto nella prima riga del CSV.

Il mio JSON contiene oggetti nidificati. Posso riconvertire senza perdita di dati dopo CSV?

Non completamente. Durante JSON → CSV, gli oggetti/array annidati vengono serializzati con JSON.stringify nel testo della cella. Durante CSV → JSON, tali valori rimangono stringhe e non vengono analizzati automaticamente in oggetti. Se hai bisogno di fedeltà strutturale, appiattisci JSON prima della conversione.

Posso convertire direttamente i dati copiati da Excel?

SÌ. Quando copi un intervallo di celle da Excel e lo incolli nell'editor CSV, i dati sono generalmente delimitati da tabulazioni. Il rilevamento automatico lo identifica come TSV e lo converte correttamente. Se desideri scaricare un file .csv delimitato da virgole, imposta il delimitatore su virgola prima del download.

Come vengono gestite le virgolette e le interruzioni di riga nei campi CSV?

In base a RFC 4180: se il contenuto del campo contiene delimitatori, ritorni a capo o doppi apici, l'intero campo viene racchiuso tra doppi apici; i doppi apici all'interno del campo vengono escapati come due doppi apici consecutivi (""). Questa regola vale sia in fase di parsing dell'input sia in fase di generazione dell'output. Se le virgolette non sono chiuse correttamente, viene mostrato l'errore "Virgolette CSV non chiuse".