Problemas de codificação e BOM

Última atualização: 16 de maio de 2026

Caracteres embaralhados e erros de página de código quase sempre têm uma única causa: o arquivo perdeu sua marca de ordem de bytes (BOM) UTF-8. O Daxlate sempre grava o CSV como UTF-8 com BOM, que é o que o Excel no Windows espera ao abrir com clique duplo, então um ciclo de ida e volta com falha costuma significar que outra ferramenta salvou o arquivo novamente no meio do caminho. Cada sintoma abaixo traz a causa e a solução.

Sintoma: o CSV abre com caracteres embaralhados no Excel #

Causa: o arquivo foi aberto ou salvo de novo por uma ferramenta que removeu o BOM UTF-8, ou que converteu para uma página de código antiga (por exemplo, Windows-1252).

Solução: exporte de novo pelo aplicativo, em Arquivo → Exportar traduções…. O gravador de CSV do Daxlate sempre emite UTF-8 com BOM, que é o que o Excel no Windows espera para abrir com duplo clique. Se você estiver trabalhando com um arquivo de outra origem, salve-o de novo como UTF-8 com BOM no Notepad++ ou no VS Code antes de importar.

Sintoma: a importação falha com “página de código incompatível” ou um erro de análise #

Causa: o arquivo foi salvo sem codificação UTF-8, então os caracteres fora do ASCII chegam corrompidos antes mesmo de alcançar o analisador.

Solução: abra o arquivo em um editor que mostre a codificação (Notepad++, VS Code, Sublime), salve de novo como UTF-8 com BOM e tente importar outra vez.

Sintoma: emojis ou caracteres CJK raros somem na ida e volta #

Causa: a planilha foi aberta em um editor que não dá suporte completo a Unicode além do Plano Multilíngue Básico, ou foi salva como CSV antigo via “Salvar como CSV” em alguma ferramenta que não é o Excel.

Solução: prefira XLSX a CSV para conteúdo que usa caracteres dos planos suplementares, como emojis, CJK raro e escritas históricas. O armazenamento em XLSX não deixa dúvida; o CSV depende da codificação que o produtor escolheu.

Sintoma: a prévia da importação mostra “Coluna desconhecida ignorada: …” #

Causa: o arquivo tem colunas que não batem com o padrão de cabeçalhos do Daxlate (Object ID, Type, Parent, Name, Caption ({culture}), Description ({culture})). Tradutores às vezes acrescentam colunas de anotações, e o importador as descarta com um aviso em vez de derrubar a importação inteira.

Solução: se o aviso era esperado, ignore. Se uma cultura que você esperava não está sendo detectada, confira o cabeçalho da coluna. Ele precisa ser exatamente Caption (xx-XX) ou Description (xx-XX), com parênteses e um código de cultura do .NET válido.