CSV: o arquivo que quase toda ferramenta exporta

Você exportou um relatório, abriu no Excel ou no Sheets e os acentos saíram quebrados. Ou as colunas se misturaram. Nada de misterioso: é CSV. Este artigo explica o que é, como abrir sem bagunça e quando outro formato faz mais sentido.

Cena: exportou e a planilha virou hieróglifo

Você precisa de uma lista de clientes, de vendas ou de inscritos. O sistema tem um botão “Exportar”. Você clica, baixa um arquivo .csv e abre clicando duas vezes.

Na tela aparece algo assim: João, São Paulo, ou um bloco de texto numa única coluna, com vírgulas no meio do nome e números partidos ao meio. Às vezes a data vira código. Às vezes o valor 1.250,90 vira mil e duzentos e cinquenta com noventa centavos no lugar errado, ou pior: vira texto inútil.

A primeira reação é culpar a ferramenta. A segunda é “salvar de novo” e piorar. A terceira, se alguém na equipe já passou por isso, é lembrar: CSV não é planilha. É texto organizado em linhas e colunas. Quando o programa que abre o arquivo “chuta” o separador ou a codificação errada, o resultado parece hieróglifo.

Isso acontece o tempo todo porque quase todo sistema exporta CSV: CRM, e-commerce, formulários, bancos, plataformas de curso, ferramentas de marketing. É o formato coringa do “me manda os dados”. Barato de gerar, fácil de ler por máquina, e fácil de abrir no lugar errado.

Se você entende três coisas (separador, encoding e “como importar de verdade”), a maior parte desses sustos some. O resto do artigo é isso, sem jargão de sobra.

CSV em uma frase

CSV (Comma-Separated Values) é um arquivo de texto em que cada linha é um registro e os campos de cada registro são separados por um caractere (em geral vírgula, no Brasil muitas vezes ponto e vírgula).

Não há formatação de célula, não há abas, não há fórmulas. Só dados em texto: nomes, números, datas escritas como texto, e-mails, códigos. Se você abrir o arquivo num editor simples (Bloco de Notas, VS Code, TextEdit), vê exatamente o que está lá: linhas e separadores.

Um exemplo mínimo:

nome;cidade;valor

Maria Souza;Curitiba;150.00

João Silva;São Paulo;89.90

Três colunas, dois registros. Qualquer planilha ou script consegue “montar” isso em tabela, desde que saiba qual é o separador e qual é a codificação dos caracteres.

Por que quase toda ferramenta exporta CSV? Porque é simples de produzir, leve para baixar e compatível com dezenas de sistemas. Não depende de uma versão específica do Excel. Não exige biblioteca proprietária. Para importar em outra ferramenta, CSV costuma ser a opção mais estável.

Se você já lidou com JSON, a ideia é parecida no espírito (dados estruturados em texto), mas o CSV é mais “tabela plana”: linhas e colunas, sem objetos aninhados. Para listas e relatórios tabulares, CSV ganha em simplicidade. Para estruturas mais complexas, JSON (ou outro formato) costuma servir melhor.

Separador: vírgula, ponto-e-vírgula e tab

O “C” de CSV sugere vírgula (comma). Na prática, o separador muda conforme o país, o sistema e a configuração do Excel.

No Brasil e em vários países da Europa, a vírgula é o separador decimal (10,50). Se o CSV usasse vírgula também entre colunas, um número com casas decimais quebraria a linha. Por isso muitos sistemas brasileiros exportam com ponto e vírgula (;) entre campos e usam vírgula ou ponto nos números, conforme a regra do sistema.

Nos EUA e em muita documentação técnica, o padrão é vírgula (,) entre campos e ponto (.) nos decimais.

Há ainda o TSV: campos separados por tabulação (a tecla Tab). Às vezes o arquivo ainda se chama .csv por hábito, mesmo sendo tab. E há exports com pipe (|) ou outros caracteres raros.

Como descobrir o separador sem adivinhar:

1. Abra o arquivo num editor de texto (não na planilha).
2. Olhe a primeira linha (geralmente o cabeçalho).
3. Veja o que aparece entre os nomes das colunas: ;, , ou um espaço “largo” (tab).

Se você abrir no Excel ou no Sheets “no automático” e tudo cair numa coluna só, quase sempre o programa esperava vírgula e o arquivo usa ponto e vírgula (ou o contrário). Não é arquivo corrompido. É só o separador errado na importação.

Dica prática: ao exportar, se a ferramenta oferecer escolha, anote o que escolheu. Ao importar, diga explicitamente o mesmo separador. “Abrir com duplo clique” é conveniente quando dá certo e uma loteria quando o locale do seu computador não bate com o do arquivo.

Acentos e encoding (UTF-8)

Acentos, ç, ñ e símbolos não são “mágica visual”. São bytes interpretados segundo uma codificação (encoding). Se o arquivo foi salvo em UTF-8 e o programa abre como se fosse Windows-1252 (ou Latin-1), aparece João em vez de João. Se for o caminho inverso, outros caracteres estranhos surgem.

UTF-8 é o padrão atual da web e da maior parte das ferramentas modernas. É o que você quer na maioria dos casos: funciona bem com português, espanhol, nomes próprios e emojis (quando existirem nos dados).

O problema clássico no Windows + Excel é histórico. Por muito tempo o Excel no Windows abria CSV assumindo a página de código regional, não UTF-8. Resultado: arquivo perfeito no Google Sheets, “quebrado” no Excel local, ou o contrário, conforme quem gerou o arquivo.

O que fazer na prática:

