Como abrir um arquivo JSON

A resposta curta

Arquivos JSON (JavaScript Object Notation) guardam dados em forma de texto: chaves e valores entre chaves, listas entre colchetes. Não há nada binário nem proprietário neles, então você nunca precisa de um programa especial só para ver o que tem dentro. Clique com o botão direito no arquivo, escolha Abrir com e selecione um editor de texto ou um navegador.

O problema é a leitura. Arquivos exportados por aplicativos e APIs costumam vir numa única linha enorme, o que serve para programas mas não para pessoas. Solte o arquivo no visualizador abaixo (ou aperte Abrir arquivo) e ele aparece como uma árvore que você abre e fecha, com a contagem de itens em cada lista e objeto. Mude Ferramenta para Formatador se preferir texto indentado.

De onde vêm os arquivos JSON

Em geral você encontra um arquivo .json numa destas situações: uma exportação de dados de um site ou aplicativo (Google Takeout, downloads do Facebook e do Instagram, apps de banco e de exercícios), uma resposta de API salva, o arquivo de configurações de um programa ou jogo, um feed de produtos de uma loja virtual ou um backup feito por uma extensão do navegador.

Isso importa porque o objetivo muda. Num arquivo de configurações você quer editar um valor e salvar sem quebrar a sintaxe. Numa exportação você quer achar um campo entre milhares de linhas ou transformar os dados em planilha. Os métodos abaixo cobrem as três coisas: ler, editar e converter.

Formas de abrir um arquivo JSON, comparadas

Passo a passo em cada aparelho

• Windows: clique com o botão direito no arquivo, escolha Abrir com e depois Bloco de Notas. Para deixar como padrão, escolha Escolher outro aplicativo e marque Sempre usar este aplicativo para abrir arquivos .json. Para uma visão formatada, arraste o arquivo para uma janela do Firefox ou para o visualizador desta página.
• Mac: clique com o botão direito (ou Control e clique) no arquivo, escolha Abrir com e depois TextEdit. Apertar a barra de espaço no Finder mostra uma pré-visualização rápida do texto sem abrir nenhum app.
• iPhone e iPad: no app Arquivos, toque no arquivo para ver o texto. Para navegar como árvore, abra esta página no Safari, toque em Abrir arquivo e escolha o arquivo em Arquivos.
• Android: a maioria dos gerenciadores de arquivos oferece abrir o .json num leitor de texto ou no navegador. Abra esta página no Chrome e use Abrir arquivo para ter uma visão formatada e recolhível.
• Linha de comando: python -m json.tool arquivo.json imprime uma cópia formatada, e jq . arquivo.json faz o mesmo com cores, se o jq estiver instalado.

Ler um arquivo JSON grande com conforto

Exportações grandes podem ter dezenas de milhares de linhas. No visualizador, tudo abaixo dos dois primeiros níveis começa recolhido, então você vê primeiro a forma geral: um objeto com cinco chaves, um array com 2.481 itens. Abra só o ramo de que precisa. Expandir tudo e Recolher tudo, acima da entrada, abrem ou fecham o documento inteiro; documentos muito grandes são expandidos até um limite seguro para a página continuar respondendo.

Passe o mouse sobre qualquer nó para ver o caminho dele, por exemplo $.orders[3].customer.name. Esse caminho é exatamente o que você precisa ao escrever código ou uma fórmula de planilha que leia o mesmo campo, e evita contar colchetes na mão.

Arquivos de vários megabytes abrem sem problema. Acima disso, o limite é a memória do seu aparelho, não a ferramenta, e as cores são desligadas em resultados muito grandes para a rolagem continuar suave.

Editar um arquivo JSON sem quebrar

O JSON é rígido, e um único caractere errado deixa o arquivo inteiro ilegível para o programa que o usa. Se for editar um arquivo de configurações, guarde uma cópia antes e confira o resultado antes de salvar.

• Chaves e valores de texto precisam de aspas duplas. Aspas simples não são permitidas.
• Nada de vírgula depois do último item de um objeto ou array.
• Nada de comentários. Linhas começando com // ou blocos entre /* e */ são inválidos no JSON padrão.
• true, false e null são escritos em minúsculas e sem aspas.
• Salve como texto puro em UTF-8. Processadores de texto como o Word acrescentam formatação e não devem ser usados.

Quando o arquivo não abre ou aparece estranho

Se o visualizador disser Isto não é um JSON válido, a caixa de erro mostra a linha e a coluna onde o problema começa, junto com as linhas ao redor. As causas mais comuns são as da lista acima: uma vírgula faltando ou sobrando, aspas simples ou um comentário. Depois de corrigir, mude Ferramenta para Validador para conferir o arquivo; um arquivo válido recebe um resumo como 120 chaves, 15 objetos, 3 arrays, 4 níveis de profundidade.

Alguns arquivos com nome .json na verdade são JSON Lines (um objeto JSON completo por linha, muitas vezes .jsonl ou .ndjson). Eles não formam um documento único válido; abra uma linha por vez, ou coloque as linhas entre colchetes e separe com vírgulas.

Letras embaralhadas como é no lugar de é significam que o arquivo foi aberto com a codificação errada, algo bem comum com textos em português. O JSON deveria estar em UTF-8; abra num editor que permita escolher UTF-8, ou use o visualizador, que lê o arquivo como UTF-8.

Transformar JSON em planilha

Quando o arquivo é uma lista de registros (pedidos, contatos, produtos), uma tabela é mais prática do que uma árvore. Mude Ferramenta para JSON para CSV: cada item vira uma linha, cada chave uma coluna, e objetos aninhados como um endereço são achatados em colunas como address.city. A prévia mostra as primeiras 100 linhas, e o CSV baixado abre no Excel com os acentos certinhos.

O Excel também importa JSON diretamente em Dados, Obter Dados, De Arquivo, De JSON, que abre o editor do Power Query. É poderoso, mas exige vários cliques para expandir registros aninhados e está disponível principalmente nas versões para Windows.