Convertendo CSV em JSON: análise de tipo, objetos aninhados e tratamento de cabeçalho

A conversão de CSV em JSON é direta para dados simples, mas requer tratamento cuidadoso de vírgulas entre aspas, novas linhas incorporadas, inferência de tipo de dados e valores ausentes para produzir JSON válido e utilizável.

CSV spreadsheet data being converted to structured JSON object format with type parsing

CSV e JSON: o que são e quando usar cada um

Delimited CSV flat table versus structured JSON array of objects comparison

CSV (valores separados por vírgula): Um formato de texto plano baseado em linhas, ideal para dados tabulares com estrutura uniforme — planilhas, exportações de banco de dados, relatórios. Cada linha tem as mesmas colunas. Fácil de abrir no Excel. Não há suporte para dados aninhados.

JSON (JavaScript Object Notation): Um formato de dados hierárquico e aninhado, ideal para APIs, arquivos de configuração e dados com estruturas complexas. Suporta matrizes de objetos, objetos aninhados e dados digitados (números, booleanos, nulos).

Quando converter CSV em JSON:

  • Alimentar dados de uma planilha em uma API REST
  • Processar exportações do Excel em um aplicativo Node.js
  • Converter dados do catálogo de produtos para uso em um aplicativo React
  • Importar dados em um banco de dados de documentos como MongoDB

Análise de tipo: números, booleanos e valores nulos

Reconstructing nested JSON object structures from dot-separated CSV headers

Automatic data type parsing engine classifying strings into numbers, booleans, and nulls

CSV não possui tipos de dados — tudo é uma string. JSON oferece suporte a vários tipos. Conversões de análise automática de tipo:

Valor CSVSem análiseCom Análise
42"idade": "42""idade": 42
3.14"preço": "3.14""preço": 3.14
verdadeiro"ativo": "verdadeiro""ativo": verdadeiro
falso"disponível": "falso""disponível": falso
(vazio)"notas": """notas": null

Para a maioria dos casos de uso de API, ative a análise de tipo para que IDs numéricos, preços e sinalizadores booleanos sejam digitados corretamente na saída JSON.


Tratamento de casos extremos: campos citados, vírgulas, novas linhas

CSV delimiter matrix comparing comma, semicolon, and tab separated values

Vírgulas dentro dos valores dos campos:

name,address
"Smith, John","123 Main St, Apt 4"

Ambos os campos estão corretamente entre aspas. As vírgulas incorporadas não são delimitadores de campo.

Citações dentro dos campos entre aspas: De acordo com a RFC 4180, uma aspa dupla literal é representada por duas aspas duplas consecutivas:

"He said ""hello""","Boston"

Analisa como: Ele disse "olá" / Boston

Novas linhas dentro dos valores dos campos:

name,bio
"Alex","Software engineer.
Loves coding."

A nova linha incorporada faz parte do valor do campo — a segunda linha não é uma nova linha CSV.


Passo a passo: CSV para JSON no ToolDolfen

ToolDolfen in-browser CSV to JSON converter utility workflow pipeline

  1. Abra o conversor Conversor de CSV para JSON.
  2. Cole seus dados CSV ou carregue um .csv arquivo.
  3. Configurar:

- Delimitador: vírgula (padrão), ponto e vírgula, tabulação ou barra vertical - Linha do cabeçalho: primeira linha = nomes de campos (recomendado) - Tipo análise: conversão automática de números e booleanos

  1. Clique em Convert.
  2. Revise a saída JSON no formatador. Use o Formatador JSON (JSON Formatter) para validar.
  3. Copie ou baixe os dados JSON.

Guias complementares recomendados

Explore tutoriais e utilitários complementares deste grupo de tópicos para aprimorar seu fluxo de trabalho digital:

Convertendo JSON aninhado em CSV simples: tratamento de estruturas de dados complexasTutorial passo a passo prático com padrões verificados e no navegador fluxos de trabalho.Guia moderno de favicon: ICO, PNG, SVG e manifestos de aplicativos da WebTutorial prático passo a passo com padrões verificados e no navegador fluxos de trabalho.Como formatar e reduzir arquivos JSON grandes em seu navegadorTutorial prático passo a passo com padrões verificados e no navegador fluxos de trabalho.Como converter STL para GCODE on-lineGuia de conversão de formato: fatiar modelos 3D em impressora FDM instruções.
Utilitário recomendado: CSV para JSONExecute este fluxo de trabalho ao vivo em seu navegador com zero uploads de servidor e 100% de privacidade do lado do cliente.
Conversor de CSV para JSON
Conversor de CSV para JSON

Perguntas Frequentes

Encontre respostas rápidas e verificadas para perguntas comuns sobre este fluxo de trabalho.

Como os cabeçalhos CSV são usados ​​na conversão JSON?

Os cabeçalhos CSV (a primeira linha) tornam-se chaves de objeto JSON. Cada linha CSV subsequente torna-se um objeto JSON com pares de valores-chave onde as chaves são os cabeçalhos. Se o seu CSV não tiver linha de cabeçalho, o conversor poderá usar índices numéricos (0, 1, 2...) como chaves.

Como o conversor lida com vírgulas dentro de valores de campos CSV?

RFC 4180 (o padrão CSV) especifica que os campos que contêm vírgulas devem ser colocados entre aspas duplas. Um campo CSV formatado corretamente, como "Smith, John", é tratado corretamente convertendo o conteúdo citado como um único campo.

O que a análise automática de tipo faz?

A análise automática de tipo converte valores de string CSV em seus tipos JSON apropriados. '42' torna-se 42 (número), 'true' torna-se verdadeiro (booleano), '' torna-se nulo. Sem análise de tipo, todos os valores são strings: { "age": "42" } em vez de { "age": 42 }.

Bilal Ahmad