Converta JSON para CSV em Três Passos
- Adicione os dados JSON. Cole um objeto ou array, ou envie um arquivo
.jsonsuportado. - Escolha as regras de conversão. Selecione o array de registros, delimitador, comportamento do cabeçalho e opções de dados aninhados.
- Revise e exporte. Verifique a pré-visualização da tabela, copie o texto CSV ou baixe um arquivo
.csv.
Estruturas JSON que esta ferramenta deve aceitar
Array de Objetos
Um array de objetos é a fonte mais clara para CSV porque cada objeto se torna uma linha.
[
{"id": 1, "name": "Ada"},
{"id": 2, "name": "Lin"}
]
As chaves se tornam colunas e os objetos se tornam linhas.
Objeto Único
Um único objeto plano se torna uma linha CSV. Se o objeto contém um array aninhado de registros, a ferramenta permite selecionar esse array como fonte de registros.
{
"results": [
{"id": 1, "status": "active"},
{"id": 2, "status": "paused"}
],
"count": 2
}
Selecionar results cria duas linhas. O valor wrapper count não é transformado em um terceiro registro.
Objetos com Chaves Diferentes
Arrays JSON reais nem sempre contêm objetos idênticos. O conversor constrói uma união de chaves entre os registros selecionados.
[
{"id": 1, "email": "[email protected]"},
{"id": 2, "phone": "555-0100"}
]
O CSV contém colunas id, email e phone, com um valor vazio onde um registro não contém essa chave.
Achatar JSON Aninhado
Objetos aninhados não podem caber diretamente em colunas CSV comuns. Esta ferramenta achata caminhos de objetos básicos em nomes de colunas.
{
"user": {
"name": "Ada",
"address": {
"city": "London"
}
}
}
Colunas sugeridas:
user.name
user.address.city
O painel de opções inclui achatar objetos aninhados ligado ou desligado, o separador de caminho, a profundidade máxima de achatamento e o comportamento após a profundidade máxima ser atingida.
Escolha Como os Arrays São Escritos
Arrays precisam de uma regra de saída deliberada porque uma célula CSV não pode representar registros estruturados repetidos naturalmente.
- Juntar valores primitivos:
["red","blue"]se tornared, blue. - Manter como JSON: preservar o texto completo do array em uma célula citada.
- Deixar vazio: disponível apenas como uma escolha explícita do usuário, nunca o padrão silencioso.
Opções de Saída CSV
Delimitador
Escolha vírgula, ponto e vírgula, tabulação, barra vertical ou um caractere personalizado suportado. O delimitador selecionado é aplicado consistentemente ao cabeçalho e a cada linha.
Linha de Cabeçalho
A saída padrão inclui nomes de colunas. Um alternador remove o cabeçalho para sistemas que só aceitam linhas brutas.
Citação
Valores CSV contendo o delimitador, uma aspa ou uma quebra de linha são citados corretamente. Aspas literais dentro de um campo citado são escapadas.
- citação mínima
- citar todos os campos
- fim de linha
- incluir BOM UTF-8 quando necessário para compatibilidade com planilhas
Valores Vazios e Nulos
Escolha como null, chaves ausentes e strings vazias são representadas: célula vazia, null literal ou um placeholder personalizado. A pré-visualização torna a distinção visível antes do download.
Pré-visualize o CSV Gerado
A pré-visualização mostra a contagem de registros detectada, a contagem de colunas geradas, o caminho do registro selecionado e avisos para formas de objetos inconsistentes ou arrays aninhados, além de uma visão de tabela das primeiras linhas renderizadas. A saída CSV bruta está disponível quando você precisa inspecionar a citação.
Problemas Comuns de JSON para CSV
A saída tem apenas uma linha
O valor JSON selecionado é provavelmente um único objeto em vez do array de registros. Escolha o array aninhado que contém os registros.
Campos aninhados estão faltando
Ative o achatamento ou selecione “manter valor aninhado como JSON”. A ferramenta avisa quando um valor excede a profundidade de achatamento configurada.
Algumas linhas têm células em branco
Os objetos JSON contêm chaves diferentes ou valores ausentes. CSV requer um conjunto compartilhado de colunas, então valores ausentes se tornam células vazias ou o placeholder selecionado.
Arrays são ilegíveis no Excel
Altere a estratégia de array. Junte valores primitivos para tags simples, ou mantenha o array original como JSON compacto quando a estrutura importa.
Caracteres acentuados parecem incorretos
Baixe com configurações compatíveis com UTF-8 e abra o arquivo usando a codificação correta. Se uma opção BOM existir, ela apenas muda o prefixo de bytes; não recodifica o conteúdo.
FAQ JSON para CSV
Este conversor pode lidar com JSON aninhado?
Sim, para o comportamento de achatamento implementado no painel de opções. Chaves de objetos aninhados podem se tornar colunas baseadas em caminho. Arrays aninhados requerem uma estratégia de array separada.
Como os cabeçalhos CSV são criados?
O conversor constrói cabeçalhos a partir das chaves encontradas nos registros selecionados. Quando os registros têm chaves diferentes, a união dessas chaves se torna o conjunto completo de cabeçalhos.
O que acontece com arrays JSON?
Arrays primitivos podem ser juntados ou mantidos como texto JSON. Arrays de objetos são preservados como JSON em vez de juntados em texto inutilizável.
Números e booleanos são mantidos?
Sua representação de texto é escrita no CSV. O CSV em si não preserva tipos JSON, então o software downstream decide como cada célula é interpretada.
O JSON é enviado?
Não — os dados que você cola são processados inteiramente no seu navegador. Arquivos acima do limite de processamento do navegador são oferecidos como um fallback opcional do servidor, e nada é enviado sem seu consentimento.
Posso converter JSON de volta do CSV?
Sim. Use o conversor de CSV para JSON e escolha as opções de cabeçalho e detecção de tipo que correspondem ao arquivo.