Conversor CSV para JSON

O que é JSON e por que converter de CSV?

// Input CSV (comma + LF, header on, infer types on)
id,name,active,score
1,Alice,true,98.5
2,Bob,false,87
3,Carol,true,

// Output JSON
[
  { "id": 1, "name": "Alice", "active": true, "score": 98.5 },
  { "id": 2, "name": "Bob", "active": false, "score": 87 },
  { "id": 3, "name": "Carol", "active": true, "score": null }
]

// Same input with Header off (no first-row keys)
1,Alice,true,98.5
2,Bob,false,87

// Becomes
[
  { "col1": 1, "col2": "Alice", "col3": true, "col4": 98.5 },
  { "col1": 2, "col2": "Bob", "col3": false, "col4": 87 }
]

Recursos Principais

Exemplos

id,name,email,role
1,Alice,alice@example.com,admin
2,Bob,bob@example.com,editor
3,Carol,carol@example.com,viewer
4,Dan,dan@example.com,viewer

ts	event	user	duration
2026-05-09T10:00:00Z	signup	alice	142
2026-05-09T10:01:00Z	login	alice	87
2026-05-09T10:02:00Z	checkout	alice	312
2026-05-09T10:03:00Z	logout	alice	44

id;name;price
1;Alice;1234,56
2;Bob;9876,54
3;Carol;42,00

name,role,note
"Smith, Jr.",admin,"He said ""hi"""
"Doe, Jane",editor,"Two
lines"

id,event,user
9007199254740993,signup,alice
9007199254740994,login,bob
9007199254740995,checkout,carol

1,Alice,admin
2,Bob,editor
3,Carol,viewer
4,Dan,viewer

Como Usar

1. 1

   Cole seu CSV

   Insira ou cole seu CSV no campo de entrada acima. A ferramenta aceita dados delimitados por vírgula, ponto e vírgula, tab e pipe. Você também pode clicar em «Carregar exemplo» para experimentar uma amostra como uma exportação de planilha, log TSV ou CSV Excel-EU com ponto e vírgula.

2. 2

   Escolha o delimitador (ou Tab)

   Clique em `,` (padrão), `;` (Excel-EU ponto e vírgula), `\t` (TSV) ou `|` (Pipe) para alternar o delimitador em um clique. Abra o painel de Opções para controle fino: Cabeçalho ativado/desativado e Inferir tipos ativado/desativado. Cabeçalho desativado nomeia automaticamente as colunas col1, col2, col3.

3. 3

   Copie ou Baixe o JSON

   Clique em Copiar para levar o JSON para a área de transferência, ou em Baixar para salvá-lo como arquivo .json pronto para o seu código, API ou pipeline. Para round-trips, clique em Inverter direção para converter JSON de volta para CSV no lugar.

Armadilhas Comuns de Conversão

name,role
Smith, Jr.,admin
// Parser reads 3 columns: "Smith", " Jr.", "admin"

name,role
"Smith, Jr.",admin
// Parser reads 2 columns: "Smith, Jr.", "admin"

// Wrong delimiter (default comma) on Excel-EU file
id;name;price
1;Alice;1234,56
// Each row becomes one column: { col1: "1;Alice;1234,56" }

// Correct: pick `;` Delimiter chip
id;name;price
1;Alice;1234,56
// Output: { id: 1, name: "Alice", price: "1234,56" }

// Without big-int detection
{"id": 9007199254740993}
// JavaScript reads as 9007199254740992 (precision lost)

// With Infer types on, big integers stay as strings
{"id": "9007199254740993"}
// Use BigInt(value) in code to preserve precision

id, name, email
1, Alice, alice@example.com
// Output keys: "id", " name", " email" (with leading spaces)

id,name,email
1,Alice,alice@example.com
// Output keys: "id", "name", "email" (clean)

name,role,note
Alice,admin
Bob,editor,first day
// Row 1 is short by one cell

// Output (note empty/null cell in row 1)
[
  { "name": "Alice", "role": "admin", "note": null },
  { "name": "Bob", "role": "editor", "note": "first day" }
]

