Conversor CSV ↔ JSON

Converta entre CSV e JSON, com suporte a linha de cabeçalho

Delimitador

Primeira linha é cabeçalho

CSV

JSON

Como funciona

Conversor CSV ↔ JSON — Converta entre CSV e JSON, com suporte a linha de cabeçalho. Todo o processamento acontece no seu navegador — sem upload, sem cadastro, sem e-mail. Grátis para sempre.

Última atualização: 2026-05-06

Editor's note

Construímos isso porque a pergunta "a primeira linha é cabeçalho" é tratada como óbvia por toda ferramenta de CSV e está errada em cerca de metade dos dados reais — exports de banco começam com uma linha de metadado, dumps de analytics repetem o cabeçalho a cada quebra de página, e um número surpreendente de sistemas internos emite uma linha em branco antes das colunas de verdade. Mostramos a detecção do delimitador e o toggle de cabeçalho de cara, como palpites opinativos que você pode anular antes do arquivo inteiro converter, porque descobrir que você chutou errado depois de um parse de 50.000 linhas ter deslocado todas as colunas em uma é o pior jeito possível de aprender essa lição.

Também recusamos subir o arquivo. CSVs são onde os dados reais de usuário vivem: endereços, telefones, e-mails, históricos de transação, às vezes uma coluna que alguém esqueceu de mascarar antes de exportar. Outros conversores alegremente fazem POST do arquivo para um servidor e chamam isso de feature; rodamos Papa Parse no navegador e os bytes não saem da aba. Se você está convertendo um CSV que contém PII, esse é exatamente o momento em que a propriedade de privacidade precisa ser inabalável — não uma nota de rodapé numa política de privacidade.

Sobre Conversor CSV ↔ JSON

CSV é o formato de dados de menor denominador comum: toda planilha, toda ferramenta de export de banco, todo sistema legado fala. JSON é a língua franca das APIs modernas e do código JavaScript. Converter entre os dois é tarefa diária para qualquer pessoa que importa dumps de analytics, faz seed de banco a partir de uma planilha ou empurra resultados de pesquisa para um app web — e ainda assim, fazer isso corretamente com campos com aspas, vírgulas embutidas e delimitadores diferentes de vírgula é surpreendentemente chato.

Este conversor bidirecional cuida dos casos de borda automaticamente. CSV → JSON respeita o quoting da RFC 4180 (então um campo com vírgula entre aspas continua sendo um único campo), suporta delimitadores customizados para exports europeus com ";" e arquivos separados por tab, e usa a primeira linha como chaves do objeto quando você pede. JSON → CSV pega um array de objetos e produz um CSV corretamente quotado com a união de todas as chaves como linha de cabeçalho, então campos faltantes viram células vazias em vez de deslocamentos silenciosos.

Tudo roda no seu navegador. Seja o arquivo um demo de 100 linhas ou um export de 50.000 linhas com PII, os dados ficam na sua máquina. Essa propriedade de privacidade importa quando o CSV em questão contém dados reais de usuários que você não deveria estar enviando para um serviço web qualquer.

Como usar Conversor CSV ↔ JSON

Cole seu CSV no lado CSV, ou seu array JSON no lado JSON.
Defina o Delimitador como "," (padrão), ";" para CSVs europeus, "\t" para TSV, ou qualquer caractere único.
Ative "Primeira linha é cabeçalho" para que os nomes de coluna do CSV virem chaves do objeto JSON.
Clique em "CSV → JSON" ou "JSON → CSV" dependendo da direção.
Se aparecer "CSV inválido" ou "JSON precisa ser um array de objetos", corrija a forma do input e tente de novo.
Copie a saída convertida para sua ferramenta de import de dados, editor de código ou arquivo de fixture de teste.

Casos de uso comuns

Importar um export de planilha para um app JavaScript ou fixture de teste como um array tipado de objetos.
Produzir um CSV para stakeholders não-técnicos a partir de uma resposta de API JSON.
Migrar dados entre dois sistemas em que um só exporta CSV e o outro só aceita JSON.
Converter um CSV europeu delimitado por ";" em JSON sem ter que abrir o Excel e salvar de novo como delimitado por vírgula.
Inspecionar rapidamente um dump de log TSV como JSON para passar pelo jq ou consultar com JavaScript.

Dicas e erros comuns

Se seu CSV contém vírgulas dentro de campos de texto, o campo precisa estar entre aspas duplas (RFC 4180). Vírgulas sem aspas serão parseadas como limites de coluna.
O Excel frequentemente assume ";" como delimitador padrão em sistemas com vírgula como separador decimal (a maioria da Europa e o Brasil). Configure o Delimitador conforme seu CSV se ele aparece como uma coluna gigante.
JSON → CSV exige um array plano de objetos. Objetos aninhados viram células "[object Object]" — achate ou serialize com stringify os campos aninhados antes.
Strings com cara de número ("007", "+55 11…") podem ser convertidas silenciosamente para número e perder zeros à esquerda. Coloque essas colunas entre aspas no CSV de origem para evitar problemas.

Perguntas frequentes

Campos entre aspas e vírgulas embutidas são tratados?

Sim. Nosso parser suporta quoting estilo RFC 4180, incluindo aspas duplas escapadas (""") dentro de campos e vírgulas/quebras de linha dentro de strings entre aspas.

Posso usar um delimitador diferente de vírgula?

Sim. Configure o delimitador para ; (ponto e vírgula), \t (tab), |, ou qualquer caractere. Essencial para exports CSV europeus que usam ; por padrão.

Por que JSON → CSV exige um array de objetos?

Cada objeto vira uma linha CSV, e as chaves formam o cabeçalho. Coletamos a união de todas as chaves para que campos ausentes apareçam como células vazias.

Como quebras de linha dentro de campos CSV são tratadas?

Se o campo está entre aspas duplas (conforme a RFC 4180), quebras de linha embutidas são preservadas como parte do valor. Quebras de linha sem aspas sempre encerram a linha.

Posso converter JSON profundamente aninhado para CSV?

Não diretamente — CSV é um formato tabular plano. Achate seus objetos (por exemplo, "address.city" como uma coluna) antes de converter, ou serialize com stringify os campos aninhados para que cada um vire uma célula codificada em JSON.

A saída JSON preserva a ordem das colunas do CSV?

Sim. Os objetos JSON usam a ordem de coluna da linha de cabeçalho, então o código downstream que itera com Object.keys() vê a mesma ordem do CSV de origem.

Mais recentes do blog

JSON vs YAML vs CSV: Qual Formato de Dados Você Deve Usar?JSON, YAML e CSV resolvem problemas que se sobrepõem, mas não foram projetados para o mesmo trabalho. Este mergulho profundo compara sintaxe, tamanho de arquivo, ferramental e as pegadinhas que mordem equipes em produção, para você escolher o formato certo com confiança.