Conversor de CSV para JSON — Grátis, sem conta

De linhas a objetos

CSV e JSON respondem perguntas diferentes sobre os mesmos dados. O CSV é uma grelha: linhas de largura igual, com o sentido a viajar pela posição da coluna. O JSON é uma árvore de valores etiquetados, e é a forma que os programas consumem a sério — fontes, configurações, cargas de API, importações NoSQL. Converter entre ambos não é portanto uma troca de roupa mas de modelo do mundo, e este conversor executa-a sob uma convenção clara, enunciada abaixo.

A saída é a forma que se entrega ao código: um array JSON, com um objeto por linha de dados. Cada objeto traz o mesmo conjunto de chaves, tiradas da primeira linha do ficheiro, de modo que o ficheiro inteiro se percorre na cabeça assim: o cabeçalho torna-se chaves, cada outra linha torna-se um objeto.

A convenção estrutural

A primeira linha é sempre tratada como cabeçalho. O que se senta na linha 1 torna-se os nomes de campo de cada objeto da saída — não há opção para a saltar, nem adivinhação, nem "deteção inteligente". Um ficheiro sem linha de cabeçalho gastará pois a sua primeira linha de dados a tornar-se chaves; se o seu CSV não tem cabeçalho, acrescente um antes de converter.

Cada valor chega como cadeia. Não é preguiça mas honestidade: o CSV não transporta informação de tipos, nada no ficheiro distingue o número 27 da cadeia "27", e o conversor recusa-se a adivinhar. Se o seu código quer números a sério, analise-os do outro lado — um ciclo de `Number(row.age)` vale mais do que uma coluna estragada em silêncio.

Os valores entre aspas são respeitados: um campo embrulhado em aspas duplas que contenha vírgulas sobrevive como um único valor, segundo a norma CSV.

A codificação, o único requisito duro

Os ficheiros têm de estar em UTF-8. Os ficheiros UTF-8 com BOM são servidos — o marcador é retirado e a conversão segue o seu caminho. Mas os ficheiros noutras codificações, sendo o GBK o exemplo do dia a dia, são recusados com um erro claro em vez de passarem transformados em galimatias. É deliberado: descodificar texto em silêncio é muito pior do que recusá-lo. Se o seu ficheiro não está em UTF-8, guarde-o primeiro como UTF-8 no seu editor — então passa direto.

Ligar a saída ao seu código

A forma de saída é deliberadamente o JSON mais aborrecido possível: um array de objetos planos, com valores todos em cadeia. Essa planura é uma qualidade, não preguiça — qualquer linguagem carrega-o sem cerimónia, e cada consumidor decide no sítio o que converte em quê. Em JavaScript, um JSON.parse e uma passagem pelo array cobrem a maioria das necessidades; as cadeias tornam-se números exatamente onde a sua lógica os quer.

Se precisa de aninhamento, erga-o a jusante: agrupar o array por uma chave, fundir as linhas que pertencem juntas, pendurar os filhos nos pais. São transformações sobre matéria-prima estável, e é exatamente isso que se pede a um conversor. O que não se obtém é o conversor a apostar em silêncio na estrutura por sua conta — uma decisão de desenho que prefere de propósito o previsível ao cómodo.

Uma palavra sobre a escala: como a saída é um array com um objeto por linha, um CSV de cem mil linhas torna-se um ficheiro JSON grande, e é exatamente como deve ser — o formato espelha os dados. Os consumidores que fazem streaming ou consultam aguentam bem os arrays grandes; os que carregam o ficheiro inteiro em memória deviam saber o que estão a segurar. O conversor não aparas, não amostra, não resume para tornar o ficheiro pequeno: cada linha entra, cada linha sai.

Privacidade e conservação

Como tudo neste site: um ficheiro, grátis, sem conta, sem marca de água. O transporte é encriptado, o processamento acontece no cluster de conversão e tanto o CSV original como o JSON gerado são excluídos automaticamente em 24 horas. Resta o ficheiro que descarregou.