Cómo traducir un archivo CSV sin desalinear columnas ni alterar datos
EqualangEn breve
Traduce un archivo CSV al español u otros idiomas sin que comas o comillas desplacen columnas. Conviértelo primero a XLSX o aísla columnas de texto con script.
Palabras clave: traducir archivo csv; traducir csv al espanol; traducir archivo csv online; traducir csv sin desalinear columnas; traductor csv
Traducir un archivo CSV directamente como texto plano casi siempre rompe su estructura y desalinea las columnas. Dado que el formato CSV utiliza comas, saltos de línea y comillas dobles para definir el inicio y el final de cada celda, cualquier coma añadida en una frase traducida —o un número decimal como 12.50 adaptado al formato local como 12,50— divide un único campo en dos y desplaza todas las columnas siguientes hacia la derecha. Para traducir un CSV al español o a cualquier otro idioma de forma segura, es imprescindible aislar las celdas del texto antes de traducir: bien convirtiendo el archivo temporalmente a formato Excel (.xlsx) para bloquear cada valor en su propia celda, o bien extrayendo mediante script únicamente las columnas de texto asociadas al identificador de cada fila.
Por qué los traductores de texto plano rompen los archivos CSV
Según la especificación estándar del formato CSV (RFC 4180), un archivo CSV carece de líneas de cuadrícula reales y se define exclusivamente mediante caracteres:
- Los campos se separan por comas (
,) y los registros se separan mediante saltos de línea (CRLFoLF). - Cualquier campo que contenga una coma, un salto de línea o comillas dobles (
") debe ir obligatoriamente entre comillas dobles. - Toda comilla doble literal dentro de un campo entrecomillado debe escaparse duplicándola (
"").
Cuando pegas el contenido de un archivo CSV en un traductor de texto genérico o subes un archivo .csv renombrado como .txt, el motor de traducción interpreta cada línea como una oración común en lugar de un registro estructurado. Esto provoca tres fallos inmediatos:
- Comas no escapadas en la traducción: Una frase de origen sin comas (
Livraison gratuite dès 50 EUR) se traduce como"Envío gratis, pedidos superiores a 50 EUR". Si el campo original no estaba entre comillas, esa nueva coma crea una columna extra en esa fila. - Números y decimales localizados: Al traducir a idiomas como español, alemán o francés,
12.50suele convertirse en12,50o1,200en1.200. En una columna numérica sin comillas,12,50pasa a ser dos columnas distintas (12y50), desplazando códigos SKU, existencias y fechas a la columna contigua. - Pérdida de comillas y comillas tipográficas: Los traductores genéricos suelen sustituir las comillas rectas ASCII (
"") por comillas tipográficas (“”o« »), o bien omiten la comilla de cierre en descripciones largas con saltos de línea. En cuanto se rompe el emparejamiento de comillas, el analizador CSV une cientos de filas siguientes en una sola celda gigantesca.
CSV original (3 columnas: sku, title, price_usd):
SKU-104,Wireless mouse with USB receiver,24.99
Salida dañada tras la traducción de texto plano (4 columnas en lugar de 3):
SKU-104,Ratón inalámbrico, con receptor USB,24,99
Método 1: Convertir CSV a XLSX, traducir celda por celda y exportar de nuevo a CSV
En catálogos de comercio electrónico, tablas de localización, respuestas de encuestas o balances financieros, la alternativa más limpia y práctica consiste en convertir el .csv en un libro de Excel (.xlsx), procesar la traducción del archivo .xlsx celda a celda y guardar el resultado nuevamente como CSV en UTF-8.
Mostramos este proceso con la traducción de documentos de Equalang. Conviene precisar una delimitación técnica importante: Equalang admite formatos PDF, DOCX, PPTX, XLSX, EPUB, HTML y TXT, pero no procesa archivos .csv de forma directa. La conversión previa de .csv a .xlsx no solo cumple con el formato de entrada, sino que garantiza que los signos de puntuación del texto traducido nunca interfieran con la estructura de las columnas.
Paso 1: Importar el CSV en un editor de hojas de cálculo y guardar como .xlsx
No cambies simplemente la extensión del archivo de .csv a .xlsx en el explorador de archivos. Abre o importa el CSV en una herramienta como Microsoft Excel, LibreOffice Calc o Google Sheets para que el analizador interprete las columnas correctamente y guarda una copia como libro de Excel (.xlsx).
Si tu archivo contiene caracteres no ASCII (tildes, eñes, caracteres chinos o árabes), utiliza en Excel la opción Datos > De texto/CSV y asegúrate de seleccionar el origen de archivo 65001: Unicode (UTF-8) antes de cargar los datos (consulta la guía de importación y exportación de archivos de texto o CSV de Microsoft Excel). Si haces doble clic directamente en un archivo CSV UTF-8 sin marca de orden de bytes (BOM) en ciertas versiones de Excel, los caracteres con tildes pueden corromperse antes de comenzar la traducción.
Paso 2: Traducir el archivo .xlsx
Sube el archivo .xlsx en Equalang Documentos y selecciona el idioma de destino (la traducción de documentos admite español, inglés, chino, japonés, coreano, francés y otros idiomas, con detección automática del idioma de origen). Puedes consultar cómo se calculan los tokens en la página de precios.
Al almacenar cada campo como un objeto de celda independiente en lugar de texto delimitado por comas:
- Las comas y los saltos de línea permanecen dentro de la celda: Si una descripción traducida incorpora tres comas nuevas y un salto de párrafo, todo el contenido queda contenido en la celda
B14sin desbordar haciaC14. - Los números puros y las fórmulas no se alteran: Las celdas numéricas (precios, cantidades, identificadores numéricos) y las fórmulas de la hoja de cálculo se omiten durante el proceso de traducción y se conservan intactas; por tanto,
24.99sigue siendo24.99y nunca se convierte en24,99. - Los textos repetidos se traducen una sola vez: Si una categoría como
Electronicso una etiqueta comoIn Stockaparece en miles de filas, el sistema la procesa de manera uniforme sin duplicar costes ni generar inconsistencias.

