O que é CSV
CSV (Comma-Separated Values) é um arquivo de valores separados por vírgulas. É o formato de dados tabulares mais simples, com cada linha sendo um registro e os campos separados por vírgulas.
nome,idade,cidade
Zhang San,25,Pequim
Li Si,30,Xangai
CSV é o formato universal para intercâmbio de dados. Excel, bancos de dados e linguagens de programação conseguem ler e escrever CSV.
Regras de análise de CSV
Estrutura básica
- Cada linha é um registro
- Campos separados por delimitador (geralmente vírgula)
- A primeira linha é geralmente o cabeçalho
- Quebra de linha separa registros
Campo contendo vírgula
Se o campo contiver vírgula, envolva-o com aspas duplas:
nome,descrição
Zhang San,"Olá, mundo"
Sem aspas, será tratado como dois campos.
Campo contendo aspas duplas
Se o campo contiver aspas duplas, use duas aspas duplas para escapar:
nome,descrição
Zhang San,"Ele disse ""olá"""
Campo contendo quebra de linha
Se o campo contiver quebra de linha, envolva-o com aspas duplas:
nome,descrição
Zhang San,"primeira linha
segunda linha"
Variações de delimitador
- Vírgula: CSV padrão
- Ponto e vírgula: comum na Europa (padrão do Excel europeu)
- Tab: TSV (Tab-Separated Values)
- Pipe: alguns sistemas usam |
Confirme o delimitador antes da conversão.
Limpeza de dados
Remoção de espaços em branco
- Espaços antes e depois do campo: usar trim
- Linhas vazias: excluir
- Cabeçalho BOM: remover
Padronização de formato
- Data: padronizar para YYYY-MM-DD
- Números: padronizar ponto decimal (sem separador de milhar)
- Booleanos: padronizar true/false ou 0/1
- Codificação: padronizar UTF-8
Tratamento de valores ausentes
- Campo vazio: preencher com valor padrão ou marcar como null
- Linha inteira ausente: excluir ou preencher
- Campo-chave ausente: marcar erro
Remoção de duplicatas
- Linhas totalmente duplicadas: excluir
- Chave primária duplicada: manter a mais recente ou mesclar
Problemas comuns
Caracteres ilegíveis
A codificação do CSV é o problema mais comum. O Excel usa GBK por padrão (versão chinesa), outras ferramentas usam UTF-8.
Solução:
- Ao exportar do Excel, escolha "CSV UTF-8"
- Use um editor de texto para salvar como UTF-8
- Ferramentas de conversão com detecção automática de codificação
Reconhecimento incorreto do delimitador
O CSV usa vírgula, mas o Excel europeu usa ponto e vírgula por padrão. Ao abrir o CSV, tudo fica em uma coluna.
Solução:
- Abra com um editor de texto para confirmar o delimitador
- Ao importar no Excel, especifique o delimitador (Dados → Texto para colunas)
Cabeçalho BOM
CSV UTF-8 exportado pelo Excel pode conter BOM (\uFEFF). Um caractere invisível aparece antes do primeiro nome de campo.
Solução: remova o BOM com um editor de texto ou deixe a ferramenta de conversão tratar automaticamente.
Números virando notação científica
Números longos (CPF, número de pedido) viram notação científica no Excel (1.23E+18).
Solução:
- No Excel, defina a coluna como "Texto" antes de colar
- No CSV, adicione um apóstrofo antes do número ('123456)
- Ao importar, especifique a coluna como texto
Formato de data confuso
Formatos de data variam por região:
- China: 2024/1/1
- EUA: 1/1/2024
- Europa: 1.1.2024
Solução: padronize para ISO 8601 (2024-01-01).
Quebra de linha inconsistente
Windows usa \r\n, Mac/Linux usa \n. O uso misto causa erros de análise.
Solução: padronize a quebra de linha.
Conversão de CSV
CSV para JSON
Programas processam JSON mais facilmente que CSV. Use a ferramenta CSV para JSON para conversão em um clique.
CSV para Excel
Abrir CSV com o Excel já mostra como tabela. Mas preste atenção à codificação e ao delimitador.
Excel para CSV
No Excel, salve como CSV. Atenção:
- Salva apenas a planilha ativa
- Fórmulas viram valores
- Formatação é perdida
- Várias planilhas devem ser salvas separadamente
Processamento em lote
Mesclar vários CSV
Para mesclar vários arquivos CSV em um:
- Confirme que os cabeçalhos são iguais
- Mantenha o cabeçalho do primeiro arquivo
- Remova o cabeçalho dos arquivos seguintes
- Concatene o conteúdo
Dividir CSV grande
Divida um CSV grande por número de linhas:
- Mantenha o cabeçalho em cada arquivo
- Divida por número de linhas especificado
- Gere vários arquivos pequenos
Filtrar dados
Filtre dados CSV por condição:
- Campo igual a valor específico
- Faixa de valores numéricos
- Faixa de datas
Processar CSV com o DocsAll
- Envie o CSV ou cole o conteúdo
- Análise automática
- Saída em JSON
- Copie ou baixe
Processamento no navegador, os dados não são enviados.
Dicas de processamento
Veja os dados primeiro
Antes de processar, examine o conteúdo do CSV:
- Abra com um editor de texto (não o Excel)
- Confirme o delimitador
- Confirme a codificação
- Confirme o cabeçalho
- Verifique a integridade dos dados
Faça backup do arquivo original
Antes de processar, faça backup do CSV original. Se a limpeza der errado, dá para voltar atrás.
Teste com pequeno lote
Primeiro processe algumas linhas de teste, confirme a lógica e então processe em lote.
Valide o resultado
Após processar, valide:
- O número de linhas está correto (após limpeza não deve faltar)
- O número de campos é consistente
- Verifique dados-chave amostrando
Resumo
O essencial do processamento de CSV: entender as regras de análise (vírgula, aspas, quebra de linha), resolver problemas de codificação (UTF-8, BOM), limpar dados (espaços, formato, valores ausentes), converter formatos (JSON, Excel). Veja os dados antes de processar e valide o resultado depois. A ferramenta CSV para JSON do DocsAll roda no navegador, os dados não saem do dispositivo.