JSON para CSV

Exemplo

Entrada:

[
  { "id": 1, "user": { "name": "Alice", "email": "a@a.com" }, "tags": ["admin"] },
  { "id": 2, "user": { "name": "Bob",   "email": "b@b.com" }, "tags": ["user", "beta"] }
]

Saída (achatar aninhados, juntar arrays):

id,user.name,user.email,tags
1,Alice,a@a.com,admin
2,Bob,b@b.com,"user,beta"

Escolha do delimitador

Regras de citação

Um campo deve ser citado quando contém:

• o delimitador
• uma aspa dupla (que é escapada duplicando: " -> "")
• uma nova linha

“Citar sempre” é mais seguro para compatibilidade entre ferramentas; “citar apenas quando necessário” torna o arquivo mais fácil de ler manualmente.

Tratamento de objetos aninhados

• Achatar: { user: { name: "A" } } se torna uma coluna user.name. Caminhos profundos se tornam a.b.c.d.
• String JSON: o objeto aninhado permanece como um valor JSON de coluna única: "{\"name\":\"A\"}". Útil quando ferramentas a jusante podem analisá-lo.
• Stringificar: junta com um separador, perdendo a estrutura.

Tratamento de arrays

• Juntar: ["a", "b"] se torna "a,b" em uma única coluna.
• Colunas indexadas: produz tags.0, tags.1, tags.2, funciona apenas quando o comprimento do array é consistente.
• Apenas o primeiro elemento: pega tags[0] e ignora o resto.

Erros comuns

• Chaves desiguais entre objetos. Se um objeto tem phone e outro não, o CSV terá uma coluna phone com células vazias para as linhas ausentes. Sempre valide se o conjunto de chaves é consistente.
• Esquecer o BOM para Excel. O Excel no Windows lê CSVs UTF-8 sem BOM como Latin-1 e embaralha caracteres acentuados. A ferramenta oferece uma opção de “prefixar UTF-8 BOM” para esse caso.
• Incorporar novas linhas em valores. Legal no CSV RFC 4180, mas alguns importadores falham. Se seu alvo for frágil, substitua \n por um espaço ou token \\n.
• Usar Excel como um formato de ida e volta. O Excel converte silenciosamente 007 para 7, trunca números longos e corrompe zeros à esquerda em IDs. Para integridade dos dados, use CSV com um analisador adequado.