Um CSV abre em uma única coluna quando o programa separa os campos com um caractere diferente do que o arquivo usa: o arquivo traz ponto e vírgula e o programa espera vírgulas, ou o contrário. Acentos que viram é ou � são um problema à parte, o programa lê os bytes com uma codificação diferente daquela em que o arquivo foi salvo. Nenhum dos dois é dano ao arquivo. Cada um é um palpite que o programa deu sem perguntar a você, e um CSV não traz nenhum campo dizendo qual é o certo.
Por que meu CSV abre em uma única coluna?
Um CSV é texto com um separador entre os campos, e o formato não diz qual é esse caractere. A RFC 4180, o memorando de 2005 que descreveu a prática comum, usa a vírgula, mas é informativa e muitos arquivos reais usam outra coisa. A alternativa habitual é o ponto e vírgula, e o motivo é regional: em muitos países a vírgula é o separador decimal, então 3,50 é um número e a vírgula não pode separar também os campos.
A planilha então precisa escolher. A documentação da Microsoft diz que o separador de listas padrão ao salvar um CSV no Excel é a vírgula, que ele é controlado pelas configurações regionais do Windows e que o Excel usa ponto e vírgula quando o separador decimal está definido como vírgula. Abrir um arquivo com duplo clique aplica o que o seu próprio computador tem configurado, não o que o de quem enviou tinha. Um arquivo com ponto e vírgula de um colega em Lisboa abre como uma coluna larga em uma máquina configurada com vírgula, e um arquivo com vírgulas abre como uma coluna larga em uma máquina configurada com ponto e vírgula.
A solução é parar de deixar o programa adivinhar. No Excel, Dados e depois De Texto/CSV mostra uma pré-visualização e deixa você escolher o delimitador, e a mesma documentação informa que trocar o nome do arquivo para .txt abre o assistente de importação mais antigo. O Google Sheets e o LibreOffice também perguntam quando você importa em vez de abrir. O Excel respeita há muito tempo uma primeira linha com sep=; como instrução, mas é uma convenção de um único programa: qualquer outro leitor a trata como uma linha de dados, então não a deixe em um arquivo que será lido por um script.
Por que os acentos viram é ou �?
Texto em disco são bytes, e a codificação é a tabela que os transforma de volta em letras. A maioria dos arquivos hoje está em UTF-8, em que é ocupa dois bytes. Programas antigos do Windows costumam usar por padrão uma codificação herdada de um byte só, como o Windows-1252, em que é ocupa um. Os mesmos bytes lidos com a tabela errada dão dois padrões reconhecíveis:
é,ñ,’: um arquivo UTF-8 lido como Windows-1252. Cada letra de vários bytes vira duas ou três letras erradas.JoséviraJosé.�, o caractere de substituição: um arquivo herdado lido como UTF-8. O byte único deénão é uma sequência UTF-8 válida, então o leitor coloca um marcador e a letra original some do que você vê.
Se o Excel acerta o UTF-8 depende da versão e da plataforma, e não testei todas as versões, então trate isto como o padrão e não como uma regra sobre a sua. O que é confiável há anos é que um arquivo UTF-8 que começa com um byte order mark é reconhecido como UTF-8, e um sem essa marca pode ser lido com a página de código do sistema. A marca é o mesmo caractere invisível que explica caracteres invisíveis em um texto: inofensivo para uma planilha e incômodo para um script que não o remove.
O caminho seguro é, de novo, o explícito. Em De Texto/CSV, mude a origem do arquivo para UTF-8 e a pré-visualização deve se corrigir antes de você carregar qualquer coisa.
Como descubro qual dos dois problemas eu tenho?
Olhe para o sintoma, não para o arquivo.
| O que você vê | A causa | A solução |
|---|---|---|
| Cada linha é uma célula só, com vírgulas ou pontos e vírgulas à mostra | Delimitador diferente | Importe e escolha o delimitador |
Colunas partidas nos lugares errados, números como 3,50 cortados ao meio | A vírgula serve de decimal e de separador ao mesmo tempo | Importe com ponto e vírgula como delimitador |
é, ’ onde deveriam estar letras | UTF-8 lido como codificação herdada | Importe e escolha UTF-8 como origem do arquivo |
� onde deveriam estar letras | Arquivo herdado lido como UTF-8 | Abra-o como Windows-1252 ou Latin-1 e salve como UTF-8 |
| O cabeçalho da primeira coluna parece certo, mas uma busca por ele falha | Byte order mark no início | Remova-o, ou salve de novo sem ele |
Um aviso sobre a linha do �. Quando um arquivo foi aberto com a codificação errada e salvo de novo, as letras originais se perderam para sempre e nenhuma configuração as recupera. Volte ao download original, não à sua cópia editada.
O que o conversor daqui resolve e o que ele não consegue fazer?
O conversor de CSV para JSON cuida do delimitador e não da codificação, e a diferença vem do jeito como ele funciona. Ele lê as primeiras cinco linhas e escolhe, entre vírgula, ponto e vírgula, tabulação e barra vertical, o caractere que divide todas elas na mesma quantidade de campos. Você pode trocá-lo no menu de delimitador, o que vale a pena quando a linha de cabeçalho tem vírgulas dentro dos nomes ou as primeiras linhas são muito curtas. Um resultado de uma coluna só ali costuma significar que o palpite estava errado.
Ele não consegue consertar a codificação. O texto colado na caixa já foi decodificado pelo programa de onde você o copiou, então se mostra José o estrago aconteceu antes de chegar. Um arquivo escolhido pelo seletor é lido como UTF-8 pelo navegador e não há como escolher outra codificação, então um arquivo em Windows-1252 mostrará o caractere de substituição no lugar dos acentos. Nos dois casos a resposta é reabrir o original em um programa que deixe escolher a codificação, salvá-lo como UTF-8 e voltar. Um byte order mark no início é removido antes da análise, então não vai grudar na sua primeira chave.
O conversor também não serve para um arquivo que não possa ser lido como texto. Um .xlsx de verdade é um pacote compactado, não texto delimitado, e precisa ser exportado para CSV antes. Nada é enviado em nenhum dos casos; a página lê o arquivo. Para o que acontece com zeros à esquerda, datas e dados aninhados depois que o delimitador está certo, como converter CSV para JSON e o que quebra continua de onde este termina.
Como escrevo um CSV que abra certo em qualquer lugar?
Você não consegue deixar um arquivo correto para todos os programas, mas consegue diminuir os palpites. Salve em UTF-8, e acrescente um byte order mark só se quem vai abrir usa Excel e você já viu os acentos saírem estragados. Escolha um único delimitador e diga qual no nome do arquivo ou na mensagem que o acompanha. Se os dados têm vírgulas decimais, o ponto e vírgula evita o choque. Se o arquivo vai para um script ou outro sistema, e não para uma pessoa com uma planilha, a vírgula sem marca é a escolha mais simples, e JSON é o formato melhor quando a estrutura é mais do que linhas planas. O guia de JSON para CSV cobre o caminho inverso e o que custa achatar.
Se um arquivo abre em uma coluna só, cole-o no conversor de CSV para JSON e leia a nota abaixo da saída: ela diz qual delimitador foi usado, e você pode trocá-lo no menu. Ele roda no seu navegador, então os dados ficam na sua máquina.
Para saber o que vigiar depois que as colunas estão certas, como converter CSV para JSON e o que quebra cobre tipos, zeros à esquerda e datas.
Perguntas frequentes
Por que meu CSV abre em uma coluna só no Excel?
O Excel separa os campos com o separador de listas das configurações regionais do seu computador, e o arquivo usa outro caractere, normalmente um ponto e vírgula onde o Excel espera uma vírgula ou o contrário. Use Dados e depois De Texto/CSV, e escolha o delimitador na pré-visualização em vez de abrir o arquivo com duplo clique.
Por que meu CSV mostra é em vez de é?
O arquivo está salvo em UTF-8 e o programa o lê como uma codificação herdada de um byte, como o Windows-1252, então cada letra com acento vira dois ou três caracteres errados. Importe o arquivo de novo e escolha UTF-8 como origem. O arquivo em si não tem nada de errado.
Por que alguns CSV usam ponto e vírgula em vez de vírgula?
Nos países em que a vírgula é o separador decimal, um número como 3,50 colidiria com uma vírgula entre campos, então as planilhas de lá escrevem ponto e vírgula. A RFC 4180 descreve a vírgula, mas é informativa e os arquivos reais variam, e por isso um bom leitor deixa você escolher o delimitador.
O conversor de CSV para JSON consegue consertar acentos quebrados?
Não. Quando o texto chega à caixa ele já foi decodificado, então não há como saber qual era a codificação original, e um arquivo escolhido pelo seletor é lido apenas como UTF-8. Ele detecta o delimitador a partir das cinco primeiras linhas e remove um byte order mark inicial. Conserte a codificação no programa que abriu o arquivo.
Consigo recuperar acentos quebrados depois de salvar o arquivo?
Em geral não. Se um arquivo foi aberto com a codificação errada e salvo de novo, os caracteres originais foram substituídos e nenhuma configuração os recupera. Volte ao download ou à exportação original, abra-o com a codificação certa e salve uma cópia em UTF-8.
Última atualização 6 de novembro de 2026