JSON para CSV: Guia de Exportação de Dados
Você tem uma API que retorna JSON. Seu gerente quer numa planilha. Seu analista precisa em CSV pro script Python. Essa é uma das tarefas de conversão mais comuns no desenvolvimento.
O Problema de Estrutura
JSON é hierárquico — suporta aninhamento, arrays e tipos mistos. CSV é plano — linhas e colunas, nada mais. A conversão nem sempre é 1:1.
O Caso Simples
Array de objetos flat se converte diretamente: cada objeto vira uma linha, cada chave vira um header de coluna.
A Parte Difícil: Objetos Aninhados
Abordagens comuns: notação com ponto (address.street), JSON na célula, ou join de arrays.
Edge Cases do CSV
Vírgulas em valores precisam de aspas. Aspas em valores precisam de escape com aspas duplas. Newlines precisam de wrapping. E UTF-8 BOM ajuda o Excel detectar encoding.
Em JavaScript
Extrair headers de todos os objetos, escapar valores por RFC 4180, tratar valores faltantes como strings vazias.
Quando NÃO Usar CSV
Se seus dados têm estruturas profundamente aninhadas, tipos mistos ou mais de 1M de linhas, considere Parquet ou Arrow.
Converta agora: Conversor JSON para CSV — trata escaping, quoting e arrays JSON flat instantaneamente.