Come Tradurre un File CSV Senza Disallineare Colonne o Danneggiare i Dati

Equalang

In breve

Traduci un file CSV in italiano o in altre lingue senza che virgole o virgolette spostino le colonne. Convertilo prima in XLSX o isola le colonne di testo via script.

Parole chiave: tradurre file csv; tradurre csv in italiano; tradurre file csv online; traduzione csv senza disallineare colonne; traduttore csv

Tradurre un file CSV direttamente come testo semplice danneggia quasi sempre la sua struttura e disallinea le colonne. Poiché il formato CSV si basa su virgole, interruzioni di riga e virgolette doppie per delimitare l'inizio e la fine di ciascuna cella, una singola virgola introdotta all'interno di una frase tradotta — o un numero decimale come 12.50 convertito nello standard locale 12,50 — divide un singolo campo in due e sposta tutte le colonne successive verso destra. Per tradurre un file CSV in italiano o in un'altra lingua preservando l'integrità dei dati, è necessario separare i limiti delle celle dal testo contenuto al loro interno prima della traduzione. Di seguito vengono descritti i due metodi più affidabili: convertire il CSV in una cartella di lavoro Excel (.xlsx) per bloccare ciascun valore in una cella separata, oppure estrarre tramite script solo le colonne testuali collegate all'ID di riga.

Perché i file CSV si rompono con i traduttori di testo semplice

