Como Converter CSV para JSON: Guia Completo

Os ficheiros CSV estão em todo o lado — exportados de folhas de cálculo, bases de dados e ferramentas de análise. Mas as aplicações modernas, APIs e frameworks de frontend trabalham com JSON. Converter entre estes formatos é uma tarefa diária para programadores e analistas de dados.

Conversão Rápida com a Nossa Ferramenta

A abordagem mais rápida: cole o seu CSV no nosso Conversor CSV para JSON. Deteta delimitadores automaticamente, trata campos entre aspas e produz JSON limpo instantaneamente. Todo o processamento acontece no seu navegador — nenhum dado é enviado para servidores.

Compreender a Conversão

Uma linha CSV torna-se um objeto JSON. Os cabeçalhos das colunas tornam-se chaves, os valores das células tornam-se valores.

CSV de entrada:

name,email,age
Alex,alex@example.com,30
Jordan,jordan@example.com,25

JSON de saída:

[
  {"name": "Alex", "email": "alex@example.com", "age": "30"},
  {"name": "Jordan", "email": "jordan@example.com", "age": "25"}
]

Note que age é uma string. O CSV não tem informação de tipos — tudo é texto. Pode ser necessário tratar a conversão de tipos separadamente.

Métodos de Conversão

Utilizar JavaScript

function csvToJson(csv) {
  const lines = csv.trim().split('\n');
  const headers = lines[0].split(',');
  return lines.slice(1).map(line => {
    const values = line.split(',');
    return headers.reduce((obj, header, i) => {
      obj[header.trim()] = values[i]?.trim();
      return obj;
    }, {});
  });
}

Utilizar Python

import csv, json

with open('data.csv') as f:
    reader = csv.DictReader(f)
    data = list(reader)

with open('data.json', 'w') as f:
    json.dump(data, f, indent=2)

Lidar com Desafios Comuns

Vírgulas Dentro de Valores

Os valores que contêm vírgulas devem estar entre aspas: "Smith, John". O nosso Conversor CSV para JSON trata campos entre aspas automaticamente.

Valores em Falta

As células vazias devem tornar-se null em JSON, não strings vazias, dependendo das suas necessidades.

Ficheiros Grandes

Para ficheiros com mais de 10MB, considere abordagens de streaming ou ferramentas de linha de comandos. O nosso conversor trata ficheiros grandes eficientemente no navegador.

JSON Aninhado a partir de CSV Plano

Por vezes precisa de JSON aninhado a partir de CSV plano. Utilize notação de ponto nos cabeçalhos (address.city, address.state) e transforme programaticamente.

Validar a Saída

Após a conversão, valide o seu JSON com o nosso Validador de JSON para garantir que a saída está bem formada. Para conjuntos de dados grandes, verifique pontualmente alguns registos contra o CSV original.

Perguntas Frequentes

A conversão de CSV para JSON preserva os tipos de dados?

Não. O CSV é texto simples sem informação de tipos. Números, booleanos e datas tornam-se todos strings. É necessário adicionar lógica de conversão de tipos separadamente.

Como trato ficheiros CSV com diferentes delimitadores?

Ficheiros separados por tabulações (TSV), por ponto e vírgula e por pipe são comuns. O nosso Conversor CSV para JSON deteta automaticamente os delimitadores mais comuns.

Recursos Relacionados

• CSV vs JSON vs XML — escolher o formato de dados certo
• Boas Práticas de Formatação JSON — formate corretamente o seu JSON convertido
• Conversor CSV para JSON — converta CSV para JSON instantaneamente
• Editor de CSV — edite dados CSV antes da conversão