O que é CSV? Uma explicação completa de valores separados por vírgula
Resposta rápida
CSV é um formato de texto para dados tabulares onde cada linha é uma linha e os valores são separados por vírgulas. A primeira linha geralmente contém cabeçalhos de coluna. CSV é usado para exportação, importação e troca de dados entre planilhas, bancos de dados e ferramentas de análise de dados. Use nosso conversor gratuito de CSV para JSON para transformar CSV em JSON.
Introdução
CSV (Valores Separados por Vírgula) é um formato de texto simples para armazenar dados tabulares – dados organizados em linhas e colunas, como uma planilha. Cada linha é uma linha de texto e cada valor dentro de uma linha é separado por uma vírgula. CSV é o formato mais simples e amplamente suportado para dados tabulares: cada aplicativo de planilha (Excel, Planilhas Google, Numbers), sistema de banco de dados e ferramenta de análise de dados pode ler e escrever CSV. É definido pela RFC 4180.
Passo a passo
-
Entenda a estrutura CSV
Um arquivo CSV possui uma linha por linha, com valores separados por vírgulas. A primeira linha geralmente é uma linha de cabeçalho contendo nomes de colunas. Cada linha subsequente é um registro de dados. Exemplo: 'nome, idade, cidade\nAlice,30,NYC\nBob,25,LA'.
-
Aprenda as regras de cotação
Valores que contenham vírgulas, aspas ou novas linhas devem ser colocados entre aspas duplas. Uma cotação dentro de um valor cotado é escapada duplicando-a. Exemplo: 'Alice,"Olá, mundo"' — a vírgula entre aspas faz parte do valor, não é um separador.
-
Reconhecer variações de CSV
Embora as vírgulas sejam o delimitador padrão, alguns arquivos usam ponto e vírgula (;), tabulações (TSV) ou barras verticais (|). As localidades europeias geralmente usam ponto e vírgula porque as vírgulas são usadas como separadores decimais. Sempre verifique o delimitador ao analisar.
-
Converta CSV para outros formatos
CSV não possui informações de tipo — todos os valores são strings. Ao converter para JSON ou carregar em um programa, pode ser necessário converter strings numéricas em números. Use nosso conversor CSV para JSON para conversão instantânea.
Exemplos
CSV simples com cabeçalhos
Entrada: Três colunas, duas linhas de dados
Saída: nome, idade, cidade
Alice,30, Nova York
Bob, 25, Los Angeles
CSV com valores citados
Entrada: Valor contendo uma vírgula
Saída: nome, nota
Alice,"Olá, mundo"
TSV (separado por tabulações)
Entrada: Mesmos dados, delimitador de tabulação
Saída: nome idade cidade
Alice 30 Nova York
Problemas comuns
- Todos os valores são strings —CSV não possui informações de tipo. Números, datas e booleanos são armazenados como texto e devem ser analisados pelo aplicativo.
- Delimitadores inconsistentes — alguns arquivos usam vírgulas, outros ponto-e-vírgula ou tabulações. Detecte o delimitador automaticamente ou deixe o usuário especificá-lo.
- Problemas de codificação —CSV arquivos do Excel podem usar codificação BOM ou Windows-1252 em vez de UTF-8. Isto causa problemas com caracteres não-ASCII.
- Comprimentos de linha inconsistentes — algumas linhas podem ter menos ou mais colunas que o cabeçalho. Lide com valores ausentes como valores nulos e extras truncando ou cometendo erros.
Dicas
- CSV é melhor para dados tabulares — use JSON para dados aninhados ou hierárquicos.
- Sempre cite valores que contenham vírgulas, aspas ou novas linhas para evitar erros de análise.
- Use codificação UTF-8 sem BOM para máxima compatibilidade.
- Use nosso conversor CSV para JSON para transformar CSV em JSON para uso em aplicações web.