Como converter CSV para JSON: transforme linhas de planilha em objetos limpos

Planilhas e código falam idiomas diferentes. Um arquivo CSV é perfeito para uma pessoa que percorre linhas no Excel, mas no momento em que você precisa enviar esses dados para uma API, um arquivo de configuração ou um aplicativo JavaScript, o que você quer é JSON. Converter entre eles é uma parte rotineira do desenvolvimento e deveria levar poucos segundos. Este guia explica o que realmente acontece na conversão e como fazê-la de forma privada com a ferramenta gratuita de CSV para JSON.

Para que servem o CSV e o JSON

CSV (valores separados por vírgula) é um formato plano e tabular. Cada linha é um registro e as vírgulas separam as colunas. Ele é compacto, abre em qualquer programa de planilhas e é fácil de ler e editar para quem não é desenvolvedor. O que ele não consegue fazer é expressar estrutura: não existe uma forma limpa de aninhar dados nem de rotular o significado de cada valor além de uma linha de cabeçalho.

JSON (JavaScript Object Notation) foi feito para estrutura. Ele usa chaves nomeadas, suporta aninhamento e é o idioma padrão das APIs web e dos aplicativos JavaScript. Quando o seu código precisa percorrer registros e ler campos pelo nome, é JSON o que ele espera.

Então a conversão é, na verdade, uma tradução de ‘uma grade que uma pessoa lê’ para ‘registros rotulados que um programa lê’.

Como as linhas viram objetos

A mecânica é simples assim que você a enxerga. Pegue este CSV:

• name,email,age
• Ada,[email protected],36
• Linus,[email protected],29

A primeira linha é o cabeçalho. Cada linha restante vira um objeto JSON, e cada célula do cabeçalho vira uma chave. O resultado é um array de objetos: [{"name": "Ada", "email": "[email protected]", "age": "36"}, ...]. Entra uma linha, sai um objeto, com os nomes das colunas fazendo a rotulagem.

Esse formato de array é exatamente o que a maioria das APIs e dos frameworks de front-end quer receber, e é por isso que essa conversão aparece com tanta frequência.

Por que desenvolvedores convertem CSV para JSON

Você recorre a isso sempre que dados em formato de planilha precisam encontrar o código. Casos comuns incluem:

• Popular um aplicativo ou banco de dados a partir de uma lista que alguém mantém no Excel ou no Google Sheets.
• Enviar dados para uma API que só aceita um corpo em JSON.
• Alimentar um front end, em que um array JSON é mapeado diretamente para uma lista de componentes.
• Escrever dados de teste (fixtures), transformando uma planilha rápida de casos em uma entrada estruturada.

Em cada caso, um colega pode manter a fonte acessível como planilha enquanto o seu código consome o JSON.

Como converter CSV para JSON no seu navegador

A ferramenta gratuita de CSV para JSON roda inteiramente no seu navegador, então os seus dados nunca são enviados para um servidor. Isso é importante quando as linhas contêm registros de clientes, e-mails ou qualquer coisa que você não colaria em um site qualquer.

1. Abra a ferramenta e cole o seu CSV, ou carregue um arquivo .csv.
2. Garanta que a primeira linha seja o seu cabeçalho. Essas células viram as chaves de cada objeto.
3. Leia a saída em JSON, um array de objetos, e copie-a direto para o seu código ou configuração.

Como o trabalho acontece na aba, você pode converter dados sensíveis com segurança sem que eles saiam da sua máquina.

Cabeçalhos, tipos e alguns detalhes a observar

Uma conversão limpa depende, acima de tudo, de uma entrada limpa. Tenha em mente:

• A linha de cabeçalho comanda tudo. Se uma coluna não tem cabeçalho, seus valores não têm onde aterrissar de forma significativa. Dê um nome a cada coluna.
• Os valores saem como strings. Um CSV não registra tipos, então 36 chega como "36". Converta para número no seu código se precisar fazer contas.
• Coloque entre aspas os campos que contêm vírgulas. Um valor como Smith, Jr. precisa estar entre aspas no CSV, ou será lido como duas colunas.

Quando a saída parece errada, a causa quase sempre é um cabeçalho ausente ou uma vírgula sem aspas na fonte.

Ferramentas relacionadas que você provavelmente vai querer

A conversão funciona nos dois sentidos. Quando você precisa devolver dados estruturados a alguém em uma planilha, a ferramenta de JSON para CSV os achata de volta em linhas. Depois de ter o JSON, o Formatador de JSON o identa e o valida para que você possa de fato ler a estrutura e detectar um colchete perdido. E se os seus dados de origem chegaram em XML em vez de planilha, a ferramenta de XML para JSON os coloca no mesmo formato de objeto que o seu código espera.

A versão curta

CSV é uma grade para pessoas; JSON são registros rotulados para o código. Converter significa transformar cada linha em um objeto, com a linha de cabeçalho fornecendo as chaves. Mantenha os seus cabeçalhos limpos, coloque entre aspas qualquer campo com vírgulas e lembre-se de que os números chegam como strings. Quando você precisa da conversão feita de forma rápida e privada, a ferramenta gratuita de CSV para JSON faz isso no seu navegador sem enviar nada.