Conversor Gratuito

Conversor de JSON para CSV

Converta dados JSON para o formato CSV instantaneamente no seu navegador. Suporta delimitadores personalizados, aspas e grandes conjuntos de dados.

Sobre esta ferramenta

Passar de JSON para CSV nivela os dados hierárquicos em um formato tabular. O ponto forte do JSON é que ele pode descrever objetos aninhados, matrizes de comprimentos variados e informações de tipo rico; A estrutura mais simples do CSV não pode expressar nada disso nativamente. A conversão, portanto, envolve escolhas: quais campos se tornam colunas, como os objetos aninhados são nivelados (usando notação de ponto como endereço.cidade) e o que fazer com matrizes dentro de registros.

Este conversor lida com o caso comum — uma matriz de objetos planos com chaves consistentes — diretamente: cada objeto torna-se uma linha, a união de chaves em todos os objetos torna-se o conjunto de colunas e os campos ausentes tornam-se células vazias. Para dados aninhados, o conversor oferece uma opção nivelada que une chaves aninhadas com pontos, produzindo cabeçalhos de colunas como user.name, user.email, address.zip.

PapaParse gera a saída CSV, aplicando aspas adequadas para campos contendo vírgulas, novas linhas ou caracteres de aspas. A saída é compatível com RFC 4180 e abre corretamente no Excel, no Planilhas Google e em qualquer outra ferramenta compatível com CSV.

Por que converter JSON para CSV

As planilhas ainda são o formato de dados universal para não desenvolvedores. Equipes de vendas, equipes financeiras, equipes de marketing e a maioria das outras funções de negócios vivem no Excel ou no Planilhas Google, e pedir que consumam JSON diretamente é pedir que leiam o formato de dados de um programador. Conversão de pontes JSON para CSV a partir de saídas de API e exportações de banco de dados no formato que os usuários corporativos realmente abrem.

CSV também é o formato mais confiável para importação para sistemas legados. Importações de CRM, software de contabilidade e ferramentas analíticas mais antigas aceitam CSV, mas não JSON. A conversão antes da importação costuma ser o único caminho.

Como usar

Cole ou carregue JSON, escolha nivelamento e obtenha CSV.

  1. Adicione seu JSON: Cole o texto JSON na área de entrada ou solte um arquivo .json. A entrada deve ser uma matriz JSON de objetos (ou um objeto JSON contendo tal matriz). Outras formas produzem produção limitada.
  2. Escolha o achatamento: Desative para manter apenas os campos de nível superior (objetos aninhados são stringificados). Ative para nivelar objetos aninhados em colunas separadas por pontos (user.name, user.email).
  3. Converter: O conversor percorre a matriz JSON, coleta a união de chaves e grava uma linha por objeto. PapaParse lida com cotações e escapes para a saída CSV.
  4. Baixe ou copie: Salve como .csv ou copie para a área de transferência. A saída é aberta no Excel, no Planilhas ou em qualquer outro consumidor CSV.

Casos de uso comuns

Detalhes técnicos

O conversor espera uma matriz JSON de objetos. Para cada objeto, a união de todas as chaves da matriz é calculada e usada como conjunto de cabeçalho da coluna. Cada objeto é escrito como uma linha, com valores vazios para chaves que não contém.

Quando o nivelamento está ativado, os objetos aninhados são percorridos recursivamente: { user: { name: 'A', email: 'B' } } torna-se as colunas user.name e user.email. Matrizes dentro de objetos são stringificadas (voltadas para texto JSON), pois o CSV não pode representar nativamente vários valores por célula.

A função unparse do PapaParse gera a saída CSV. Os campos que contêm vírgulas, novas linhas ou aspas são colocados entre aspas duplas, com aspas internas escapadas por duplicação. A saída usa finais de linha CRLF e inclui a linha de cabeçalho por padrão.

Melhores Práticas

Perguntas frequentes

A conversão de JSON para CSV 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 para o formato CSV?
CSV é universalmente suportado por aplicativos de planilhas (Excel, Planilhas Google), bancos de dados e linguagens de programação. É o formato mais simples para troca de dados tabulares.
O conversor lida com estruturas JSON aninhadas ou complexas?
Sim. A ferramenta analisa corretamente objetos aninhados, matrizes e todos os tipos de dados JSON padrão, preservando a estrutura de dados completa na saída CSV.
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. A conversão é executada no seu navegador usando PapaParse.
E quanto a objetos com chaves diferentes no mesmo array?
O cabeçalho CSV é a união de todas as chaves. Objetos sem uma chave específica produzem células vazias nessa coluna. O CSV permanece válido, apenas esparso.
Posso converter novamente de CSV para JSON?
Sim – use a ferramenta CSV para JSON. A viagem de ida e volta pode ser sem perdas para dados simples; dados aninhados podem precisar de normalização.
Qual é o tamanho máximo?
Até 50 MB de entrada JSON. Arquivos maiores podem ficar lentos devido à memória do navegador.