Escolher idioma

Conversor de CSV para JSON

Transforme dados CSV em JSON estruturado direto no navegador. Aceita delimitadores diferentes, campos entre aspas e saída em array JSON ou NDJSON.

Mehmet Demiray Publicado Atualizado
Compartilhar
Caractere que separa os valores no seu CSV
Tratar a primeira linha como nomes das colunas
Analisar números e true/false em vez de mantê-los como texto
Ignorar linhas em branco na entrada
Espaçamento usado para formatar a saída JSON

O que é a conversão de CSV para JSON

CSV e JSON resolvem problemas diferentes. O CSV guarda dados em linhas e colunas separadas por um delimitador, ideal para planilhas e exportações simples. Já o JSON descreve estruturas com chaves e valores, o formato que a maioria das APIs e aplicações web espera receber.

A conversão entra em cena quando você precisa levar dados de um mundo para o outro. A primeira linha do CSV costuma virar as chaves de cada objeto JSON, e cada linha seguinte se transforma em um registro independente.

A diferença estrutural é o ponto central. No CSV, o tipo de cada valor é ambíguo, pois tudo é texto. No JSON, você ganha hierarquia, listas e objetos aninhados. Por isso a conversão não é só trocar a aparência: ela reorganiza dados planos em uma estrutura que código consegue percorrer.

Com o conversor da Callculation, você cola o conteúdo, confere o resultado e copia o JSON pronto para usar. Se o caminho inverso for necessário, o conversor de JSON para CSV cuida disso.

Como o conversor funciona

O processo acontece em três etapas claras. Primeiro, a ferramenta lê o CSV e identifica o delimitador, que pode ser vírgula, ponto e vírgula ou tabulação. Em seguida, separa o cabeçalho das linhas de dados e mapeia cada coluna para uma chave.

Na etapa de montagem, cada linha vira um objeto. Um arquivo com três colunas e 100 linhas gera um array com 100 objetos, cada um com as mesmas chaves.

Veja um exemplo simples de entrada e saída:

Entrada CSV Saída JSON
nome,idade [
Ana,30 { "nome": "Ana", "idade": "30" }
Bruno,25 ]

Os casos especiais recebem atenção. Campos entre aspas podem conter o próprio delimitador, quebras de linha e aspas escapadas sem quebrar a leitura. Quando você prefere processar registro a registro, a saída em NDJSON coloca um objeto por linha. Para conferir o JSON final com indentação organizada, use o formatador de JSON.

Principais casos de uso

A conversão de CSV para JSON aparece em muitas rotinas de quem trabalha com dados. O caso mais comum é alimentar aplicações web. Uma planilha exportada pelo time de marketing ou financeiro raramente serve direto para o front-end, mas vira JSON em segundos e já pode ser consumida.

Outro cenário frequente é a transformação de respostas de API. Sistemas legados ainda entregam relatórios em CSV, e convertê-los em JSON permite integrar esses dados com serviços modernos que falam apenas essa linguagem.

A migração de arquivos planos para estruturas também é forte. Ao trocar de banco de dados ou de plataforma, exportar tudo em CSV e converter em JSON facilita a importação no novo ambiente.

Por fim, pipelines de dados usam a conversão como etapa intermediária. Você recebe CSV, transforma em JSON, aplica filtros e segue o fluxo. Quem trabalha com outros formatos pode combinar essa ferramenta com o conversor de XML para JSON e o conversor de YAML para JSON.

Delimitadores, aspas e campos especiais

Nem todo CSV usa vírgula. No Brasil, é muito comum encontrar arquivos com ponto e vírgula, já que a vírgula costuma marcar a casa decimal de números. Arquivos exportados por planilhas em outras configurações podem usar tabulação. O conversor reconhece esses três delimitadores e ajusta a leitura.

Os campos entre aspas merecem cuidado redobrado. Quando um valor contém o delimitador, ele aparece envolvido por aspas duplas para não ser confundido com uma separação de coluna. Veja como isso funciona:

  • "São Paulo, SP" permanece um único valor, mesmo com a vírgula interna
  • "texto com ""aspas"" dentro" representa aspas escapadas no resultado
  • Um campo pode ocupar várias linhas se estiver entre aspas

Esses detalhes evitam que um endereço ou uma observação longa quebrem a estrutura. Mais de 90% dos problemas de conversão vêm de aspas mal interpretadas, e tratá-las bem garante um JSON íntegro. Sempre confira algumas linhas críticas antes de usar o resultado em produção.

Saída em array JSON ou NDJSON

A ferramenta entrega o resultado em dois formatos, e a escolha depende de como você vai usar os dados. O array JSON agrupa todos os registros dentro de colchetes, em uma única estrutura. É a opção natural para carregar tudo de uma vez na memória ou enviar como corpo de uma requisição.

O NDJSON, ou JSON delimitado por nova linha, coloca um objeto por linha, sem o array externo. Esse formato brilha em volumes grandes, porque permite ler e processar registro a registro sem carregar o arquivo inteiro. Ferramentas de streaming e sistemas de logs adotam esse padrão com frequência.

A escolha prática segue uma regra simples:

  1. Para poucos registros ou consumo direto por uma API, prefira o array JSON
  2. Para milhares de linhas ou processamento contínuo, escolha NDJSON

Os dois formatos preservam exatamente as mesmas chaves e valores. Você troca entre eles conforme o destino, sem reformatar manualmente. Depois de gerar o JSON, copie o conteúdo e leve direto para o seu projeto.

As que mais respondemos.

Como converto um arquivo CSV em JSON?

Cole o conteúdo do seu CSV no campo de entrada da ferramenta. O conversor identifica o delimitador, usa a primeira linha como chaves e transforma cada linha seguinte em um objeto. Em seguida, basta copiar o JSON gerado e usar no seu projeto.

Quais são as principais diferenças entre CSV e JSON?

O CSV organiza dados em linhas e colunas separadas por um delimitador, tratando tudo como texto plano. O JSON usa chaves e valores, permitindo listas e objetos aninhados. Por isso o JSON descreve estruturas mais ricas, enquanto o CSV é mais leve e direto para planilhas.

O conversor lida com caracteres especiais e vírgulas dentro dos campos?

Sim. Campos entre aspas duplas podem conter o próprio delimitador, quebras de linha e aspas escapadas sem quebrar a estrutura. Um valor como "São Paulo, SP" permanece único, mesmo com a vírgula interna. Isso garante que endereços e textos longos sejam convertidos corretamente.

A conversão é sem perdas?

Os valores são preservados na íntegra, mas há um ponto a considerar. Como o CSV guarda tudo como texto, números e datas chegam ao JSON em formato de string. Se você precisa de tipos numéricos reais, será necessário um tratamento adicional depois da conversão.

Posso usar ponto e vírgula como separador?

Sim. A ferramenta reconhece vírgula, ponto e vírgula e tabulação como delimitadores. Isso é útil no Brasil, onde planilhas costumam usar ponto e vírgula porque a vírgula marca a casa decimal dos números.

Qual a diferença entre array JSON e NDJSON?

O array JSON reúne todos os registros dentro de colchetes, em uma estrutura única, ideal para carregar de uma vez. O NDJSON coloca um objeto por linha, sem array externo, o que facilita processar arquivos grandes registro a registro. Ambos preservam as mesmas chaves e valores.

Os meus dados são enviados para algum servidor?

A conversão acontece direto no seu navegador, então os dados colados não precisam sair do seu dispositivo para virar JSON. Ainda assim, evite colar informações sensíveis e confira sempre o resultado antes de usá-lo em produção.