Como converter CSV para JSON
CSV (Comma-Separated Values) é o formato mais simples para dados tabulares — toda planilha pode exportá-lo. JSON (JavaScript Object Notation) é o formato padrão para APIs web e aplicações modernas. Converter entre eles é uma das tarefas de dados mais comuns no desenvolvimento.
Quando você precisa de CSV para JSON
- Carregar dados em uma aplicação web — a maioria dos frameworks JavaScript trabalha com JSON nativamente, não CSV
- Cargas úteis de API — se você tem dados em uma planilha que precisam ir para um endpoint de API, eles precisam ser JSON
- Importação para bancos de dados — muitos bancos NoSQL (MongoDB, Firebase) aceitam JSON diretamente
- Arquivos de configuração — transformar uma planilha de configurações em um arquivo de configuração JSON
- Análise de dados — converter dados exportados em um formato que suas ferramentas possam processar
Como o CSV se torna JSON
Um arquivo CSV com cabeçalho "name,age,city" seguido de "Alice,30,New York" e "Bob,25,London" se torna um array JSON de objetos onde cada linha vira um objeto, a primeira linha (cabeçalhos) vira as chaves, e cada linha seguinte vira um objeto.
Como converter
1. Cole seus dados CSV — insira dados separados por vírgula com uma linha de cabeçalho. 2. Escolha seu delimitador — selecione vírgula, ponto-e-vírgula, tabulação ou pipe. A ferramenta detecta automaticamente na maioria dos casos. 3. Copie ou baixe — revise a saída JSON e copie para a área de transferência ou baixe como arquivo .json.
Lidando com dados CSV complicados
Valores entre aspas — quando um valor contém o caractere delimitador (como um endereço com vírgula), ele deve ser envolvido em aspas duplas: "New York, NY". Bons conversores lidam com isso corretamente.
Valores vazios — células vazias viram strings vazias em JSON ("field": ""). Se você precisar delas como null, pode precisar pós-processar a saída.
Valores numéricos — CSV não tem tipos de dados. Tudo é texto. A saída JSON terá números como strings ("30" e não 30). Se sua aplicação precisa de números reais, faça o parse deles após a conversão.
Quebras de linha em valores — alguns arquivos CSV têm valores de múltiplas linhas (entre aspas). Nem todos os conversores lidam com isso — teste com seus dados específicos.
Dicas
- Verifique seus cabeçalhos — a primeira linha deve ter nomes de coluna limpos e únicos. Espaços, caracteres especiais ou cabeçalhos duplicados criarão chaves JSON confusas.
- Verifique o delimitador — CSVs europeus frequentemente usam ponto-e-vírgula em vez de vírgulas (porque vírgulas são usadas como separadores decimais em muitos países europeus). Se a conversão parecer errada, tente um delimitador diferente.
- Formate a saída — após a conversão, passe o JSON por um formatador para torná-lo legível antes de usá-lo no seu projeto.
- Verifique por amostragem os resultados — compare algumas linhas da saída JSON com o CSV original para garantir que o mapeamento está correto, especialmente para arquivos com muitas colunas.
Perguntas frequentes
O que acontece com a linha de cabeçalho?
A primeira linha é usada como chaves para os objetos JSON. Cada linha seguinte vira um objeto com essas chaves. Por exemplo, um cabeçalho "name,age" com uma linha "Alice,30" se torna {"name":"Alice","age":"30"}.
Quais delimitadores são suportados?
Vírgula, ponto-e-vírgula, tabulação e pipe são todos suportados. A ferramenta pode detectar automaticamente qual delimitador seus dados usam, ou você pode selecioná-lo manualmente.
Lida com vírgulas dentro de valores?
Sim. Valores envolvidos em aspas duplas (como "New York, NY") são tratados corretamente — a vírgula dentro das aspas é considerada parte do valor, não um separador.
Meus dados são enviados a um servidor?
Não. Toda a conversão acontece no seu navegador. Seus dados nunca saem do seu dispositivo.