Una vez finalizada la traducción, puedes revisar las hojas original y traducida en paralelo en el espacio de trabajo web antes de descargar el archivo. Para un análisis detallado sobre el tratamiento de libros de cálculo, consulta nuestra guía sobre cómo traducir un archivo Excel.
Paso 3: Revisar códigos alfanuméricos y exportar nuevamente a CSV UTF-8
Antes de volver a exportar a .csv, revisa las columnas que contengan cadenas alfanuméricas, como códigos SKU (BLK-SM-01), abreviaturas de unidades (pcs), nombres de fabricantes o estados de sistema. Aunque los números puros se omiten automáticamente, las celdas con abreviaturas o palabras en inglés pueden traducirse (por ejemplo, pcs traducido como "piezas" o "unidades"). Si tu base de datos o sistema de importación exige mantener identificadores en inglés en una columna concreta, copia esa columna del archivo original y pégala de nuevo.
Ten en cuenta también que los nombres de las pestañas de las hojas no se traducen. Además, si añadiste fórmulas de Excel que evalúan cadenas de texto literales (como =SI(F2="In Stock", 1, 0)), el texto dentro de la fórmula permanece en el idioma de origen; ajusta las condiciones de las fórmulas si es necesario para que coincidan con los valores traducidos antes de exportar.
Por último, en Excel, selecciona Archivo > Guardar como y elige el tipo CSV UTF-8 (delimitado por comas) (*.csv). Excel envolverá automáticamente entre comillas dobles válidas conforme a RFC 4180 cualquier celda traducida que contenga comas, saltos de línea o comillas.
Método 2: Aislar columnas de texto por identificador de fila mediante script (para desarrolladores y flujos automatizados)
Si tu archivo CSV contiene cientos de miles de filas, forma parte de una canalización de integración continua (CI/CD) o tiene 40 columnas de las cuales solo dos (title y description) requieren traducción, convertir manualmente a .xlsx no resulta eficiente.
En un flujo programado, nunca envíes líneas sin procesar a una API ni dividas cadenas con split(","). Utiliza un analizador compatible con RFC 4180 —como el módulo estándar csv de Python— para leer cada fila, traducir exclusivamente las columnas deseadas y dejar que csv.writer serialice la salida aplicando el entrecomillado y escape adecuados.
Patrón recomendado en Python:
import csv
SOURCE_FILE = "catalog_source.csv"
OUTPUT_FILE = "catalog_es.csv"
COLUMNS_TO_TRANSLATE = {"title", "description"}
def translate_text(text: str) -> str:
# Sustituir por la llamada a la API de traducción para el valor de una celda
if not text.strip():
return text
return text # marcador de posición
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)
Ventajas de este método:
newline=""ycsv.DictReadergestionan celdas multilínea: Aunque la descripción de un producto ocupe varias líneas con comas internas y comillas escapadas (""),csv.DictReaderentrega una cadena completa y limpia.- Las columnas que no deben traducirse quedan protegidas: Columnas como
id,sku,price,image_urlycreated_atno pasan por el traductor, evitando URLs rotas o decimales convertidos en comas. csv.DictWriteraplica el entrecomillado automáticamente: Cuando el texto traducido contiene comas o comillas, la configuracióncsv.QUOTE_MINIMALenvuelve el campo entre"..."y duplica las comillas interiores según la norma RFC 4180.
Si trabajas con archivos pequeños (menos de 200 filas) y prefieres evitar código, puedes importar el CSV en Google Sheets y usar =GOOGLETRANSLATE(B2, "auto", "es") en una columna auxiliar; luego copia la columna, pega solo los valores y descarga el archivo como .csv. Ten presente que las fórmulas de hojas de cálculo envían una petición por fila y pueden sufrir bloqueos o errores de tiempo de espera en hojas extensas.
Comparación rápida: ¿qué método se adapta a tu archivo CSV?
Preguntas frecuentes
¿Puedo subir un archivo .csv directamente a Equalang?
No. La herramienta de traducción de documentos de Equalang admite archivos PDF, DOCX, PPTX, XLSX, EPUB, HTML y TXT, y no acepta archivos con extensión .csv directamente. Abre el CSV en Excel o en otro editor de hojas de cálculo, guárdalo como .xlsx, traduce el libro resultante y vuelve a guardarlo como archivo CSV en UTF-8.
¿Cómo evito que Excel muestre caracteres corruptos (como ??? o é) al abrir el archivo traducido?
Guarda y abre siempre tu archivo como CSV UTF-8 (delimitado por comas). Si al hacer doble clic en Windows los caracteres aparecen dañados, abre un libro en blanco en Excel y utiliza Datos > De texto/CSV estableciendo el origen del archivo en 65001: Unicode (UTF-8).
¿Por qué se desalinearon las columnas numéricas o los precios tras traducir un CSV?
Si tradujiste el archivo como texto plano hacia un idioma que emplea la coma como separador decimal (como español, francés o alemán), un valor como 19.99 se habrá convertido en 19,99 sin comillas protectoras. Al convertir el CSV a .xlsx antes de traducirlo, las celdas numéricas se almacenan como números, por lo que el traductor las omite y permanecen inalteradas.