O formato CSV explicado + problemas comuns

O CSV é a língua universal das planilhas e das exportações de dados — simples o bastante para abrir num editor de texto, suportado por toda ferramenta que toca em dados tabulares. Mas essa simplicidade esconde algumas ciladas surpreendentemente comuns que transformam uma exportação limpa numa bagunça. Aqui está como o CSV realmente funciona e como evitar os problemas de sempre.

O que é CSV

CSV significa comma-separated values (valores separados por vírgulas). Cada linha é um registro e, dentro de uma linha, as vírgulas separam as colunas. A primeira linha costuma ser um cabeçalho que nomeia cada coluna.

name,email,age
Ada Lovelace,ada@example.com,36
Alan Turing,alan@example.com,41

É essa a ideia toda — e é justamente por isso que os casos extremos mordem.

Os problemas comuns

Vírgulas dentro de um valor

E se um valor em si contém uma vírgula, como Lovelace, Ada? Sem uma regra, esse único campo pareceria duas colunas. A solução: envolver os campos com vírgulas em aspas duplas.

"Lovelace, Ada",ada@example.com,36

Aspas dentro de um valor

Uma aspa dupla dentro de um campo entre aspas é escapada duplicando-a: "She said ""hi""" representa She said "hi".

Quebras de linha dentro de um valor

Um campo pode até conter uma quebra de linha se estiver entre aspas — por isso nem sempre dá para assumir “uma linha = um registro” ao analisar CSV à mão.

O delimitador nem sempre é uma vírgula

Em regiões onde a vírgula é o separador decimal, as planilhas muitas vezes exportam com ponto e vírgula (;) ou tabulações no lugar. Se um arquivo abre como uma grande coluna, geralmente é por um delimitador que não bate.

A codificação e o BOM

O CSV não carrega informação de codificação, então caracteres acentuados podem corromper se o leitor adivinhar errado — salve como UTF-8. Alguns programas também adicionam no início uma marca de ordem de bytes (BOM) invisível que pode quebrar o cabeçalho da primeira coluna. (Veja nosso guia sobre codificação de caracteres para saber por quê.)

Trabalhar com dados CSV

Como o CSV é só linhas de texto, as ferramentas de texto puro dão conta de muita arrumação: ponha as linhas em ordem com a ferramenta ordenar linhas, elimine repetições com remover linhas duplicadas e veja exatamente o que mudou entre duas exportações com um comparador de texto. Para transformação estruturada, converter os dados primeiro para JSON costuma ser o caminho mais limpo.