Como posso converter um arquivo JSON em CSV online? (Guia 2026)

O caminho de 60 segundos: arquivo entra, planilha sai

Se você chegou aqui pesquisando "como posso converter um arquivo JSON em CSV online", provavelmente tem um arquivo parado na pasta Downloads agora mesmo e uma planilha que precisa preencher. Aqui vai o trabalho inteiro, do início ao fim, sem instalar nada:

Um: abra o conversor no seu navegador. Dois: clique no botão de envio e escolha seu arquivo .json — ou abra o arquivo em um editor de texto, copie tudo e cole na caixa de entrada do conversor. Três: aperte Converter. Quatro: baixe o CSV e abra no Excel ou no Google Planilhas. Esse é todo o procedimento. A conversão em si leva milissegundos; o minuto é você clicando.

Tudo depois desta seção é sobre as quatro pequenas decisões escondidas dentro do passo três — enviar versus colar, achatamento, o delimitador, a linha de cabeçalho — além das quatro coisas que podem fazer um CSV perfeito parecer quebrado no Excel. Se a sua conversão funcionar de primeira, você pode parar de ler aqui. Se algo aparecer errado, as correções abaixo são as que realmente funcionam, cada uma verificada contra o conversor de verdade.

Decisão 1: enviar o arquivo ou colar o conteúdo?

Um conversor online de JSON para CSV oferece duas formas de receber seus dados, e escolher a certa evita a frustração mais comum de quem está começando. O botão de envio deste site aceita arquivos .json e .txt — clique nele, escolha o arquivo, pronto. Colar significa abrir o JSON em um editor de texto, selecionar tudo, copiar e soltar na caixa de entrada do conversor.

Envie quando o arquivo for grande ou quando você tiver vários arquivos para converter: é um clique por arquivo e não envolve a área de transferência. Cole quando tiver apenas um fragmento — uma resposta copiada do painel de ferramentas de desenvolvedor do navegador, uma resposta de API copiada da documentação, um trecho que alguém lhe mandou no chat. Os dois caminhos alimentam o mesmo mecanismo, então o CSV sai idêntico de qualquer jeito.

Um aviso prático sobre colar: navegadores e aplicativos de chat às vezes corrompem colagens longas. Se você colar vários megabytes de JSON e o conversor reclamar de sintaxe inválida, não debugue os dados — apenas envie o arquivo. Nove em cada dez vezes, o "erro" estava na área de transferência, não no seu JSON.

Decisão 2: achatar os dados aninhados ou deixar como estão?

Esta é a decisão que muda o que sua planilha realmente vai parecer, então merece um exemplo concreto. Usaremos este arquivo orders.json no resto do guia — dois pedidos, objetos de cliente aninhados, uma lista de itens:

orders.json

[
  { "id": 1, "customer": { "name": "Ana", "city": "Madrid" }, "items": ["book", "pen"], "total": 19.99 },
  { "id": 2, "customer": { "name": "Ken", "city": "Osaka" }, "items": ["lamp"], "total": 42.5 }
]

Com o achatamento ATIVADO — o padrão, e a escolha certa para a maioria das pessoas — o conversor transforma objetos aninhados em colunas com notação de ponto e listas em células únicas. Passamos exatamente este arquivo pelo mecanismo de verdade para mostrar a saída byte por byte:

Achatamento ativado: o resultado ideal para planilhas

Veja o que o mecanismo produziu com o achatamento ativado — esta é a saída que você vai baixar de fato:

Saída CSV — achatamento ATIVADO (verificada no mecanismo real)

id,customer.name,customer.city,items,total
1,Ana,Madrid,book; pen,19.99
2,Ken,Osaka,lamp,42.5

Cada nível de aninhamento vira uma coluna que você pode ordenar e filtrar: customer.name, customer.city. Uma lista de valores simples vira uma célula única com os valores unidos por "; ". Este é o formato ideal para planilhas, e é o que você quer quando o objetivo é análise — tabelas dinâmicas, filtros, gráficos.

Dois detalhes que vale conhecer porque surpreendem as pessoas: a lista unida usa "; " (ponto e vírgula-espaço), então se você escolher depois um delimitador de ponto e vírgula, essa célula vai entre aspas para se proteger — o mecanismo cuida disso automaticamente. E um valor vazio simplesmente vira uma célula vazia, enquanto uma lista vazia vira [].

Achatamento desativado: o resultado honesto — mas feio

Mesmo arquivo, achatamento desativado. Cada chave de nível superior mantém sua própria coluna, e as estruturas aninhadas são enfiadas ali como texto JSON entre aspas:

Saída CSV — achatamento DESATIVADO (verificada no mecanismo real)

id,customer,items,total
1,"{""name"":""Ana"",""city"":""Madrid""}","[""book"",""pen""]",19.99
2,"{""name"":""Ken"",""city"":""Osaka""}","[""lamp""]",42.5

Ficou pior, e para análise é pior — mas é a representação honesta, e é o que você quer quando precisa preservar a estrutura aninhada exata, por exemplo antes de devolver as linhas para um sistema que espera campos no formato JSON.

