What is JSON to CSV converter online: anatomia da ferramenta (Guia 2026)

What is JSON to CSV converter online: cinco máquinas, não uma

Quando você cola JSON em um conversor e recebe um CSV, parece uma única ação. Não é. Todo conversor online de JSON para CSV, incluindo o desta página, executa as mesmas cinco etapas na mesma ordem: analisar, localizar linhas, achatar, serializar, baixar. Saber o que cada etapa faz muda a forma como você lê cada mensagem de erro e cada célula com aparência estranha, porque cada tipo de problema pertence a exatamente uma etapa.

A sequência importa por um segundo motivo: as opções da página não são configurações mágicas. Cada botão e menu se conecta a uma etapa específica. A opção de achatamento controla a etapa três. A escolha do delimitador controla a etapa quatro. Quando você enxerga o mapa, as opções deixam de ser palpites e passam a ser decisões.

Este guia percorre as cinco etapas em ordem sobre o mesmo pequeno registro de pedido, para que você veja cada máquina fazendo o seu trabalho. Toda saída mostrada foi produzida pelo conversor real desta página, não ilustrada.

Parte 1: o analisador, o segurança na porta

A etapa um lê o que você colou e decide se é JSON de verdade. Esta é a máquina mais rígida da sequência e a menos tolerante: JSON com uma aspa faltando, uma vírgula sobrando no fim ou um caractere estranho é rejeitado aqui, antes de qualquer outra coisa rodar. Isso é uma qualidade. Um conversor que adivinhasse entradas quebradas produziria silenciosamente uma tabela errada.

Quando o analisador rejeita a sua entrada, ele diz onde parou, geralmente a um ou dois caracteres do erro real. As duas rejeições mais comuns são a caixa vazia e o JSON malformado, e as mensagens são simples:

What the parser reports

Input: (empty box)
Output: Input is empty. Please paste or upload JSON data.

Nada nos seus dados muda nesta etapa. O analisador aceita o JSON e entrega os valores estruturados à etapa dois, ou interrompe toda a sequência com um erro. Se você já viu um conversor produzir uma tabela a partir de uma entrada que você sabe que está quebrada, esse conversor pulou a validação, e você não deveria confiar na saída dele.

Parte 2: o localizador de linhas, de onde vêm as linhas

A etapa dois olha o JSON analisado e responde a uma pergunta: o que vira uma linha? Um CSV é uma lista de linhas, então o conversor precisa encontrar uma lista em algum lugar nos seus dados. O caso fácil é um array de objetos no nível superior: cada objeto vira uma linha, ponto final.

Dados reais raramente são tão organizados. APIs adoram embrulhar suas listas: {"users": [...], "total": 2}. Um bom localizador de linhas detecta a lista embrulhada, usa-a como linhas e ignora os campos do embrulho. Um único objeto sem nenhuma lista vira exatamente uma linha. JSON delimitado por quebras de linha, um objeto por linha, é lido como uma linha por linha.

Input: a wrapped list, as APIs return it

{"users": [{"name": "Amelia", "city": "Austin"}, {"name": "Bruno", "city": "Berlin"}], "total": 2}

O localizador de linhas extrai a lista de users e cria duas linhas com as colunas name e city. O campo total não é uma linha nem uma coluna, então é descartado. Esta é a etapa a culpar quando a sua saída tem menos linhas do que você esperava, ou quando colunas esperadas estão faltando: o conversor encontrou uma lista diferente da que você pretendia.

Parte 3: o achatador, a única transformação real

A etapa três é a única que muda a forma dos seus dados. Células de CSV não podem conter objetos nem listas, então tudo o que estiver aninhado precisa ser reescrito antes de caber em uma tabela. O achatador puxa cada valor aninhado para o nível superior seguindo regras fixas: objetos aninhados viram colunas com notação de ponto, listas curtas de valores simples viram uma célula com os valores unidos, e listas de objetos viram texto JSON dentro de uma célula entre aspas.

Aqui está o registro de entrada que este guia usa, com um objeto customer aninhado, uma lista tags e uma nota contendo uma vírgula:

Input JSON (nested)

[{"id": "A-101", "customer": {"name": "Amelia", "city": "Austin"}, "tags": ["new", "vip"], "note": "ships, fast"}]

Parte 3: o achatador, a única transformação real (continuação)

E aqui está o que o achatador entrega à próxima etapa, verificado no conversor real:

Flattened output (verified against the real engine)

id,customer.name,customer.city,tags,note
A-101,Amelia,Austin,new; vip,"ships, fast"

