Caracteres estranhos no CSV no Excel? Como corrigir o erro de UTF-8
EqualangEm resumo
Corrija caracteres corrompidos como é ou € ao abrir arquivos CSV UTF-8 no Excel usando Dados De Texto/CSV, adicionando BOM UTF-8 (utf-8-sig) ou pelo Google Planilhas.
Palavras-chave: excel csv caracteres estranhos; caracteres desconfigurados excel csv; abrir csv utf 8 excel; importar csv caracteres especiais excel; utf-8 bom excel
Ao clicar duas vezes em um arquivo .csv codificado em UTF-8, o Microsoft Excel frequentemente converte letras acentuadas, caracteres especiais e símbolos monetários em sequências estranhas como Café, München ou €. Isso ocorre porque um arquivo .csv comum é apenas texto simples e não possui um cabeçalho de metadados para indicar sua codificação; sem essa informação, as versões clássicas do Excel recorrem à página de código regional legada do sistema operacional (Windows-1252 em sistemas ocidentais, GBK ou MacRoman), a menos que o arquivo comece com a marca de ordem de byte (BOM) UTF-8 de 3 bytes (EF BB BF). É possível corrigir essa exibição em menos de um minuto sem quebrar colunas nem perder zeros à esquerda. O cuidado fundamental é não pressionar Ctrl+S nem Ctrl+B para salvar enquanto os caracteres estiverem corrompidos na tela, pois isso sobrescreverá permanentemente o arquivo com dados danificados.
Comparação rápida: 3 formas de abrir CSVs em UTF-8 sem erros
Escolha a solução mais indicada de acordo com a origem do arquivo .csv e o perfil de quem precisará abri-lo:
Solução 1: Importar via Dados > De Texto/CSV (e preservar zeros à esquerda)
Quando você recebe um arquivo .csv exportado do Shopify, Stripe, PostgreSQL ou gerado no macOS/Linux, abrir com clique duplo contorna o seletor de codificação do Excel. A importação por meio da guia Dados força o Excel a interpretar o arquivo como 65001: Unicode (UTF-8) e permite fixar colunas de SKUs ou números de telefone antes que o Excel remova os zeros à esquerda.
- Abra o Microsoft Excel e inicie uma Pasta de trabalho em branco (não dê duplo clique no arquivo
.csv). - Acesse a guia Dados (
Data) na faixa de opções e clique em De Texto/CSV (From Text/CSV) no grupo Obter e Transformar Dados. - Selecione o arquivo
.csvdesejado e clique em Importar. - Na janela de pré-visualização exibida, localize o menu suspenso Origem do Arquivo (
File Origin) no canto superior esquerdo. Altere a codificação padrão (como1252: Europa Ocidental (Windows)) para65001: Unicode (UTF-8). - Verifique a tabela de visualização: textos desconfigurados como
Cafévoltarão imediatamente ao formato correto (Café). - Opcional (preservar zeros à esquerda e códigos longos): Se a tabela contiver CEPs, telefones ou SKUs iniciados por zero (como
00412), clique em Transformar Dados (Transform Data) no canto inferior direito para abrir o Power Query. Selecione essas colunas, altere o Tipo de Dados deNúmero InteiroparaTextoe clique em Fechar e Carregar (Close & Load). - Se não for necessário ajustar tipos de colunas, basta clicar em Carregar (
Load).
Solução 2: Adicionar um BOM UTF-8 (EF BB BF) para funcionar no clique duplo
Se você gera arquivos .csv para colegas ou clientes que costumam abrir arquivos diretamente pelo Explorador de Arquivos ou Finder, orientar cada usuário a seguir o processo manual de importação nem sempre é viável.
A alternativa mais eficiente é adicionar uma marca de ordem de byte UTF-8 (BOM) de 3 bytes (os bytes hexadecimais EF BB BF, ou \xEF\xBB\xBF) no byte 0 do arquivo. Quando o Excel encontra essa assinatura no início do .csv, ativa imediatamente a leitura em UTF-8 ao clicar duas vezes.
No Python (com pandas ou módulo csv padrão)
Por padrão, pandas.DataFrame.to_csv() grava em UTF-8 padrão sem BOM (encoding="utf-8"). Altere o parâmetro de codificação para utf-8-sig para que o Python inclua o cabeçalho BOM de 3 bytes automaticamente:
import pandas as pd
df = pd.DataFrame({
"city": ["München", "São Paulo", "東京"],
"item": ["Café", "Crème brûlée", "抹茶"],
"price": ["€4.50", "€6.00", "¥600"]
})
# UTF-8 padrão sem BOM (fica corrompido ao clicar duas vezes no Excel)
# df.to_csv("report_no_bom.csv", index=False, encoding="utf-8")
# UTF-8 com BOM (abre normalmente no clique duplo no Excel)
df.to_csv("report_excel_ready.csv", index=False, encoding="utf-8-sig")
Se você utiliza o módulo nativo com open() e csv.writer, passe encoding="utf-8-sig" para a função open():
import csv
with open("report_excel_ready.csv", "w", newline="", encoding="utf-8-sig") as f:
writer = csv.writer(f)
writer.writerow(["city", "item", "price"])
writer.writerow(["München", "Café", "€4.50"])
No terminal do macOS ou Linux
Para ajustar um arquivo .csv UTF-8 já existente pela linha de comando sem abrir um editor de texto, insira os bytes \xEF\xBB\xBF usando printf e cat:
printf '\xEF\xBB\xBF' | cat - clean.csv > excel_ready.csv
No próprio Excel (Salvar Como)
Caso já tenha importado os dados corretamente e queira gerar um arquivo .csv que outras pessoas possam abrir diretamente com clique duplo:
- Acesse Arquivo > Salvar Como e selecione a opção
CSV UTF-8 (delimitado por vírgulas) (*.csv)no menu de formatos. Evite selecionar as opções legadasCSV (delimitado por vírgulas) (*.csv)ouCSV para Macintosh (*.csv).
Quando NÃO utilizar o BOM UTF-8
Embora o Excel dependa do BOM para reconhecimento automático no clique duplo, as especificações oficiais do padrão Unicode ressaltam que o BOM não é exigido nem recomendado para fluxos UTF-8 gerais no ecossistema Unix/Linux. Analisadores rígidos de linha de comando ou scripts antigos que não removem \xEF\xBB\xBF interpretarão esses três bytes como parte do nome da primeira coluna (transformando "id" em "\ufeffid"). Adote duas regras práticas:
- Para enviar arquivos
.csva pessoas que usam o Excel: Utilizeutf-8-sig(UTF-8 com BOM). - Para carregar arquivos
.csvem pipelines do Linux, rotinas em segundo plano ou bancos de dados: Utilizeutf-8padrão (sem BOM).
Solução 3: Abrir no Google Planilhas ou LibreOffice Calc
Se preferir não usar o terminal nem a interface do Power Query no Excel, abra o arquivo em uma ferramenta de planilhas configurada nativamente para UTF-8:
- Google Planilhas: Crie uma planilha em branco -> Arquivo > Importar > Fazer upload -> escolha o arquivo
.csv. O Google Planilhas reconhece UTF-8 padrão automaticamente sem precisar de BOM. Em seguida, clique em Arquivo > Fazer o download > Microsoft Excel (.xlsx) para obter uma planilha nativa onde a codificação de caracteres não causa conflitos. - LibreOffice Calc: Ao abrir qualquer
.csv, o aplicativo exibe diretamente uma caixa de diálogo de importação. Confirme se o campo Conjunto de caracteres está definido comoUnicode (UTF-8)e marque as colunas necessárias comoTextoantes de confirmar em OK.
Se você também precisa traduzir uma planilha de produtos ou catálogo multilíngue em formato .csv ou .xlsx mantendo os delimitadores e a codificação UTF-8 intactos, veja nossos guias sobre como traduzir um arquivo CSV e como traduzir um arquivo Excel.
Por que Café vira Café no Excel?
A presença de sequências como é ou € em uma planilha não é uma falha aleatória de transferência, mas sim um resultado técnico determinístico:
- Arquivos
.csvcomuns são apenas sequências brutas de bytes: Diferente de arquivos.xlsx(que são pacotes compactados contendo arquivos XML com declaração explícita de UTF-8), arquivos.csvnão têm metadados de cabeçalho. Ferramentas modernas (comopandasno Python, PostgreSQL, Shopify, Stripe, Google Planilhas e comandos Unix) exportam arquivos.csvem UTF-8 sem BOM. - O UTF-8 usa de 2 a 4 bytes para caracteres fora do padrão ASCII: Caracteres básicos do alfabeto inglês e numerais (
A-Z,0-9) ocupam 1 byte único (0x00a0x7F), idêntico no UTF-8 e em páginas legadas. Qualquer caractere com acento ou símbolo utiliza múltiplos bytes:- A letra
é(U+00E9) é codificada em UTF-8 com 2 bytes:C3 A9. - A letra
ü(U+00FC) é codificada em UTF-8 com 2 bytes:C3 BC. - O símbolo do euro
€(U+20AC) é codificado com 3 bytes:E2 82 AC. - Caracteres de alfabetos como japonês, árabe ou chinês costumam ocupar 3 bytes cada.
- A letra
- O Excel aplica a página de código legada do sistema operacional: Ao abrir um arquivo
.csvsem BOM com clique duplo, as versões tradicionais do Excel interpretam cada byte isoladamente usando a página regional do sistema (Windows-1252em instalações ocidentais,GBKem chinês ouMacRoman).
Ao processar os bytes múltiplos do UTF-8 como caracteres individuais sob Windows-1252, surge o mojibake característico:
Como os dados gravados no disco continuam preservados em UTF-8, fechar a janela sem salvar mantém as informações intactas. No entanto, se você pressionar Ctrl+S ou Ctrl+B, o Excel salvará o texto corrompido (Café) de volta ao arquivo, substituindo irreversivelmente a codificação original.
Perguntas frequentes
Por que salvar o arquivo no Excel estragou os caracteres permanentemente?
Ao abrir um arquivo .csv em UTF-8 usando uma página legada como Windows-1252, o Excel já converteu a exibição para caracteres incorretos na tela (como Café). Salvar o arquivo nesse momento faz com que o Excel grave esses caracteres errados no disco, destruindo os bytes originais em UTF-8. Se isso já aconteceu, gere uma nova exportação do .csv na ferramenta de origem ou restaure uma versão de backup antes de aplicar a Solução 1 ou a Solução 2.
Por que o Google Planilhas abre o mesmo CSV sem nenhum erro de caractere?
O Google Planilhas não utiliza as páginas de código regionais do Windows ou do macOS instaladas na sua máquina local; por padrão, o serviço interpreta todos os uploads de arquivos .csv diretamente como UTF-8. Como quase todas as ferramentas e bancos de dados modernos exportam nesse formato, o arquivo é exibido corretamente de forma imediata.
Como impedir que o Excel apague zeros à esquerda (00412) ou resuma números longos como 1.23E+15 no CSV?
A inclusão do BOM UTF-8 resolve a leitura dos caracteres acentuados no clique duplo, mas não impede o comportamento padrão do Excel de converter colunas com aparência de número em valores numéricos, apagando zeros à esquerda de CEPs ou códigos de produto e cortando identificadores com mais de 15 dígitos. Para proteger essas colunas, use sempre o caminho Dados > De Texto/CSV, clique no botão Transformar Dados e altere o tipo dessas colunas para Texto antes de carregar a planilha.