Regra prática: mantenha o achatamento ativado a menos que tenha um motivo específico para desativar. A maioria das pessoas que pesquisa como converter um arquivo JSON em CSV online quer a versão ideal para planilhas.

Decisão 3: vírgula ou ponto e vírgula? (a armadilha do idioma no Excel)

A lista de delimitadores do conversor oferece vírgula, ponto e vírgula, tabulação e pipe. Para a maioria dos leitores, a escolha real é entre vírgula e ponto e vírgula, e a resposta correta depende do seu Excel, não dos seus dados.

Aqui está a armadilha: nos EUA, no Reino Unido e em boa parte da Ásia, o Excel espera valores separados por vírgula, então o arquivo padrão com vírgulas abre perfeitamente. Mas em grande parte da Europa continental e da América Latina, o Excel espera ponto e vírgula — porque essas regiões usam a vírgula como separador decimal, então os arquivos CSV delas são na verdade arquivos SSV. Abra um CSV separado por vírgulas num Excel em alemão e tudo cai na coluna A.

A correção é uma decisão de um clique antes de baixar, não um problema para resolver depois: se o seu Excel joga tudo numa coluna só, gere o CSV com ponto e vírgula. Verificamos esse caminho no mecanismo de verdade — o mesmo arquivo de pedidos, delimitador ponto e vírgula, achatamento ativado:

Saída CSV — delimitador ponto e vírgula (verificada no mecanismo real)

id;customer.name;customer.city;items;total
1;Ana;Madrid;"book; pen";19.99
2;Ken;Osaka;lamp;42.5

Repare nas aspas em volta de "book; pen" — o mecanismo coloca entre aspas qualquer célula que contenha o delimitador, então nada quebra. A tabulação é a terceira opção silenciosa: quase nada conflita com tabs, então escolha tab quando seus dados contêm vírgulas e ponto e vírgula ao mesmo tempo (endereços mais decimais europeus no mesmo arquivo). O pipe existe para o arquivo raro que contém os três.

Decisão 4: linha de cabeçalho ativada ou não?

A chave de cabeçalhos vem marcada por padrão, e você deve deixá-la marcada em quase todos os casos. A linha de cabeçalho é o que transforma uma grade de valores numa planilha utilizável — é como você ordena por customer.city em vez de por "coluna C", e é o que toda ferramenta subsequente espera.

Desative os cabeçalhos em exatamente uma situação: quando estiver acrescentando linhas a uma planilha existente que já tem sua própria linha de cabeçalho. Colar linhas sem cabeçalho sob um cabeçalho existente é o único caso comum em que uma segunda linha de cabeçalho corromperia a planilha. Em todo o resto, mantenha os cabeçalhos.

Quando o CSV aparece errado no Excel: as 4 correções que realmente funcionam

Um CSV perfeito ainda pode parecer quebrado no momento em que o Excel o abre, porque o Excel adivinha coisas em vez de perguntar. Estas são as quatro falhas que vemos, em ordem de frequência, com a correção para cada uma:

Caracteres embaralhados ou acentuados (café vira cafÃ©). Isso é incompatibilidade de codificação, não dados quebrados. O conversor gera UTF-8 puro sem BOM, e o Excel às vezes adivinha a codificação errada quando você dá dois cliques no arquivo. Correção: no Excel, use Dados > De Texto/CSV, escolha o arquivo e defina Origem do Arquivo como 65001 (UTF-8) explicitamente. O Google Planilhas lida com UTF-8 corretamente na importação, então isso é mais um problema do Excel.
Tudo numa coluna só. Seu Excel espera um delimitador diferente do que o arquivo usa — veja a Decisão 3. Gere de novo com ponto e vírgula, ou importe via Dados > De Texto/CSV e diga ao Excel qual delimitador o arquivo usa.
Zeros à esquerda somem (007 vira 7, CEPs perdem o zero). O Excel vê dígitos e converte a célula em número. Correção: importe via Dados > De Texto/CSV e defina essas colunas como tipo Texto durante o assistente de importação — faça isso na hora da importação, porque os zeros são irrecuperáveis depois que o Excel já os engoliu.
Datas se reformatam sozinhas (2026-10-12 vira 10/12/2026 ou, pior, um número de série). Mesma causa raiz: o Excel detecta automaticamente textos que parecem data. Correção: marque as colunas de data como Texto durante a importação em Dados > De Texto/CSV e formate-as como datas você mesmo depois que os dados estiverem a salvo na planilha.

Repare no padrão: três das quatro correções acontecem na hora da importação, não no conversor. O trabalho do conversor é produzir um CSV correto; o assistente de importação do Excel é onde você diz ao Excel como lê-lo. Dar dois cliques num CSV é conveniente e errado — os 20 segundos que o assistente de importação leva são o seguro mais barato deste guia inteiro.

É seguro? Seu arquivo JSON nunca sai do seu navegador

A pergunta por trás de "como posso converter um arquivo JSON em CSV online" costuma ser na verdade "posso confiar num site aleatório com este arquivo?" — principalmente quando o arquivo contém dados de clientes, exportações financeiras ou qualquer coisa com nomes. A resposta honesta depende da arquitetura da ferramenta, não das suas promessas.