// Expecting a Date object in the output
ts,event
2026-05-09T10:00:00Z,signup
// Output ts is the string "2026-05-09T10:00:00Z", NOT a Date

// Correct: parse at the point of use in your code
const rows = JSON.parse(output);
const when = new Date(rows[0].ts);
// when is now a Date object

Casos de Uso Comuns

Exportação de Planilha para Importação em API

Cole um CSV exportado do Excel, Google Sheets ou Numbers e obtenha um array JSON de objetos pronto para POST em uma API REST, mutação GraphQL ou endpoint de importação em massa. O caso de uso mais comum — analistas produzem dados de planilha, engenheiros precisam de JSON tipado para alimentar o backend.

Exportação do Excel para Ferramentas

Converta exportações CSV do Excel (incluindo arquivos Excel-EU delimitados por ponto e vírgula com o chip `;`) em JSON para processamento com ferramentas JavaScript, scripts jq ou qualquer sistema que leia JSON. O parser lida corretamente com a remoção de BOM e quebras de linha CRLF, para que exportações do Excel não quebrem na primeira linha.

Log TSV para Analytics

Logs separados por tab de exportações do BigQuery, descargas do Snowflake, pipelines do Vector ou ferramentas Unix (cut, awk) frequentemente chegam como .tsv. Escolha o chip de Delimitador Tab e obtenha um array JSON tipado pronto para análise ad-hoc, ingestão em dashboard ou transformação em estágio de pipeline.

Dump CSV de Banco de Dados para ETL

Converta a saída de PostgreSQL COPY TO CSV, MySQL SELECT INTO OUTFILE ou qualquer dump CSV de banco de dados em JSON para carregar em um armazenamento NoSQL, alimentar um pipeline ETL JavaScript ou enviar para o BigQuery como JSON delimitado por linha. A detecção de inteiros grandes preserva IDs numéricos que excedem o intervalo seguro do JavaScript.

Consumo de Resultado de Testes CSV do Postman/Newman

Execuções de testes do Postman exportam relatórios CSV de aprovação/falha por requisição. Converta para JSON para consumo programático — alimente um dashboard de status, pipeline de alertas ou agregador de resultados de testes. Linhas com formato misto (testes que falharam têm uma coluna error extra) são tratadas com preenchimentos vazios/null.

CSV Pequeno para Configuração JSON Rápida

Tem um CSV pequeno de constantes — códigos de moeda, nomes de países, SKUs de produtos — e precisa de um array JSON para um arquivo de configuração ou uma constante JavaScript? Cole, copie, cole. Com Inferir tipos ativado, números e booleanos são tipados corretamente; com Cabeçalho ativado, você obtém um array de objetos com campos nomeados pronto para colocar em um arquivo .json.

Detalhes Técnicos

Internos do Parser de Máquina de Estados RFC 4180

O parser é uma implementação adequada de máquina de estados finita seguindo o RFC 4180. Os estados incluem UnquotedField, QuotedField, AfterQuote, RowEnd e EndOfInput. O parser trata corretamente campos entre aspas contendo o delimitador, CR/LF embutidos dentro de campos entre aspas, aspas duplas escapadas (duplicadas, como "") e quebras de linha finais. Isso produz uma saída que faz round-trip sem perdas pelo módulo csv do Python, PostgreSQL COPY, AWS S3 SELECT e qualquer parser conforme. A máquina de estados é ciente do delimitador, então alternar de `,` para `;` ou `\t` não muda a semântica de aspas — apenas o separador de campo.

Algoritmo de Inferência de Tipos

Com Inferir tipos ativado, cada célula passa por um pipeline de detecção ordenado. Primeiro, uma célula vazia vira JSON null. Segundo, as strings literais true e false viram booleanos JSON. Terceiro, strings com zero à esquerda (^0[0-9]+$) são mantidas como strings para preservar a semântica de identificador — converter para números removeria silenciosamente os zeros à esquerda. Quarto, literais inteiros são testados contra o limite de inteiros seguros (-2^53+1 a 2^53-1); valores fora desse intervalo são mantidos como strings para evitar perda de precisão IEEE 754. Quinto, strings de data ISO 8601 são detectadas por regex e intencionalmente mantidas como strings — o JSON não tem tipo de data nativo. Qualquer coisa que sobreviva às cinco proteções é convertida via Number() (numérico) ou mantida como string (todo o resto).

