JSON aninhado para CSV: escolha suas linhas e colunas
Dois registros, cinco colunas e os detalhes que um CSV não consegue preservar.
Uma exportação JSON pode conter uma lista dentro de outra lista, enquanto CSV precisa de linhas e colunas. Antes de converter, escolha qual lista deve virar a tabela e o que fazer com os valores dentro de cada registro.
Este JSON de exemplo contém dois criadores sob data.items. Cada um tem um objeto creator aninhado, um array tags e um campo note. Uma nota é null; a outra é uma string vazia.
Escolha os registros antes de selecionar as colunas
Abra o conversor de CSV, JSON e YAML, importe o exemplo e escolha JSON em De, depois CSV em Para. Abra Opções e defina Caminho de dados (opcional) como /data/items.
Sem esse caminho, o objeto externo vira uma única linha. Com ele, os dois itens viram duas linhas. O caminho seleciona dados; ele não renomeia campos nem busca valores correspondentes.
Caminhos usam nomes separados por barras, seguindo a notação JSON Pointer. Digite /data/items, não data.items. Se um nome de campo contiver uma barra, escreva ~1 para essa barra; use ~0 para um til literal.
Decida se objetos aninhados ficam em uma única célula
Com Achatar objetos aninhados desativado, as colunas são id, creator, tags e note. O objeto criador ocupa uma célula CSV como texto JSON. Isso é CSV válido, mas fica estranho se você quiser ordenar por país.
Ative o achatamento e as colunas ficam:
/id
/creator/name
/creator/region
/tags
/note
Agora Zoë e AU têm células próprias. Os cabeçalhos com prefixo de barra descrevem de onde veio cada valor. Eles também evitam confundir um campo literal chamado creator.name com um campo aninhado chamado name.
Compare o CSV com célula aninhada com o CSV achatado. Ambos têm duas linhas de dados. As aspas duplicadas ao redor do JSON dentro de uma célula CSV são escape, não dados duplicados.
Arrays não viram linhas extras
Achatamento expande objetos aninhados. Ele não divide um array em várias linhas nem cria uma coluna separada para cada entrada do array. Neste exemplo, /tags ainda contém um único array JSON em uma célula:
["design","video"]
Se sua planilha precisar de uma linha por tag, prepare essa tabela explicitamente antes. Decida se o ID do criador deve ser repetido em cada linha e como representar uma lista de tags vazia. O conversor não toma essas decisões por você.
Mantenha o JSON se precisar reconstruí-lo depois
CSV não tem distinção nativa entre valor ausente, null e string vazia. Ambas as notas neste exemplo exportam como células vazias. Converter esse CSV de volta com as configurações padrão produz duas strings vazias.
O JSON reconvertido também mantém /creator/name como chave literal e /tags como string. Ele não reconstrói objetos aninhados nem analisa o array automaticamente. Guarde o JSON original para recuperar a estrutura inicial quando precisar.
O ID 001 é mantido como texto neste conversor. Uma planilha pode ainda interpretá-lo como número ao abrir o CSV; importe a coluna de ID como texto também lá. Deixe Proteger CSV de fórmulas de planilha ativado para exportações destinadas a planilhas e revise o arquivo antes de compartilhar.
O que verificamos
Em 8 de outubro de 2026, executamos o exemplo pela mesma função de conversão da ferramenta. Verificamos as duas variantes de CSV, suas contagens de duas linhas, as cinco colunas achatadas e a conversão de volta para JSON. O arquivo de resultados contém as saídas e hashes de download.
A pré-visualização da tabela mostra até 500 linhas; não é uma contagem de tudo na exportação. Verifique o total exibido e o arquivo baixado ao trabalhar com um conjunto de dados maior.