--:--:--

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.

Arquivo CSV passa por um scanner de qualidade que identifica separadores, codificação, decimais, vazios, duplicidades e zeros à esquerda
CSV é simples na aparência, mas separador, codificação e tipos precisam de um contrato explícito.

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.

Regra de ouro

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.

Contrato de leitura de um CSVUm arquivo de texto é interpretado por seis decisões: codificação, delimitador, aspas, cabeçalho, localidade e tipos.ARQUIVObytesCONTRATOUTF-8delimitador ;aspas duplascabeçalhopt-BRtipos explícitosTABELA
Importar corretamente é aplicar um contrato; abrir com duplo clique deixa decisões importantes para o padrão do aplicativo.

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údoSignificadoTipo
000127Código de itemTexto
127QuantidadeNúmero inteiro
03/04/2026Data de eventoData com localidade
03/04Possível código ou fraçãoDefinir 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.

Fluxo de diagnóstico de CSVO fluxo verifica codificação, separador, estrutura, tipos e integridade antes da exportação.AMOSTRAprimeiras linhasCODIFICAÇÃOacentos íntegrosSEPARADORcolunas estáveisESTRUTURAaspas e linhasTIPOStexto · data · valorRELATÓRIOválidorevisar
Diagnóstico separa problemas de leitura dos problemas reais do dado antes de qualquer conversão.

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

  1. Duplique o arquivo original e, quando necessário, calcule um hash para comprovar que ele não mudou.
  2. Inspecione bytes iniciais, codificação provável e primeiras linhas.
  3. Detecte candidatos a delimitador comparando consistência de colunas.
  4. Use um parser que respeite aspas e quebras internas.
  5. Mantenha todas as colunas como texto na leitura inicial.
  6. Crie um esquema explícito para identificadores, números e datas.
  7. Aplique conversões em cópias das colunas e registre falhas.
  8. Conte linhas, colunas, vazios e duplicidades antes e depois.
  9. Exporte uma amostra e abra no aplicativo de destino.
  10. 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.

Fontes e documentação

#CSV #Excel #UTF-8 #qualidade de dados #dados