JSON para planilha Excel

De JSON aninhado a uma grade plana

Cole um array de registros e cada um se achata em caminhos de folha: {"customer":{"name":"Ada"}} produz uma coluna chamada customer.name, e um array tags vira tags[0], tags[1] e assim por diante. As duas notações são distinguíveis de propósito — só com pontos, a.0 não consegue dizer se a era um array ou um objeto com uma chave chamada 0 —, e é isso que torna a ida e volta pelo CSV até o JSON reversível.

Duas decisões a mais importam numa planilha. Arrays de escalares podem ser unidos numa única célula (priority, gift) em vez de explodidos em colunas — mais fácil de ler, mas com perdas, então vale só para escalares; um array de objetos é sempre explodido, porque uni-lo o destruiria. E null vira uma célula vazia, e não o texto null, que uma planilha trataria como string. As aspas seguem a RFC 4180: os campos são colocados entre aspas só quando contêm o delimitador, uma aspa ou uma quebra de linha, e aspas dentro de campos são dobradas.

A peculiaridade do BOM UTF-8 no Excel mais antigo

Um CSV baixado desta ferramenta é UTF-8 sem marca de ordem de bytes (BOM) — o padrão moderno, e correto para todo programa que lê codificações direito. O Excel mais antigo (2016 e anteriores, em particular) não: sem BOM presente, ele assume ANSI, uma página de código legada do Windows, e todo caractere acima de 127 se corrompe — é vira é, Curaçao vira Curaçao, nomes e endereços viram sopa. O arquivo está certo; a suposição, não.

A correção é o caminho de importação: Dados → De Texto/CSV (Dados → De Texto nas versões mais antigas), escolha o arquivo e defina a codificação como 65001: Unicode (UTF-8) na caixa de diálogo. Versões modernas do Microsoft 365 costumam detectar UTF-8 sozinhas, mas a caixa de diálogo é o caminho confiável em qualquer versão — e a mesma caixa sobrepõe o delimitador, o que resolve a próxima peculiaridade no mesmo passo. Colar o texto CSV bruto numa planilha faz tudo cair numa coluna só até o Texto para Colunas dividir, então o caminho de importação também é o mais rápido para qualquer coisa com mais de uns poucos campos.

Qual delimitador escolher

Vírgula, a menos que você tenha um motivo — mas motivos são comuns, porque o delimitador e o locale estão entrelaçados. Em boa parte da Europa e da América do Sul a vírgula é o separador decimal, e o Excel de lá lista o ponto e vírgula como seu separador de lista: um arquivo delimitado por vírgulas abre como uma coluna gigante, enquanto um arquivo com ponto e vírgula abre limpo. A tabela de decisão:

As heurísticas de importação do Excel: datas, zeros e números longos

Mesmo um CSV perfeitamente formado pode ser mutilado pelo Excel depois de aberto — pelo importador, não pelo arquivo. Valores que lembram datas (2-2024, 3/4) são convertidos em datas de verdade; códigos de produto e CEPs com zeros à esquerda os perdem (007 vira 7); IDs numéricos longos migram para notação científica e seus dígitos finais se vão para sempre. No duplo clique, essas reinterpretações são num só sentido.

A defesa é a mesma caixa de diálogo: Dados → De Texto/CSV permite definir as colunas como Texto antes que qualquer coisa seja importada, então cada valor chega como foi escrito. Para dados colados, formate a coluna de destino como Texto antes. Vale insistir nisso porque o dano é silencioso — uma coluna de CEPs em números parece correta até alguém notar os zeros à esquerda faltando, e a essa altura o CSV original já era.

Limites práticos, ditos sem rodeios

O conversor interpreta JSON de forma estrita, então uma vírgula sobrando ou uma aspa tipográfica é reportada com linha e coluna em vez de tolerada em silêncio. A entrada é limitada a 8 MB porque a conversão roda na thread principal — além disso, ela recusa em vez de congelar a aba. E o próprio CSV tem arestas que nenhum conversor remove: uma célula não distingue a string 22201 do número 22201, nem uma célula vazia de um campo ausente, então a página de ida e volta documenta essas duas ressalvas em vez de prometer ausência de perdas.