O conversor deste site roda no lado do cliente: a conversão acontece em JavaScript dentro da sua aba do navegador. Seu arquivo é lido localmente, convertido localmente e baixado localmente — nada é enviado para nenhum servidor, porque não há etapa de servidor no processo. Você pode verificar isso sozinho em uns 30 segundos: abra o conversor, desconecte a rede (o modo avião funciona) e converta um arquivo. O CSV continua baixando. Uma ferramenta que precisasse dos seus dados no servidor não conseguiria fazer isso.

Dito isso, seja honesto sobre os limites: rodar no lado do cliente significa que o arquivo fica na memória do seu navegador durante a conversão, numa máquina que você controla. Não converta arquivos num computador emprestado ou público em que você não confia, e se seus dados são regulados (prontuários de saúde, dados pessoais financeiros sob algum regime de conformidade), verifique a política da sua organização antes de usar qualquer ferramenta web — a arquitetura é segura, mas a sua política pode dizer não mesmo assim.

Quando o caminho online é a resposta errada

Um conversor online é a ferramenta certa para conversões pontuais de arquivos pequenos a médios, sem instalar nada. É a ferramenta errada em três situações, e dizer isso faz parte de um guia honesto:

Arquivos enormes. Uma aba do navegador fica confortável até alguns megabytes e fica lenta depois de dezenas de megabytes. Para centenas de megabytes, use jq ou um script curto em Python localmente — eles transmitem o arquivo em vez de segurar tudo na memória.
Conversões que você repete todo dia. Se você converte a mesma exportação toda manhã, um script salvo ou um one-liner em jq transforma um minuto diário em zero segundos diários. A ferramenta online é para o trabalho irregular; o script é para a rotina.
Colunas escolhidas, renomeadas e reordenadas à mão. O conversor entrega cada chave como uma coluna, na ordem das chaves do arquivo. Se você precisa de três colunas específicas renomeadas e reordenadas, uma projeção explícita em jq ou pandas vence clicar numa interface toda vez.

Para a comparação completa das seis abordagens — conversor online, Power Query do Excel, Python/pandas, jq, VS Code, Google Planilhas — com cada uma realmente testada, veja nosso guia de comparação de ferramentas. Para o caminho mais rápido possível, independente do método, veja o guia de menos de um minuto.

Guias relacionados

Perguntas frequentes

Como posso converter um arquivo JSON em CSV online de graça?

Abra um conversor online e gratuito de JSON para CSV, envie seu arquivo .json (ou cole o conteúdo), mantenha o achatamento ativado, escolha o delimitador que sua planilha espera e baixe o CSV. Tudo leva menos de um minuto e não precisa de conta — o conversor deste site é gratuito e sem cadastro.

Preciso instalar algo para converter um arquivo JSON em CSV online?

Não. Um conversor online roda no seu navegador — esse é exatamente o ponto. Envie ou cole seu JSON, converta, baixe o CSV. Instalar Python, jq ou plugins do Excel só faz sentido para arquivos enormes ou conversões repetidas diariamente.

Qual a diferença entre enviar um arquivo JSON e colar o texto JSON?

Nenhuma na saída — os dois alimentam o mesmo mecanismo. Enviar é melhor para arquivos grandes ou para converter vários arquivos em sequência; colar é melhor para fragmentos copiados de ferramentas de desenvolvedor, documentação de API ou chat. Se uma colagem gigante der erro de sintaxe, envie o arquivo — provavelmente a área de transferência corrompeu o texto.

Por que meu CSV convertido mostra tudo numa coluna só no Excel?

Seu Excel espera um delimitador diferente do que o arquivo usa — o mais comum é um Excel europeu ou latino-americano esperando ponto e vírgula abrir um arquivo separado por vírgulas. Gere o CSV de novo com delimitador ponto e vírgula, ou importe via Dados > De Texto/CSV e diga ao Excel qual delimitador o arquivo usa.

Como converto um arquivo JSON em CSV sem perder os dados aninhados?

Mantenha a opção de achatamento ativada. Ela transforma objetos aninhados em colunas com notação de ponto (customer.name, customer.city) e listas de valores simples em células únicas unidas por "; " — verificado no conversor de verdade. Desativar o achatamento enfia as estruturas aninhadas em células entre aspas como texto JSON puro.

É seguro enviar um arquivo JSON com dados pessoais para um conversor online?

Depende da arquitetura da ferramenta. Neste site o conversor roda no lado do cliente — o arquivo nunca sai da sua aba do navegador, o que você pode verificar convertendo com a rede desconectada. Ferramentas que enviam para o servidor mandam seu arquivo para a infraestrutura delas, então verifique de que tipo é a ferramenta antes de colar dados sensíveis.

Posso converter um arquivo JSON em CSV no celular?

Sim — o conversor é uma página web, então funciona no navegador do celular. Envie o arquivo do armazenamento do seu telefone (ou cole o JSON), converta e baixe o CSV. Para arquivos grandes ou um trabalho preciso de delimitadores, um navegador de computador é mais confortável, mas a conversão em si funciona do mesmo jeito.