Remoção de BOM e Tratamento de Codificação

Toda a entrada é tratada como UTF-8. O BOM UTF-8 opcional (0xEF 0xBB 0xBF) é silenciosamente removido da primeira célula da primeira linha quando presente — isso evita que os bytes do BOM sejam incluídos como um caractere perdido no início do nome da primeira coluna (o Excel no Windows comumente emite o BOM, quebrando parsers ingênuos). Outras codificações (Windows-1252, ISO-8859-1) não são detectadas automaticamente; a API File do navegador já teria decodificado os bytes como UTF-8 quando o texto chegasse a esta ferramenta. Se você tem entrada não-UTF-8, converta-a primeiro com iconv ou a opção de exportação de codificação do seu editor antes de colar.

Melhores Práticas

Escolha o Delimitador Explicitamente para Dados Sem Vírgula

Não confie na detecção automática. Se o seu CSV usa ponto e vírgula (Excel-EU), tabs (TSV de BigQuery, Snowflake ou ferramentas Unix) ou pipes (campos com muitas vírgulas), clique no chip de Delimitador correspondente antes de colar. O parser é ciente do delimitador: alternar o chip re-analisa a entrada imediatamente. Isso evita o modo de falha mais comum de CSV-para-JSON, em que cada linha colapsa em uma única célula porque o parser usou o separador errado.

Mantenha Inferir Tipos Ativado para JSON Tipado

Com Inferir tipos ativado (o padrão), você obtém JSON tipado: números como números, booleanos como booleanos, null onde aparecem células vazias. É isso que a maioria dos consumidores quer — APIs, frontends, código JavaScript. Desative Inferir tipos somente quando precisar especificamente que cada célula seja string (consumidores estritos de tipos a jusante, pipelines de validação que comparam bytes exatos da origem). O pipeline de detecção tem proteções para strings com zero à esquerda, inteiros grandes e datas ISO, então identificadores e datas permanecem seguros mesmo com a inferência ativada.

Aspas IDs como Strings no CSV a Montante

Se o seu CSV é gerado por um banco de dados ou pipeline que você controla, emita IDs numéricos grandes (snowflakes do Twitter, IDs do Discord, resourceVersion do K8s) como strings CSV entre aspas ("9007199254740993") para que passem pela Inferência de Tipos de forma limpa. O parser os manterá como strings de qualquer maneira (a detecção de inteiros grandes captura valores acima de 2^53 - 1), mas o uso explícito de aspas é o contrato a montante mais robusto e evita qualquer ambiguidade sobre precisão.

A Linha de Cabeçalho Deve Ser a Primeira Linha

Cabeçalho ativado (o padrão) detecta automaticamente a primeira linha como nomes de coluna. Se o seu CSV tem comentários, linhas em branco ou metadados antes do cabeçalho, remova-os antes de colar — o parser não pula linhas iniciais sem dados. Para CSVs sem cabeçalho (exportações brutas, dumps gerados por máquina), desative o Cabeçalho e as colunas serão nomeadas automaticamente col1, col2, col3 em ordem. Não tente falsificar um cabeçalho prefixando-o em um arquivo sem cabeçalho; ou desative o Cabeçalho ou corrija a origem.

Use o Modo Stringify para Round-Trips CSV → JSON → CSV

Se você planeja fazer round-trip dos dados em ambas as direções (CSV → JSON → CSV), a direção inversa (JSON → CSV) precisa do modo Stringify para que arrays ou objetos aninhados sobrevivam sem perdas. O modo Achatar na direção inversa emite chaves pontuadas (customer.address.city) que não podem ser perfeitamente reconstruídas pelo parser de CSV. Veja nosso Conversor JSON para CSV para a referência completa da direção inversa e notas sobre testes de round-trip.

Perguntas Frequentes