Conversor Gratuito

Conversor de CSV para JSON

Converta dados ou arquivos CSV para o formato JSON instantaneamente no seu navegador. Suporta delimitadores personalizados, detecção de cabeçalho e formatação automática.

Selecionar arquivo CSV

ou arraste e solte aqui

Ou

Sobre esta ferramenta

CSV (valores separados por vírgula) e JSON (JavaScript Object Notation) são formatos de intercâmbio de dados onipresentes, mas descrevem os dados de maneira diferente. CSV é simples e tabular: uma linha de cabeçalho define os nomes dos campos e cada linha subsequente contém os valores de um registro. JSON é hierárquico: os dados são estruturados como objetos (pares de valores-chave) e matrizes, suportando aninhamento e tipos mais ricos. Converter CSV em JSON normalmente significa transformar cada linha CSV em um objeto JSON cujas chaves vêm da linha do cabeçalho e cujos valores são as células da linha.

Este conversor analisa CSV usando PapaParse, a biblioteca CSV mais confiável no ecossistema JavaScript. PapaParse lida com as peculiaridades que tornam o CSV aparentemente difícil: campos entre aspas contendo vírgulas, aspas de escape dentro de campos entre aspas, finais de linha mistos, marcadores BOM opcionais e campos contendo novas linhas. A saída é JSON estruturado, formatado com recuo de dois espaços por padrão para facilitar a leitura.

Dois formatos de saída são suportados. Matriz de objetos (o padrão) produz [{header1: value1, header2: value2}, ...], a forma JSON mais comum para dados tabulares. Matriz de matrizes produz [[cabeçalho1, cabeçalho2], [valor1, valor2], ...], preservando a ordem das colunas sem usar nomes de cabeçalho como chaves.

Por que converter CSV para JSON

A maioria das APIs e aplicativos modernos falam JSON. Carregar dados de uma exportação CSV – um relatório de vendas, uma lista de contatos, uma extração de banco de dados – em um aplicativo JavaScript, API REST ou banco de dados NoSQL normalmente requer passar primeiro pelo JSON. A conversão também é o primeiro passo para muitas transformações de dados, já que o JSON é mais fácil de manipular programaticamente do que o CSV.

A estrutura do JSON também desbloqueia recursos que o CSV não pode representar. Objetos com propriedades aninhadas, matrizes de comprimento variável por registro e informações de tipo explícitas (strings versus números versus booleanos) ficam disponíveis quando os dados estão em JSON. Existem alternativas de CSV como TSV, mas compartilham a mesma limitação de planicidade.

Como usar

Cole ou carregue seu CSV, obtenha JSON.

  1. Adicione seu CSV: Cole o texto CSV na área de entrada ou solte um arquivo .csv. PapaParse detecta delimitadores automaticamente; vírgula é mais comum, mas tabulação, ponto e vírgula e barra vertical também funcionam.
  2. Escolha o formato de saída: Array-of-objects usa cabeçalhos como chaves e produz a forma JSON mais comum. Matriz de matrizes preserva a estrutura de linha bruta. Escolha com base no que seu consumidor downstream espera.
  3. Converter: PapaParse processa o CSV no navegador, manipulando campos entre aspas, aspas de escape e casos extremos. A saída JSON é gerada com escape adequado para strings contendo caracteres especiais.
  4. Baixe ou copie: Salve como .json ou copie para a área de transferência. A saída é JSON válida, consumível por qualquer analisador JSON.

Casos de uso comuns

Detalhes técnicos

PapaParse implementa RFC 4180 (a especificação CSV) além de extensões para as variações que os arquivos CSV do mundo real contêm. Os campos entre aspas podem incluir vírgulas, novas linhas e caracteres de aspas (escapados por duplicação). Os cabeçalhos, quando presentes, são detectados na primeira linha. Valores numéricos e booleanos podem ser digitados automaticamente (transformados em números reais ou booleanos em vez de strings) ou mantidos como strings.

A saída JSON é gerada usando JSON.stringify com recuo opcional. As strings têm escape para a sintaxe JSON (barra invertida, aspas, caracteres de controle) e as estruturas usam o formato solicitado (matriz de objetos ou matriz de matrizes).

Casos extremos tratados: BOM no início do arquivo, finais de linha mistos (\n vs \r\n), células vazias (renderizadas como strings vazias ou nulas dependendo das configurações), novas linhas finais e linhas com diferentes contagens de campos. A robustez do PapaParse o torna a biblioteca JavaScript CSV padrão.

Melhores Práticas

Perguntas frequentes

A conversão de CSV em JSON altera o conteúdo?
O conteúdo é preservado com a maior precisão possível. No entanto, alguns recursos específicos de formato podem não ter equivalentes diretos, portanto, podem ocorrer pequenas diferenças de formatação.
Por que converter dados para o formato JSON?
JSON é o formato de dados padrão para APIs da web e aplicativos JavaScript. É legível por humanos, amplamente suportado por linguagens de programação e possui uma sintaxe mais simples que o XML.
O conversor lida com estruturas CSV aninhadas ou complexas?
Sim. A ferramenta analisa corretamente objetos aninhados, matrizes e todos os tipos de dados CSV padrão, preservando a estrutura de dados completa na saída JSON.
Esta conversão é segura e privada?
Sim. Todo o processamento acontece localmente no seu navegador. Seus dados nunca saem do seu dispositivo – sem upload de servidor, sem processamento na nuvem, sem coleta de dados.
Meus dados são enviados para um servidor?
Não. PapaParse é executado em seu navegador; a conversão acontece inteiramente no seu dispositivo.
Posso converter JSON de volta para CSV?
Sim — use a ferramenta JSON para CSV, que inverte o processo.
Qual é o tamanho máximo de entrada?
Até 50 MB. Arquivos maiores podem ficar lentos devido a restrições de memória do navegador; para conversões em escala de produção, uma abordagem do lado do servidor ou de script é mais confiável.
Por que meu CSV com campos multilinhas entre aspas é convertido de maneira estranha?
PapaParse lida com campos multilinhas quando citados corretamente. Se o resultado estiver errado, verifique se os campos entre aspas usam aspas duplas e se as aspas internas são escapadas por duplicação ("").