Como Traduzir um Arquivo CSV sem Desalinhar Colunas nem Corromper Dados

Equalang

Em 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 (CRLF ou LF).
  • 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:

  1. 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.
  2. Números decimais localizados: Ao traduzir para idiomas como português, francês ou espanhol, valores como 12.50 frequentemente viram 12,50 ou 1,200 vira 1.200. Em colunas numéricas sem aspas, 12,50 passa a ser interpretado como duas colunas distintas (12 e 50), deslocando códigos SKU, estoques e datas para a coluna seguinte.
  3. 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 B14 sem afetar a coluna C14.
  • 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.99 continua 24.99 e nunca vira 24,99.
  • Termos repetidos são traduzidos uma única vez: Categorias ou status recorrentes (como Electronics ou In Stock) distribuídos em milhares de linhas são processados de forma padronizada sem retrabalho.
Planilha XLSX traduzida mantendo a estrutura de colunas, células numéricas e fórmulas intactas
A captura de tela ilustra a interface em inglês de uma planilha XLSX: converter o CSV para XLSX antes da tradução no Equalang mantém cada campo de texto fixo em sua célula e preserva números e fórmulas sem alterações

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:

  1. newline="" e csv.DictReader tratam células com quebra de linha: Mesmo que a descrição de um item ocupe cinco linhas com vírgulas e aspas escapadas (""), o csv.DictReader entrega uma string íntegra.
  2. Colunas técnicas e numéricas permanecem intocadas: Campos como id, sku, price e image_url não passam pelo serviço de tradução, evitando custos desnecessários, links quebrados ou números convertidos em vírgulas.
  3. csv.DictWriter reaplica aspas de forma automática: Quando o texto traduzido traz novas vírgulas ou aspas, o modo csv.QUOTE_MINIMAL protege 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?

CenárioFluxo recomendadoO que observar
100 a 50.000 linhas, colunas mistas de texto e números, rótulos repetidosConverter .csv → .xlsx, traduzir no Equalang e exportar como CSV UTF-8Recopie colunas de SKUs ou códigos se seus sistemas de destino exigirem os termos originais em inglês
Menos de 200 linhas, consulta rápida e pontualAbrir no Google Sheets, usar =GOOGLETRANSLATE() em coluna auxiliar e exportar como CSVAs fórmulas recalculam individualmente e podem falhar por timeout; cole apenas os valores antes de exportar
Pipeline automatizado ou bases volumosas (+100.000 linhas)Processar com csv.DictReader em Python, traduzir colunas específicas e gravar com csv.DictWriterArmazene em cache frases repetidas em um dicionário local para evitar chamadas redundantes à API

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.

Fontes