• Prefira exportar em UTF-8 quando a opção existir.
• Se a ferramenta oferecer “UTF-8 com BOM”, no Excel do Windows isso às vezes ajuda o programa a reconhecer a codificação. Nem sempre é necessário no Sheets.
• Nunca “corrija” acentos na mão salvando por cima sem saber o encoding. Você pode gravar o erro permanente.
• Se os acentos já estão errados na tela, volte ao arquivo original e importe de novo com a codificação certa. Editar hieróglifo quase nunca recupera o texto original de forma confiável.

Outro detalhe: aspas. Campos que contêm o próprio separador (vírgula no meio de um endereço, por exemplo) costumam vir entre aspas duplas. Quebras de linha dentro de um campo também. Se alguém “consertar” o CSV no Bloco de Notas apagando aspas, a estrutura quebra. Trate o arquivo como dado estruturado, não como rascunho de texto livre.

Abrir no Sheets e no Excel sem estragar

Regra de ouro: importe, não só “abra”. O fluxo de importação deixa você escolher separador e, em muitos casos, encoding. O duplo clique usa o padrão do sistema e erra em silêncio.

Google Sheets

1. Crie uma planilha vazia (ou use Arquivo > Importar).
2. Em Importar, envie o .csv.
3. Em “Separador”, escolha o que você viu no editor de texto (vírgula, ponto e vírgula, ou personalizado).
4. Confira a pré-visualização: colunas alinhadas, acentos corretos, números coerentes.
5. Importe. Só então salve ou compartilhe.

Sheets lida bem com UTF-8 na maior parte dos casos. Se ainda assim os acentos falharem, o arquivo pode ter sido gerado em outra codificação: tente reexportar em UTF-8 na origem.

Excel (Windows e Mac)

Evite o duplo clique quando o arquivo vier de sistema brasileiro ou de outra ferramenta web.

No Excel moderno (Microsoft 365 e versões recentes):

1. Aba Dados > Obter dados / De texto ou CSV.
2. Selecione o arquivo.
3. Na janela de pré-visualização, ajuste Origem do arquivo (encoding): tente UTF-8.
4. Ajuste Delimitador: vírgula, ponto e vírgula ou tab.
5. Confira as colunas. Se datas e números parecerem certos, carregue.

No Mac o Excel costuma se comportar um pouco melhor com UTF-8, mas a importação guiada ainda é mais segura do que abrir direto.

Números e datas

CSV não “sabe” que 03/04/2026 é dia 3 ou dia 4. Depende do locale. Valores com zero à esquerda (00123) podem virar 123 se a coluna for tratada como número. Códigos de produto, CEP e telefone: na importação, force essas colunas como texto quando a opção existir.

Celular

Abrir CSV no app de planilha do celular funciona para uma olhada rápida e costuma falhar na escolha fina de separador e encoding. Para limpar um export importante, use computador e o fluxo de importação.

Checklist rápido antes de compartilhar com a equipe

• Cabeçalho na primeira linha, uma coluna por campo.
• Separador consistente em todas as linhas.
• Acentos legíveis (teste com “ção”, “ã”, “é”).
• Nenhuma coluna inteira colada numa célula só.
• Amostra de 5 a 10 linhas revisada, não só a linha 1.

Quando CSV não basta (formato, abas, fórmulas)

CSV brilha em troca de dados tabulares. Fracassa quando você precisa do que uma planilha “de verdade” carrega.

Formatação. Cores, negrito, largura de coluna, mesclagem: CSV descarta tudo. Só sobra o valor.

Várias abas. Um CSV é uma tabela. Relatório com “Resumo”, “Detalhe” e “Parâmetros” em abas distintas não cabe num único CSV sem virar vários arquivos ou um layout artificial.

Fórmulas. O que viaja no CSV é o resultado (ou o texto da fórmula, se alguém exportou mal), não o modelo recalculável. Quem recebe não herda a lógica, só os números daquele momento.

Tipos ricos. Imagens, comentários de célula, validação de dados, gráficos: fora de jogo.

Hierarquia. Listas com subitens aninhados, objetos com listas dentro de listas: CSV força tudo a ser “achatado”. Aí formatos como JSON ou XML fazem mais sentido. Se o seu fluxo envolve integração entre sistemas, vale conhecer também o básico de API: muitas APIs devolvem JSON; o CSV continua sendo o campeão do export manual e do relatório para humano em planilha.

Limites práticos. Arquivos enormes abrem devagar em planilha. Aspas e quebras de linha mal escapadas geram linhas “fantasma”. Dois sistemas podem discordar se o decimal é ponto ou vírgula mesmo com o mesmo separador de colunas.

Use CSV para: migrar listas, alimentar outra ferramenta, arquivar um extrato simples, trocar dados entre equipes sem depender de versão de Excel.

Use planilha nativa (.xlsx, Google Sheets) quando: há fórmulas vivas, várias abas, formatação que comunica, ou colaboração contínua no mesmo arquivo.

Use JSON (ou similar) quando: a estrutura não é uma tabela plana ou a integração é entre programas, não entre pessoas e planilhas.

O que fazer agora

Na próxima vez que um export “quebrar”, siga esta ordem curta:

1. Não salve por cima do arquivo original enquanto a tela estiver errada.
2. Abra uma cópia no editor de texto e identifique o separador.
3. No Sheets ou no Excel, use Importar / Obter dados, não só o duplo clique.
4. Escolha o separador certo e, se precisar, UTF-8.
5. Confira acentos, datas e colunas de código (CEP, SKU, telefone) como texto.
6. Se a origem permitir, padronize exports da equipe: UTF-8 + ponto e vírgula (ou o combinado que vocês documentarem).

CSV não é sofisticado. É por isso que funciona. O arquivo que quase toda ferramenta exporta também é o que mais gente abre no automático e estranha. Com separador certo, encoding certo e importação guiada, ele deixa de ser hieróglifo e volta a ser o que sempre foi: uma tabela em texto, pronta para usar.