Come Tradurre un File CSV Senza Disallineare Colonne o Danneggiare i Dati
EqualangIn 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 (CRLFoLF). - 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:
- 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. - Numeri e decimali localizzati: Durante la traduzione in lingue come l'italiano, il francese o lo spagnolo,
12.50viene spesso trasformato in12,50o1,200in1.200. In una colonna numerica senza virgolette,12,50diventa due colonne distinte (12e50), facendo slittare codici articolo (SKU), inventario e date nella colonna adiacente. - 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
B14senza invadere la cellaC14. - 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.99resta24.99e non diventa24,99. - Le stringhe duplicate vengono tradotte una sola volta: Nomi di categorie o stati ricorrenti (come
ElectronicsoIn Stock) presenti in migliaia di righe vengono elaborati in modo coerente senza costi duplicati.

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:
newline=""ecsv.DictReadergestiscono le celle multilinea: Anche se una descrizione si estende su più righe con virgole interne e virgolette escapate (""),csv.DictReaderrestituisce una stringa Python coerente.- Le colonne tecniche non vengono toccate: Colonne come
id,sku,priceeimage_urlnon passano dal traduttore, azzerando il rischio di URL corrotti o cifre decimali alterate. csv.DictWriterriapplica le virgolette in automatico: Quando il testo tradotto include nuove virgole o virgolette,csv.QUOTE_MINIMALracchiude 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?
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.