Secondo la specifica standard del formato CSV (RFC 4180), un file CSV non possiede una griglia invisibile ma è costituito unicamente da sequenze di caratteri:

  • I campi sono separati da virgole (,) e i record sono separati da ritorni a capo (CRLF o LF).
  • Qualsiasi campo che contenga una virgola, un a capo o virgolette doppie (") deve essere obbligatoriamente racchiuso tra virgolette doppie.
  • Le virgolette doppie letterali all'interno di un campo racchiuso tra virgolette devono essere precedute da un'altra virgoletta ("").

Quando incolli il testo di un CSV in un traduttore generico o carichi un file .csv rinominato in .txt, il motore di traduzione interpreta ogni riga come una normale frase anziché come un record strutturato. Questo provoca tre criticità immediate:

  1. Virgole non protette nella traduzione: Una frase di partenza priva di virgole (Livraison gratuite dès 50 EUR) viene tradotta come "Spedizione gratuita, per ordini superiori a 50 EUR". Se il campo originario non era racchiuso tra virgolette, la nuova virgola crea una colonna aggiuntiva su quella riga.
  2. Numeri e decimali localizzati: Durante la traduzione in lingue come l'italiano, il francese o lo spagnolo, 12.50 viene spesso trasformato in 12,50 o 1,200 in 1.200. In una colonna numerica senza virgolette, 12,50 diventa due colonne distinte (12 e 50), facendo slittare codici articolo (SKU), inventario e date nella colonna adiacente.
  3. Virgolette danneggiate o tipografiche: I traduttori generici tendono a sostituire le virgolette dritte ASCII ("") con virgolette curve (“” o « »), oppure omettono la virgoletta di chiusura nelle descrizioni lunghe. Quando la coppia di virgolette si interrompe, il parser CSV unisce centinaia di righe successive in un'unica cella enorme.

CSV originale (3 colonne: sku, title, price_usd):

SKU-104,Wireless mouse with USB receiver,24.99

Output errato dopo la traduzione come testo semplice (4 colonne invece di 3):

SKU-104,Mouse wireless, con ricevitore USB,24,99

Metodo 1: Convertire il CSV in XLSX, tradurre cella per cella ed esportare nuovamente in CSV

Per cataloghi di prodotti, tabelle di localizzazione, esportazioni di sondaggi e fogli finanziari, la procedura più lineare consiste nel convertire prima il file .csv in una cartella di lavoro Excel (.xlsx), tradurre il file .xlsx mantenendo ogni cella isolata e salvare nuovamente il foglio in formato CSV con codifica UTF-8.

Illustriamo questo passaggio con la traduzione di documenti di Equalang. È utile chiarire fin da subito un limite tecnico: Equalang supporta i formati PDF, DOCX, PPTX, XLSX, EPUB, HTML e TXT, ma non accetta direttamente file .csv. La conversione preliminare da .csv a .xlsx è indispensabile per il caricamento e impedisce ai caratteri di punteggiatura della traduzione di alterare la struttura delle colonne.

Passaggio 1: Importare il CSV in un editor di fogli di calcolo e salvare in .xlsx

Non limitarti a rinominare l'estensione del file da .csv a .xlsx nel file manager. Apri o importa il CSV in un editor come Microsoft Excel, LibreOffice Calc o Google Sheets in modo che il parser suddivida correttamente le colonne, quindi esporta o salva una copia come cartella di lavoro Excel (.xlsx).

Se il CSV include caratteri non ASCII (lettere accentate, caratteri asiatici o cirillici), in Excel utilizza la funzione Dati > Da testo/CSV e seleziona come origine file 65001: Unicode (UTF-8) prima di caricare i dati (consulta la guida all'importazione ed esportazione di file di testo o CSV in Microsoft Excel). Facendo doppio clic su un file CSV UTF-8 privo di BOM in alcune versioni di Excel, i caratteri accentati potrebbero risultare illeggibili già prima della traduzione.

Passaggio 2: Tradurre il file .xlsx

Carica il file .xlsx nella sezione Documenti di Equalang e seleziona la lingua di destinazione (la traduzione di documenti supporta italiano, inglese, spagnolo, francese, tedesco, portoghese, cinese, giapponese, coreano e altre lingue, con rilevamento automatico della lingua di origine). Puoi verificare le modalità di conteggio dei token nella pagina dei prezzi.

Poiché un file .xlsx gestisce ogni campo come un oggetto cella distinto anziché come testo separato da virgole:

  • Virgole e ritorni a capo restano all'interno della cella: Se la descrizione tradotta contiene nuove virgole o interruzioni di paragrafo, tutto il testo rimane nella cella B14 senza invadere la cella C14.
  • Numeri puri e formule non vengono toccati: Le celle con valori numerici (prezzi, quantità, codici numerici) e le formule del foglio vengono ignorate dal traduttore e riscritte esattamente come all'origine; 24.99 resta 24.99 e non diventa 24,99.
  • Le stringhe duplicate vengono tradotte una sola volta: Nomi di categorie o stati ricorrenti (come Electronics o In Stock) presenti in migliaia di righe vengono elaborati in modo coerente senza costi duplicati.
Foglio di calcolo XLSX tradotto che mantiene intatta la struttura delle colonne, le celle numeriche e le formule
La schermata mostra l'interfaccia in inglese di un file XLSX: convertire un CSV in XLSX prima di tradurlo con Equalang mantiene ciascun campo testuale nella propria cella e lascia inalterati numeri e formule

Al termine del processo, è possibile confrontare le versioni originale e tradotta affiancate nell'area di lavoro web prima del download. Per una panoramica dettagliata sulla gestione dei fogli di calcolo, consulta la nostra guida su come tradurre un file Excel.

Passaggio 3: Verificare i codici alfanumerici ed esportare nuovamente in CSV UTF-8

Prima di esportare di nuovo in .csv, controlla le colonne che contengono stringhe alfanumeriche, come codici SKU (BLK-SM-01), sigle di unità (pcs), marchi di produttori o identificatori di stato. I valori numerici puri vengono esclusi automaticamente, ma le celle con abbreviazioni o termini in inglese potrebbero essere tradotte (ad esempio pcs tradotto con "pz"). Se il tuo database o software aziendale richiede che una specifica colonna mantenga i valori originali in inglese, copia quella colonna dal file sorgente e incollala nella versione tradotta.

Inoltre, i nomi delle schede dei fogli non vengono tradotti; se hai inserito formule di Excel contenenti condizioni testuali tra virgolette (come =SE(F2="In Stock"; 1; 0)), la stringa nella formula rimane nella lingua originale: aggiorna le condizioni affinché corrispondano ai testi tradotti prima dell'esportazione.

Infine, in Excel, seleziona File > Salva con nome e imposta il formato CSV UTF-8 (delimitato da virgole) (*.csv). Excel applicherà automaticamente le virgolette doppie secondo lo standard RFC 4180 a tutti i campi che contengono virgole, a capo o virgolette.

Metodo 2: Isolare le colonne di testo per ID di riga tramite script (per sviluppatori e pipeline)

Se il file CSV contiene centinaia di migliaia di righe, è integrato in una pipeline CI/CD o possiede decine di colonne di cui solo due (title e description) devono essere tradotte, la conversione manuale in .xlsx non è sostenibile.

Nei flussi automatizzati, non inviare righe grezze a un'API e non dividere il testo con split(","). È consigliabile utilizzare un parser compatibile con RFC 4180 — come il modulo nativo csv di Python — per leggere ogni riga, tradurre unicamente le colonne di testo desiderate e lasciare che csv.writer gestisca la serializzazione e il corretto quoting.

Esempio in Python:

import csv

SOURCE_FILE = "catalog_source.csv"
OUTPUT_FILE = "catalog_it.csv"
COLUMNS_TO_TRANSLATE = {"title", "description"}

def translate_text(text: str) -> str:
    # Sostituire con la chiamata API di traduzione per il valore della singola cella
    if not text.strip():
        return text
    return text  # segnaposto

with open(SOURCE_FILE, mode="r", encoding="utf-8-sig", newline="") as infile, \
     open(OUTPUT_FILE, mode="w", encoding="utf-8", newline="") as outfile:

    reader = csv.DictReader(infile)
    writer = csv.DictWriter(
        outfile,
        fieldnames=reader.fieldnames,
        quoting=csv.QUOTE_MINIMAL
    )
    writer.writeheader()

    for row in reader:
        for col in COLUMNS_TO_TRANSLATE:
            if col in row and row[col]:
                row[col] = translate_text(row[col])
        writer.writerow(row)

Perché questo metodo funziona:

  1. newline="" e csv.DictReader gestiscono le celle multilinea: Anche se una descrizione si estende su più righe con virgole interne e virgolette escapate (""), csv.DictReader restituisce una stringa Python coerente.
  2. Le colonne tecniche non vengono toccate: Colonne come id, sku, price e image_url non passano dal traduttore, azzerando il rischio di URL corrotti o cifre decimali alterate.
  3. csv.DictWriter riapplica le virgolette in automatico: Quando il testo tradotto include nuove virgole o virgolette, csv.QUOTE_MINIMAL racchiude il campo tra "..." e raddoppia le virgolette interne secondo lo standard RFC 4180.

Per tabelle brevi (meno di 200 righe) senza scrivere codice, puoi importare il CSV in Google Fogli e usare =GOOGLETRANSLATE(B2; "auto"; "it") in una colonna di supporto; copia poi la colonna, incolla solo i valori ed esporta come .csv. Ricorda che le formule nei fogli eseguono una richiesta per riga e possono andare in timeout con file più grandi.

Confronto rapido: quale flusso si adatta al tuo file CSV?

ScenarioFlusso consigliatoAspetti a cui prestare attenzione
Da 100 a 50.000 righe, colonne miste di testo e numeri, etichette ripetuteConvertire .csv → .xlsx, tradurre su Equalang ed esportare in CSV UTF-8Ricopia le colonne SKU o codici se i software a valle richiedono le diciture originali in inglese
Meno di 200 righe, consultazione rapidaAprire in Google Fogli, usare =GOOGLETRANSLATE() in colonna affiancata ed esportare in CSVLe formule ricalcolano riga per riga e possono bloccarsi; incolla come valori prima dell'esportazione
Pipeline automatizzata o file di grandi dimensioni (+100.000 righe)Elaborare con csv.DictReader in Python, tradurre solo le colonne designate e scrivere con csv.DictWriterSalva le stringhe ripetute in un dizionario locale per evitare di inviare all'API testi identici

Domande frequenti

Posso caricare direttamente un file .csv su Equalang?

No. Il traduttore di documenti di Equalang supporta file PDF, DOCX, PPTX, XLSX, EPUB, HTML e TXT, e non accetta caricamenti diretti di file .csv. Apri il CSV in Excel o in un altro programma per fogli di calcolo, salvalo in formato .xlsx, traduci il file risultante e salva nuovamente la cartella tradotta come CSV con codifica UTF-8.

Come posso evitare che Excel mostri caratteri illeggibili (come ??? o é) nel CSV tradotto?

Salva e apri sempre il CSV come CSV UTF-8 (delimitato da virgole). Se aprendo il file con doppio clic su Windows i caratteri risultano illeggibili, crea una cartella vuota in Excel e usa Dati > Da testo/CSV, impostando l'origine file su 65001: Unicode (UTF-8).

Perché le colonne dei prezzi o dei numeri si sono spostate dopo la traduzione del CSV?

Se il CSV è stato tradotto come testo semplice verso una lingua che usa la virgola come separatore decimale (come l'italiano o il francese), un valore come 19.99 è stato quasi certamente trasformato in 19,99 senza virgolette di protezione. Convertire il CSV in .xlsx prima della traduzione mantiene le celle numeriche memorizzate come numeri, consentendo al motore di saltarle e preservarle inalterate.

Fonti