CSV não abre direito no Excel? Diagnóstico de separador, UTF-8, zeros e decimais
Publicado em 2026-08-15T22:27:46.547Z · atualizado em 2026-08-15T22:27:46+00:00
Aprenda a diagnosticar CSV com tudo em uma coluna, acentos quebrados, zeros perdidos e números interpretados na localidade errada.

Um arquivo CSV pode abrir inteiro em uma única coluna, transformar “João” em “João”, retirar zeros de códigos, trocar datas e interpretar 1.234,56 de maneira inesperada. Isso não significa necessariamente que o arquivo esteja corrompido. Na maioria dos casos, o programa de destino apenas fez suposições diferentes das usadas na exportação.
CSV é um formato de texto para representar registros e campos. O nome sugere valores separados por vírgula, mas o uso real varia por sistema e localidade: vírgula, ponto e vírgula e tabulação são comuns. Além disso, o arquivo não carrega um esquema completo dizendo “esta coluna é código” ou “este número usa vírgula decimal”. Se ninguém documentar essas decisões, o aplicativo tenta adivinhar.
Nunca diagnostique um CSV abrindo-o diretamente e aceitando a primeira interpretação. Primeiro observe o arquivo como texto; depois importe definindo codificação, delimitador e tipo de cada coluna.
O CSV que você vê não é o dado que o programa entende
Considere esta linha:
00127;Café moído;1.234,56;03/04/2026
Uma pessoa no Brasil pode enxergar quatro campos: código, descrição, valor e data. Um programa configurado para vírgula como delimitador pode separar o número em duas partes. Outro pode tratar 00127 como número e devolver 127. Um terceiro pode interpretar a data como 4 de março.
O arquivo não está errado isoladamente. Falta um contrato de importação. Esse contrato deve informar pelo menos codificação, delimitador, presença de cabeçalho, qualificador de texto, convenção decimal, formato de data e tipos das colunas.
Primeiro problema: tudo aparece em uma coluna
Esse sintoma quase sempre indica delimitador incorreto. Abra o arquivo em um editor de texto e examine as primeiras linhas. Veja qual caractere aparece regularmente entre os campos. Não conte apenas a primeira linha: descrições podem conter pontuação normal.
Um delimitador confiável produz a mesma quantidade de colunas na maioria dos registros. Se a primeira linha tem cinco campos e várias linhas seguintes têm seis ou quatro, pode haver aspas mal fechadas, quebras de linha internas ou delimitadores dentro do conteúdo.
No Excel, prefira importar pela área de dados e escolher explicitamente a origem do arquivo, a codificação e o delimitador. O duplo clique usa configurações regionais e pode produzir um resultado diferente em outro computador.
Aspas não são decoração
O RFC 4180 documenta uma convenção comum: campos podem ser envolvidos por aspas duplas; se um campo contém delimitador, quebra de linha ou aspas, ele deve ser protegido adequadamente; uma aspa literal é representada por duas aspas. O exemplo abaixo contém uma descrição com ponto e vírgula:
codigo;descricao;valor
00127;"Café; moagem fina";12,30
Um leitor que ignora o qualificador de texto enxerga quatro campos na segunda linha. Um leitor compatível entende que o ponto e vírgula dentro das aspas faz parte da descrição. Quando apenas algumas linhas “quebram”, procure justamente campos com delimitador, aspas ou múltiplas linhas.
Segundo problema: acentos viram símbolos estranhos
Isso é conflito de codificação. Texto é armazenado como bytes, e uma codificação define como esses bytes correspondem a caracteres. UTF-8 é amplamente usado, mas arquivos antigos podem estar em Windows-1252 ou ISO-8859-1. Se bytes UTF-8 forem lidos como outra codificação, “informação” pode aparecer corrompida.
Verifique se o sistema exportador permite escolher UTF-8. Na importação, selecione a mesma codificação. Alguns aplicativos reconhecem um marcador inicial chamado BOM; outros não precisam dele. Não adicione ou remova o marcador às cegas. Teste com palavras que contenham á, ç, ã e símbolos como R$.
Depois de abrir um texto com a codificação errada e salvá-lo, você pode substituir os bytes originais por caracteres já corrompidos. Trabalhe sempre em cópia e volte ao arquivo de origem caso a aparência mude.
Terceiro problema: zeros desaparecem
Se uma coluna contém 000127, ela pode parecer numérica, mas provavelmente é um identificador. Ao convertê-la para número, o programa remove zeros à esquerda porque eles não alteram uma quantidade. Em um código, porém, fazem parte da representação.
Defina a coluna como texto durante a importação, não depois. Formatar 127 para exibir seis dígitos pode recriar 000127, mas só é seguro se o comprimento oficial for conhecido. Se havia códigos de tamanhos diferentes, a informação original já foi perdida.
| Conteúdo | Significado | Tipo |
|---|---|---|
| 000127 | Código de item | Texto |
| 127 | Quantidade | Número inteiro |
| 03/04/2026 | Data de evento | Data com localidade |
| 03/04 | Possível código ou fração | Definir antes de converter |
Quarto problema: pontos e vírgulas mudam valores
No padrão brasileiro, a vírgula costuma separar casas decimais e o ponto marca milhares. Em outras localidades, os papéis se invertem. Assim, 1.234 pode significar mil duzentos e trinta e quatro ou um inteiro com três casas decimais, dependendo da origem.
Não resolva removendo todos os pontos e trocando todas as vírgulas. Uma coluna pode misturar números e textos; outra pode trazer valores de uma API em padrão internacional. Defina a convenção por coluna e valide com valores conhecidos. Zero, negativo, milhar e decimal são bons casos de teste.
O Power Query permite atribuir tipos com localidade. Isso é mais seguro que depender do idioma atual da máquina, especialmente quando a rotina será executada por outras pessoas. Mantenha a coluna original e faça a conversão em uma etapa registrada.
Quinto problema: datas trocam dia e mês
03/04/2026 é ambígua. Formatos ISO como 2026-04-03 reduzem a dúvida, mas você ainda deve registrar fuso horário quando houver hora. Uma data pura de competência não deve mudar de dia por conversão de fuso; um instante de publicação precisa de zona ou deslocamento.
Na importação, mantenha a coluna como texto até confirmar a convenção. Use amostras impossíveis de confundir, como 25/04/2026, e compare com a origem. Se todas as datas possuem dia menor ou igual a 12, não tente adivinhar.
Linhas com quantidade diferente de colunas
Um CSV saudável tende a manter o mesmo número de campos. Divergências apontam aspas abertas, quebra de linha dentro de campo, delimitador não protegido ou exportação interrompida. Conte colunas usando um parser, não apenas dividindo a linha pelo separador: uma divisão simples ignora aspas e falha em campos legítimos.
Registre os números das linhas problemáticas e mostre um trecho seguro para revisão. Não descarte automaticamente a linha, pois ela pode conter uma ocorrência importante. Também não desloque valores para “encaixar”; isso pode associar um preço ao código errado.
Vazios, nulos e espaços não são a mesma coisa
Um campo vazio entre dois delimitadores pode representar dado ausente. A palavra NULL pode ser um marcador do sistema ou um texto legítimo. Um campo com três espaços parece vazio, mas não é igual à string vazia em muitas comparações.
Defina a semântica: vazio significa desconhecido, não aplicável ou zero? Nunca substitua todos os vazios por zero sem regra. Em indicadores, essa decisão altera médias e totais. Remova espaços laterais para a versão normalizada, mas preserve o valor original no relatório.
Detecte duplicidades em duas camadas
Primeiro conte linhas completamente idênticas. Depois conte repetições da chave de negócio. Duas linhas podem ter o mesmo código e valores diferentes; isso não é duplicidade exata, mas uma ambiguidade que precisa de explicação.
Escolha se a chave diferencia maiúsculas, acentos e espaços. Para códigos técnicos, a comparação costuma ser literal após uma normalização definida. Para nomes, uma aproximação pode sugerir candidatos, mas não deve mesclar registros automaticamente.
Valide o arquivo sem carregar tudo na memória
Arquivos grandes pedem processamento em fluxo ou por blocos. Ler milhões de linhas de uma vez pode travar o navegador ou a planilha mesmo quando o CSV está correto. Uma inspeção inicial pode usar apenas as primeiras linhas para detectar formato, mas a validação final precisa percorrer todo o arquivo e acumular estatísticas.
Conte registros, campos inválidos, vazios por coluna, tamanhos máximos e duplicidades de chave. Mostre progresso e permita cancelar. Se a ferramenta promete processamento local, ela deve explicar limites de memória e evitar criar várias cópias completas do mesmo conteúdo.
Um roteiro de importação segura
- Duplique o arquivo original e, quando necessário, calcule um hash para comprovar que ele não mudou.
- Inspecione bytes iniciais, codificação provável e primeiras linhas.
- Detecte candidatos a delimitador comparando consistência de colunas.
- Use um parser que respeite aspas e quebras internas.
- Mantenha todas as colunas como texto na leitura inicial.
- Crie um esquema explícito para identificadores, números e datas.
- Aplique conversões em cópias das colunas e registre falhas.
- Conte linhas, colunas, vazios e duplicidades antes e depois.
- Exporte uma amostra e abra no aplicativo de destino.
- Somente então execute o lote inteiro.
Essa sequência produz evidências simples: a quantidade de linhas foi mantida, os códigos continuam com o mesmo comprimento e os totais numéricos fazem sentido. Quando algo muda, você consegue apontar a etapa exata.
Use o diagnóstico para escolher a correção
Não há uma opção “corrigir CSV” que sirva para todos os casos. Se o problema é delimitador, reimporte. Se é codificação, reabra os bytes originais com o mapa correto. Se os zeros já foram removidos e o arquivo salvo, volte à fonte. Se datas são ambíguas, peça documentação ao emissor.
Comece pelo Auditor de CSV para identificar codificação, delimitador, linhas irregulares, vazios, duplicidades e riscos de zeros à esquerda sem enviar o arquivo ao servidor. Depois, a ferramenta Converter dados ajuda a transformar CSV, Excel e JSON no navegador. Para unir arquivos, valide se todos compartilham o mesmo esquema e só então use Juntar planilhas Excel.
Monte um relatório mínimo de qualidade
Antes de entregar o arquivo corrigido, gere um resumo com codificação escolhida, delimitador, número de linhas, número de colunas e quantidade de registros rejeitados. Para cada coluna, registre vazios, valores distintos, comprimento mínimo e máximo e falhas de conversão. Em campos numéricos, compare soma e faixa antes e depois; em identificadores, conte quantos perderiam zeros se fossem tratados como número.
O relatório não precisa expor dados pessoais. Exemplos podem ser mascarados, enquanto contagens e regras permanecem úteis. Se uma linha não puder ser interpretada com segurança, exporte-a para uma área de exceções com o número da linha e o motivo, em vez de descartá-la silenciosamente.
Também registre o aplicativo e a opção usados na exportação. Dois programas podem produzir arquivos chamados CSV com codificações ou convenções diferentes. Com esse pequeno histórico, a equipe consegue repetir o processo, comparar versões e descobrir se uma anomalia nasceu na fonte, na importação ou na conversão.
Guarde esse relatório junto da versão validada e preserve o arquivo recebido. A rastreabilidade vale mais do que uma correção rápida que ninguém consegue reproduzir depois.
Checklist antes de confiar no resultado
- A codificação foi definida e os acentos conferidos?
- O delimitador produz quantidade estável de colunas?
- Aspas e quebras internas são respeitadas?
- Identificadores foram importados como texto?
- Decimal e milhar usam a localidade correta?
- Datas foram validadas com exemplos não ambíguos?
- Vazios possuem significado documentado?
- Duplicidades exatas e de chave foram separadas?
- Contagens e totais antes e depois foram comparados?
- O original continua preservado?
Conclusão
CSV não é uma planilha simplificada; é texto estruturado que depende de convenções. Quando acentos quebram, tudo cai em uma coluna ou zeros desaparecem, o caminho seguro é diagnosticar a camada responsável em vez de editar sintomas.
Observe o arquivo, defina o contrato de leitura, importe todas as colunas de forma conservadora e converta tipos somente depois. Esse cuidado transforma um formato aparentemente frágil em um meio previsível de troca de dados — e evita que uma abertura incorreta seja confundida com erro na base original.
