CSV para JSON
Converta CSV com linha de cabeçalho em um array JSON de objetos organizado.
Como usar CSV para JSON
- Cole o CSV com uma linha de cabeçalho no topo.
- Cada linha se torna um objeto JSON com as chaves dos cabeçalhos.
- Copie o JSON formatado gerado.
Sobre CSV para JSON
O CSV parece trivial, mas não é. Não existe um único padrão de CSV — a RFC 4180 é a referência comum mais próxima que existe, e muitos softwares ignoram partes dela. Um campo que contém uma vírgula precisa ser envolvido em aspas duplas; uma aspa dentro de um campo entre aspas é escapada duplicando-a; e um campo entre aspas pode conter quebras de linha, motivo pelo qual dividir um CSV por quebras de linha é um erro à espera de acontecer. Esta ferramenta usa um analisador real, caractere por caractere, então os três casos são tratados corretamente, e as quebras de linha CRLF do Windows são normalizadas.
A primeira linha é tratada como o cabeçalho e fornece as chaves; cada linha seguinte se torna um objeto no array JSON formatado. Linhas em branco são ignoradas. Todo valor permanece uma string — sem tentativa de adivinhar o tipo — o que é proposital: isso evita que IDs com zeros à esquerda, números de telefone e CEPs sejam silenciosamente transformados em números.
Os limites, sem rodeios. O delimitador é uma vírgula, então exportações separadas por ponto e vírgula ou tabulação precisam ser convertidas antes. Não há remoção de BOM, então uma marca de ordem de byte UTF-8 salva pelo Excel acaba grudada na primeira chave. Linhas com mais campos do que cabeçalhos perdem os extras; linhas com menos campos recebem strings vazias; cabeçalhos duplicados se sobrescrevem entre si. Tudo é executado inteiramente no seu navegador, então uma exportação de clientes nunca é enviada. Para o caminho inverso, use JSON para CSV; para reduzir o resultado, o minificador de JSON.
Perguntas frequentes
A primeira linha precisa ser um cabeçalho?
Sim. A primeira linha sempre fornece as chaves dos objetos, e cada linha seguinte se torna um objeto. Se seu arquivo não tiver uma linha de cabeçalho, adicione uma primeiro — caso contrário, seu primeiro registro será consumido como os nomes das chaves.
Ela lida com vírgulas e quebras de linha dentro de um campo?
Sim, desde que o campo esteja envolvido em aspas duplas. O analisador acompanha o estado de "dentro de aspas" caractere por caractere, então vírgulas, quebras de linha e aspas duplicadas ("") dentro de um campo entre aspas são todas preservadas em vez de dividir a linha.
Por que meus números aparecem como strings na saída?
É proposital. Adivinhar tipos corrompe dados reais — IDs com zeros à esquerda perdem os zeros, números longos perdem precisão, e valores como 1-2 ou datas são interpretados de forma equivocada. Tudo permanece como string; converta os campos que você realmente precisa no seu próprio código.
Ela consegue lidar com arquivos separados por ponto e vírgula ou tabulação?
Não. O delimitador é uma vírgula, ponto final. Se sua exportação usar ponto e vírgula — comum quando o Excel roda em uma configuração regional europeia — exporte novamente separado por vírgulas, ou substitua os delimitadores antes de colar.
Minha primeira chave tem caracteres estranhos na frente. Por quê?
Isso é uma marca de ordem de byte UTF-8, que o Excel escreve no início do arquivo. Ela não é removida aqui, então se torna parte do primeiro nome de cabeçalho. Apague o caractere invisível no início antes de colar, ou salve o arquivo sem BOM.