Como Traduzir um Arquivo CSV sem Desalinhar Colunas nem Corromper Dados
EqualangEm resumo
Traduza arquivos CSV para português ou outros idiomas sem que vírgulas ou aspas desloquem colunas. Converta para XLSX primeiro ou isole colunas de texto por script.
Palavras-chave: traduzir arquivo csv; traduzir csv para portugues; traduzir arquivo csv online; traduzir csv sem desalinhar colunas; tradutor de csv
Traduzir um arquivo CSV diretamente como texto simples quase sempre corrompe sua estrutura e desalinha as colunas. Como o formato CSV depende de vírgulas, quebras de linha e aspas duplas literais para delimitar o início e o fim de cada célula, qualquer vírgula inserida em uma frase traduzida — ou um número decimal como 12.50 adaptado para 12,50 — divide um campo em dois e empurra todas as colunas seguintes para a direita. Para traduzir um arquivo CSV para português ou outro idioma com total integridade, é fundamental separar os limites das células do conteúdo textual antes do processo de tradução. A seguir, apresentamos duas abordagens práticas: converter o CSV em uma planilha Excel (.xlsx) para isolar cada campo em sua própria célula ou extrair apenas as colunas de texto via script com base no identificador da linha.
Por que arquivos CSV puros quebram em tradutores de texto simples
De acordo com a especificação técnica do formato CSV (RFC 4180), um arquivo CSV não possui grades visuais ocultas, sendo estruturado apenas por caracteres:
- Os campos são separados por vírgulas (
,), e os registros são separados por quebras de linha (CRLFouLF). - Qualquer campo que contenha uma vírgula, uma quebra de linha ou aspas duplas (
") deve obrigatoriamente ser envolvido por aspas duplas. - Aspas duplas literais dentro de um campo entre aspas devem ser escapadas duplicando-as (
"").
Ao colar o texto bruto de um CSV em um tradutor comum ou carregar um arquivo .csv renomeado como .txt, a ferramenta interpreta cada linha como uma frase comum e não como um registro tabular estruturado. Isso resulta em três falhas imediatas:
- Vírgulas não escapadas na tradução: Uma frase original sem vírgula (
Livraison gratuite dès 50 EUR) é traduzida como"Frete grátis, para pedidos acima de 50 EUR". Se o campo original não estava entre aspas, essa nova vírgula cria uma coluna extra imediatamente naquela linha. - Números decimais localizados: Ao traduzir para idiomas como português, francês ou espanhol, valores como
12.50frequentemente viram12,50ou1,200vira1.200. Em colunas numéricas sem aspas,12,50passa a ser interpretado como duas colunas distintas (12e50), deslocando códigos SKU, estoques e datas para a coluna seguinte. - Quebra de pares de aspas e aspas tipográficas: Tradutores genéricos com frequência substituem aspas retas ASCII (
"") por aspas curvas (“”ou« ») ou omitem a aspa de fechamento em descrições longas. Quando o par de aspas é corrompido, o leitor de CSV agrupa centenas de linhas subsequentes em uma única célula gigante.
CSV original (3 colunas: sku, title, price_usd):
SKU-104,Wireless mouse with USB receiver,24.99
Saída corrompida após tradução em texto simples (4 colunas em vez de 3):
SKU-104,Mouse sem fio, com receptor USB,24,99
Método 1: Converter CSV para XLSX, traduzir célula por célula e exportar de volta para CSV
Para catálogos de e-commerce, tabelas de localização, respostas de pesquisas ou planilhas financeiras, o fluxo mais seguro consiste em converter o .csv em uma planilha Excel (.xlsx), realizar a tradução do .xlsx célula por célula e salvar o resultado final novamente como CSV em formato UTF-8.
Demonstramos essa etapa com a tradução de documentos do Equalang. Vale destacar uma restrição técnica importante: o Equalang aceita formatos PDF, DOCX, PPTX, XLSX, EPUB, HTML e TXT, mas não processa arquivos .csv diretamente. A conversão prévia de .csv para .xlsx é necessária para o envio e garante que pontuações dentro de frases traduzidas jamais interfiram na divisão das colunas.
Passo 1: Importar o CSV em um editor de planilhas e salvar como .xlsx
Não altere simplesmente a extensão do arquivo de .csv para .xlsx no gerenciador de arquivos. Abra ou importe o CSV em um editor como Microsoft Excel, LibreOffice Calc ou Google Sheets para que o interpretador estruture as colunas corretamente e salve uma cópia como pasta de trabalho do Excel (.xlsx).
Caso seu CSV contenha caracteres com acentuação, caracteres asiáticos ou cirílicos, utilize no Excel o menu Dados > De Texto/CSV e configure a origem do arquivo para 65001: Unicode (UTF-8) antes de carregar os dados (veja o guia oficial de importação e exportação de arquivos de texto e CSV do Microsoft Excel). Abrir um arquivo CSV UTF-8 sem BOM diretamente com dois cliques em certas versões do Excel pode corromper caracteres acentuados antes mesmo de iniciar a tradução.
Passo 2: Traduzir o arquivo .xlsx
Envie o arquivo .xlsx na página de Documentos do Equalang e selecione o idioma de destino (a tradução de documentos suporta português, inglês, espanhol, francês, alemão, italiano, japonês, coreano, chinês e outros idiomas, com detecção automática do idioma de origem). É possível verificar como o consumo de tokens é calculado na página de preços.
Como o arquivo .xlsx armazena cada campo como uma célula individual em vez de texto separado por vírgulas:
- Vírgulas e quebras de linha ficam restritas à célula: Se uma descrição traduzida ganhar três vírgulas e uma nova linha, todo o conteúdo permanece dentro da célula
B14sem afetar a colunaC14. - Números puros e fórmulas permanecem inalterados: Células numéricas (preços, quantidades, identificadores numéricos) e fórmulas de cálculo são ignoradas pelo tradutor e mantidas exatamente como no original; assim,
24.99continua24.99e nunca vira24,99. - Termos repetidos são traduzidos uma única vez: Categorias ou status recorrentes (como
ElectronicsouIn Stock) distribuídos em milhares de linhas são processados de forma padronizada sem retrabalho.