Leia coluna por coluna. O objeto customer virou duas colunas, customer.name e customer.city. A lista tags virou uma célula, new; vip, com os valores unidos por ponto e vírgula e espaço. A nota manteve a sua vírgula, e a etapa quatro vai cuidar disso. Valores nulos e listas vazias viram células vazias. Nada é inventado e nada é apagado, mas uma árvore virou uma tabela.

Desligue a opção de achatamento e a etapa três é pulada: valores aninhados ficam como texto JSON dentro das suas células, entre aspas para que a tabela continue válida. Às vezes é isso que você quer, quando o sistema de destino extrai o JSON de volta, e às vezes vira uma bagunça. De qualquer forma, é esta etapa que faz isso.

Parte 4: o serializador, o motor de aspas

A etapa quatro transforma as linhas achatadas em texto CSV, e o seu único trabalho é manter a tabela válida. A regra que ela segue é simples: uma célula que contém o delimitador, uma aspa ou uma quebra de linha é envolvida em aspas duplas, e qualquer aspa interna é duplicada. Todo o resto é escrito sem aspas.

A parte sutil é que as aspas seguem o delimitador em uso, não uma ideia fixa do que é especial. Veja o mesmo registro serializado com delimitador ponto e vírgula, verificado no conversor real:

Semicolon output (verified against the real engine)

id;customer.name;customer.city;tags;note
A-101;Amelia;Austin;"new; vip";ships, fast

A célula tags agora está entre aspas, porque new; vip contém um ponto e vírgula. Mas a nota ships, fast está sem aspas: com ponto e vírgula como delimitador, uma vírgula é um caractere comum e não precisa de proteção. O motor envolve entre aspas conforme o delimitador real em uso. É por isso também que um CSV com aparência perfeita pode abrir como uma única coluna no Excel: o Excel o dividiu por um delimitador diferente do que o serializador usou, o que é uma incompatibilidade da etapa quatro, não dados quebrados.

Parte 4: o serializador, o motor de aspas (continuação)

Mais um delimitador, porque ele surpreende as pessoas: o tab. Tabs quase nunca aparecem em dados reais, então a saída separada por tab geralmente não precisa de nenhuma aspa:

Tab output (verified against the real engine)

id	customer.name	customer.city	tags	note
A-101	Amelia	Austin	new; vip	ships, fast

Nenhuma aspa em lugar nenhum. A opção de cabeçalho também é uma opção da etapa quatro: ela simplesmente decide se os nomes das colunas são escritos como a primeira linha. Nada mais muda.

Parte 5: o download, UTF-8 simples e um nome de arquivo

A etapa cinco é a menos interessante e a mais fácil de errar. Ela pega o texto pronto e entrega a você como um arquivo. Esta página o nomeia data-export-YYYY-MM-DD.csv para que downloads repetidos sejam ordenados por data, e o grava como UTF-8 simples sem marca de ordem de byte.

O detalhe da ausência de BOM vale a pena conhecer porque ele morde no Excel. Alguns programas esperam um BOM para detectar UTF-8; sem ele, caracteres acentuados podem aparecer como mojibake quando você clica duas vezes no arquivo. A correção está no lado da abertura, não no arquivo: no Excel, importe o arquivo como importação de texto e escolha a codificação 65001: Unicode (UTF-8). O arquivo em si está correto.

Onde as opções da página se conectam

Com as cinco etapas mapeadas, as opções do conversor se leem como um diagrama de ligações. A opção de achatamento de valores aninhados ativa ou ignora a etapa três. A escolha do delimitador, vírgula, ponto e vírgula, tab ou pipe, define o caractere contra o qual a etapa quatro aplica as aspas. A opção de incluir linha de cabeçalho adiciona ou remove a linha com os nomes das colunas na etapa quatro. A Conversão Automática simplesmente reexecuta toda a sequência a cada tecla em vez de esperar um botão.

Não há opção que alcance o analisador, e isso é intencional: validação não é uma preferência. Um conversor que permitisse desativar a etapa um produziria lixo com aparência confiante a partir de entradas quebradas.

Quando a saída parece errada, culpe exatamente uma parte

Diagnóstico é o objetivo de conhecer a sequência. Combine o sintoma com a etapa e você saberá onde olhar:

Uma mensagem de erro citando uma posição: etapa um, o analisador. O seu JSON está malformado perto do ponto informado; valide-o e corrija a origem.
Menos linhas ou colunas faltando: etapa dois, o localizador de linhas. O conversor escolheu uma lista diferente da pretendida, ou a forma do seu embrulho o confundiu.
Dados aninhados como texto JSON ilegível nas células: etapa três, o achatador, está desligado ou os dados eram fundos demais. Ligue o achatamento.
Tudo cai em uma coluna ao abrir: etapa quatro, o serializador, usou um delimitador diferente do que a sua planilha espera. Reimporte e escolha o delimitador certo, ou gere de novo com ponto e vírgula ou tab.
Aspas estranhas ou linhas divididas: aspas da etapa quatro, geralmente da opção de nunca colocar aspas ou de CSV editado à mão. Deixe as aspas no automático.
Caracteres estranhos ao abrir: etapa cinco, a codificação do download. Reimporte como UTF-8 (65001) em vez de clicar duas vezes.

O que um conversor online de JSON para CSV não é

A sequência também define as fronteiras. Um conversor não é um editor de JSON: ele não pode corrigir os seus dados, renomear os seus campos ou decidir o que uma coluna significa. Ele também não é um formatador de JSON, embora o analisador valide como efeito colateral; se você quer JSON bonito, essa é outra ferramenta. Ele não é uma planilha: depois que o CSV é baixado, ordenação, filtros e fórmulas acontecem no Excel ou no Sheets, não no conversor.

E ele não pode mudar o significado dos seus dados. O achatamento preserva valores mas colapsa tipos: números, booleanos e nulos viram texto, estrutura aninhada vira nomes de colunas, e não há caminho de volta da árvore original só a partir do CSV. Quando as linhas têm formas diferentes, o conversor pega a união de todas as colunas e deixa espaços em branco onde uma linha não tem um campo. É um comportamento honesto, mas vale saber antes de converter: um conversor rearranja os seus dados com fidelidade, e fidelidade é tudo o que ele promete.

Guias relacionados

Perguntas frequentes

O que é um conversor online de JSON para CSV em uma frase?

É uma página da web que transforma dados JSON em um arquivo CSV em cinco etapas, analisador, localizador de linhas, achatador, motor de aspas e download, com toda a sequência rodando na sua aba do navegador.

Quais são as cinco partes de um conversor de JSON para CSV?

O analisador, que valida o JSON; o localizador de linhas, que decide o que vira uma linha; o achatador, que transforma valores aninhados em células simples; o serializador, que escreve texto CSV válido com as aspas corretas; e a etapa de download, que entrega o arquivo. As opções da página se conectam às três do meio.

Por que o conversor coloca aspas em algumas células e em outras não?

As aspas seguem o delimitador em uso. Uma célula só é envolvida em aspas se contiver o delimitador ativo, uma aspa ou uma quebra de linha, e as aspas internas são duplicadas. Mude o delimitador e células diferentes recebem aspas, o que é comportamento correto, não inconsistência.

Por que a saída do meu conversor abriu como uma coluna no Excel?

Isso é uma incompatibilidade de delimitador na etapa do serializador, não dados quebrados. O Excel divide colunas pelo seu separador de lista do sistema, que é uma vírgula em algumas regiões e um ponto e vírgula em outras. Reimporte o arquivo e escolha o delimitador correspondente, ou gere o CSV de novo com a opção de ponto e vírgula ou tab.

Um conversor de JSON para CSV é o mesmo que um formatador de JSON?

Não. Um formatador deixa o JSON bonito para humanos lerem; um conversor reestrutura o JSON em uma tabela para planilhas abrirem. O analisador do conversor valida o seu JSON como efeito colateral, por isso entradas inválidas recebem um erro em vez de uma tabela, mas formatação não é o trabalho dele.

Um conversor pode corrigir JSON quebrado ou inválido?

Não, e você deveria desconfiar de um que tente. A etapa do analisador rejeita JSON malformado com um erro citando a posição onde parou. Corrija o JSON na origem, uma aspa faltando ou uma vírgula sobrando perto da posição informada, e converta de novo.

O conversor muda os meus dados, ou só o formato?

Os valores são preservados mas a forma muda. O achatamento transforma objetos aninhados em colunas com notação de ponto e listas em células unidas, e todo valor vira texto: números, booleanos e nulos perdem os seus tipos. Linhas com formas diferentes recebem a união de todas as colunas com espaços em branco onde um campo está faltando.

Veja as cinco partes em ação

Cole qualquer JSON no conversor desta página e veja o analisador, o achatador e o motor de aspas fazendo o seu trabalho. Grátis, sem cadastro, roda inteiramente no seu navegador.

Abrir o conversor de JSON para CSV

Todos os guias