Ao término do processamento, você pode comparar as versões original e traduzida lado a lado no painel antes de baixar o documento. Para mais detalhes sobre o comportamento de planilhas, veja nosso guia sobre como traduzir um arquivo Excel.
Passo 3: Conferir códigos alfanuméricos e exportar de volta para CSV UTF-8
Antes de exportar novamente para .csv, faça uma rápida verificação em colunas com códigos alfanuméricos, como SKUs (BLK-SM-01), siglas de unidades (pcs), nomes de fabricantes ou identificadores de status usados por sistemas integrados. Células numéricas puras são ignoradas automaticamente, mas campos com palavras ou abreviações em inglês podem acabar sendo traduzidos (por exemplo, pcs virando "peças"). Se seu banco de dados exige valores originais específicos em inglês, basta copiar essa coluna da planilha original e colar por cima da versão traduzida.
Além disso, os nomes das abas da planilha não são traduzidos. Caso tenha incluído fórmulas que testam textos literais entre aspas (como =SE(F2="In Stock"; 1; 0)), a condição interna da fórmula permanece no idioma de origem, sendo necessário atualizá-la para corresponder aos termos traduzidos antes da exportação.
Por fim, no Excel, clique em Arquivo > Salvar Como e escolha o formato CSV UTF-8 (Delimitado por vírgula) (*.csv). O Excel adicionará aspas duplas de proteção em conformidade com o padrão RFC 4180 em todos os campos traduzidos que apresentarem vírgulas, quebras de linha ou aspas.
Método 2: Isolar colunas de texto por ID de linha via script (para desenvolvedores e pipelines)
Caso seu arquivo CSV tenha centenas de milhares de linhas, esteja inserido em um pipeline automatizado de CI/CD ou possua dezenas de colunas onde apenas duas (title e description) precisam de tradução, o processo manual via .xlsx deixa de ser prático.
Em fluxos automatizados, evite quebrar linhas com split(",") ou enviar o texto bruto para APIs. A prática recomendada é utilizar uma biblioteca compatível com RFC 4180 — como o módulo nativo csv do Python — para ler cada registro, traduzir apenas os campos de texto necessários e deixar o csv.writer cuidar da serialização e do escape.
Exemplo em Python:
import csv
SOURCE_FILE = "catalog_source.csv"
OUTPUT_FILE = "catalog_pt.csv"
COLUMNS_TO_TRANSLATE = {"title", "description"}
def translate_text(text: str) -> str:
# Substitua pela chamada à API de tradução para o valor de uma célula
if not text.strip():
return text
return text # marcador provisório
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)
Por que essa abordagem funciona:
newline=""ecsv.DictReadertratam células com quebra de linha: Mesmo que a descrição de um item ocupe cinco linhas com vírgulas e aspas escapadas (""), ocsv.DictReaderentrega uma string íntegra.- Colunas técnicas e numéricas permanecem intocadas: Campos como
id,sku,priceeimage_urlnão passam pelo serviço de tradução, evitando custos desnecessários, links quebrados ou números convertidos em vírgulas. csv.DictWriterreaplica aspas de forma automática: Quando o texto traduzido traz novas vírgulas ou aspas, o modocsv.QUOTE_MINIMALprotege o campo com"..."e duplica aspas internas conforme a norma RFC 4180.
Para tabelas pequenas (menos de 200 linhas) sem necessidade de scripts, é possível importar o arquivo no Google Sheets e utilizar a fórmula =GOOGLETRANSLATE(B2; "auto"; "pt") em uma coluna auxiliar; em seguida, copie os dados, cole apenas os valores e faça o download como .csv. Lembre-se de que fórmulas desse tipo realizam uma requisição individual por linha e podem apresentar lentidão ou erro de tempo limite em bases maiores.
Comparativo rápido: qual fluxo escolher para seu CSV?
Perguntas frequentes
Posso enviar um arquivo .csv diretamente para o Equalang?
Não. O tradutor de documentos do Equalang aceita arquivos nos formatos PDF, DOCX, PPTX, XLSX, EPUB, HTML e TXT, não recebendo arquivos .csv de forma direta. Abra o CSV no Excel ou em outro editor de planilhas, salve como .xlsx, traduza o arquivo gerado e exporte a planilha traduzida de volta para CSV em formato UTF-8.
Como evitar que o Excel exiba caracteres corrompidos (como ??? ou é) no CSV traduzido?
Sempre salve e abra seu arquivo no formato CSV UTF-8 (Delimitado por vírgula). Caso o arquivo apresente caracteres desconfigurados ao abri-lo com dois cliques no Windows, inicie uma pasta de trabalho em branco no Excel e utilize o menu Dados > De Texto/CSV, selecionando a origem do arquivo como 65001: Unicode (UTF-8).
Por que as colunas numéricas ou de preços mudaram de posição após a tradução do CSV?
Se o CSV foi traduzido como texto puro para um idioma que adota a vírgula como separador decimal (como português ou espanhol), valores como 19.99 provavelmente se transformaram em 19,99 sem aspas de proteção. Ao converter previamente o arquivo para .xlsx, os dados numéricos são preservados como números, sendo ignorados pelo processo de tradução e mantidos na posição original.