IA no seu dispositivo — profissional e privado.

Documentos

Como formatar JSON online (e corrigir os erros que o quebram)

Cole um JSON bagunçado e receba um JSON legível e indentado. Corrija vírgulas finais, aspas simples, chaves sem aspas e comentários; escolha o recuo.

Atualizado em 1 de novembro de 20268 min de leitura

Para formatar JSON, cole-o no formatador de JSON, escolha um recuo de 2 espaços, 4 espaços ou tabulação e clique em Formatar JSON. Uma única linha ilegível vira um esboço indentado que se lê sem esforço, e, se o JSON estiver quebrado, você recebe a linha e a coluna do problema em vez de uma falha vaga. A mesma página minifica, ordena chaves e repara os erros mais comuns. Este guia explica o que a formatação muda e o que não muda, como corrigir cada erro de sintaxe frequente, qual recuo escolher e o que esperar de arquivos grandes.

Formatar, validar ou minificar?

Você quer…UseO que você obtém
Ler ou editar um documento bagunçado ou de uma linha sóFormatador no modo FormatarJSON indentado, com quebras de linha
Saber se um arquivo é válido e onde não éValidadorUma lista de erros com linha, coluna e um marcador
Reduzir o JSON antes de enviar ou guardarMinificador ou Minificar no formatadorUma linha compacta, os mesmos dados
Tornar duas exportações comparáveisOrdenar chavesA mesma ordem de chaves sempre

As três tarefas seguem uma regra: os dados continuam exatamente os mesmos e só o espaço em branco ao redor muda. Formatar adiciona quebras de linha e recuo, minificar os remove, e validar lê o documento sem alterá-lo.

Formatando JSON, passo a passo

1

Cole ou adicione o JSON

Abra o formatador de JSON. Solte um arquivo .json, .jsonc, .ndjson, .jsonl ou .txt na página, escolha um com Procurar arquivos ou abra o painel de colar e cole direto da área de transferência.

2

Escolha Formatar e um recuo

Em Saída, escolha Formatar para obter JSON legível. Em Recuo, escolha 2 espaços, 4 espaços ou Tabulação. Tudo neste painel é grátis.

3

Leia o resultado

A visualização Texto mostra a saída destacada. Árvore permite recolher ramos e copiar o caminho de qualquer valor, e Dados informa a profundidade e a contagem de objetos, listas, textos e números.

4

Corrija os erros, se houver

Um documento quebrado mostra uma mensagem, uma linha, uma coluna e a linha com defeito com um marcador sob o caractere. Se for um problema que a ferramenta sabe reparar, marque Reparar JSON inválido e ela lista cada alteração feita.

5

Copie ou baixe

Clique em Copiar para a área de transferência ou em Baixar para um arquivo. Nada é enviado a um servidor; tudo roda no seu aparelho.

Indente, minifique, ordene chaves e repare JSON quebrado, com todas as opções de formatação incluídas. Grátis: um arquivo de até 25 MB. Pro: até 20 arquivos de uma vez, baixados em um único ZIP. Tudo roda no seu aparelho, não nos nossos servidores.

Formatar JSON

Os erros de sintaxe que quebram o JSON e como corrigir cada um

O JSON é mais rígido do que o JavaScript com que se parece. A maioria das falhas vem de hábitos trazidos do código, de arquivos de configuração ou da saída do Python. Aqui estão, aproximadamente por ordem de frequência.

ErroExemploCorreção
Vírgula final{"a": 1,}Apague a vírgula antes da chave ou do colchete de fechamento
Aspas simples{'a': 'b'}Use aspas duplas para chaves e textos
Chaves sem aspas{a: 1}Coloque cada chave entre aspas duplas: {"a": 1}
Comentários// nota ou /* nota */Remova-os; o JSON não tem sintaxe de comentário
Valores de Python ou JavaScriptTrue, False, None, NaN, undefinedUse true, false e null; o JSON não tem NaN
Quebra de linha real dentro de um textoUma quebra de linha de verdade entre aspasEscreva como \n dentro do texto
Vírgula faltando{"a": 1 "b": 2}Adicione uma vírgula entre os membros

Para os cinco primeiros, não é preciso editar à mão. Marque Reparar JSON inválido e clique em Reparar e formatar. O reparo vem desligado porque é uma decisão sobre os seus dados: quando está ligado, a visualização Dados lista cada alteração, por exemplo quantas vírgulas finais foram removidas ou quantos textos passaram de aspas simples para duplas, para que você confirme que concorda antes de baixar. Ele não mexe no interior dos seus textos, então uma vírgula ou uma aspa dentro de um valor entre aspas nunca é confundida com estrutura.

Se preferir ver todos os problemas antes de mudar qualquer coisa, o validador de JSON continua depois da primeira falha e relata cada uma com linha e coluna. Um analisador comum para na primeira, então um arquivo com quarenta erros exige quarenta rodadas de correção.

Escolhendo o recuo

O recuo muda apenas o espaço em branco, nunca os dados, então a escolha depende de quem vai ler o arquivo. Minificar não tem recuo nenhum, por isso o controle Recuo fica desativado enquanto Minificar está selecionado.

RecuoMelhor paraContrapartida
2 espaçosProjetos web, arquivos de configuração, a maior parte da documentação de APIsCompacto; dados muito aninhados ainda podem ser difíceis de acompanhar
4 espaçosLer dados muito aninhados, material didáticoLinhas mais largas; mais rolagem horizontal
TabulaçãoEquipes cujo guia de estilo usa tabulaçãoA largura depende do visualizador, então aparece diferente em cada editor
MinificarEnviar, guardar ou incorporarO menor tamanho; ilegível sem um formatador

Se o arquivo mora em um repositório, siga o que o resto do projeto usa para que uma reformatação não transforme cada linha em uma alteração. Em Fim de linha, escolha LF para controle de versão e CRLF apenas para arquivos que serão abertos no Bloco de Notas do Windows.

Ordenar chaves, duplicatas e números longos

Muitos formatadores online leem o seu JSON como valores de programa e o escrevem de volta. Essa ida e volta pode alterar os dados sem aviso: um inteiro maior que 9.007.199.254.740.991 é arredondado, de modo que um ID como 12345678901234567890 volta como outro número, e uma chave repetida guarda só o último valor. Este formatador copia cada número, texto e chave do seu texto original caractere por caractere e muda apenas o espaçamento; assim, IDs longos, zeros finais e a ordem das chaves são preservados. A visualização Dados até informa quantos números teriam perdido precisão em um formatador comum.

Ordenar chaves oferece Não, A → Z, Z → A e Natural. A ordem natural trata sequências de dígitos como números, então item2 vem antes de item10. A ordenação é recursiva pelos objetos aninhados, e as listas sempre mantêm a ordem, porque a ordem de uma lista é informação. Ordene antes de comparar duas exportações e as diferenças que você vir serão mudanças reais de valor. Para uma comparação lado a lado, use a comparação de JSON. Chaves duplicadas vem em Manter ambas, a única opção que não apaga nada; Manter a primeira e Manter a última servem para resolvê-las de propósito.

Arquivos grandes

O plano grátis aceita um arquivo de até 25 MB, o que cobre quase toda resposta de API, arquivo de configuração e exportação. A formatação roda em segundo plano para que a página continue respondendo, e em documentos muito grandes a prévia mostra a primeira parte enquanto o download contém tudo. A saída indentada é maior que a entrada, porque cada nível acrescenta espaços. Formatar uma carga de API com 2 espaços pode deixá-la quase o dobro do tamanho, então um arquivo de 20 MB pode gerar um resultado bem acima de 30 MB.

Se um documento é muito aninhado, o recuo pode crescer rapidamente, e a ferramenta avisará que o resultado indentado seria grande demais para ser gerado. Nesse caso, escolha Minificar. Quando você só precisa achar algo numa resposta enorme, a visualização Árvore recolhe os ramos para caber em uma tela, e o visualizador de JSON foi feito para explorar documentos grandes. O Pro eleva o limite por arquivo ao que o seu aparelho aguentar e permite até 20 arquivos de uma vez.

Arquivos com um registro por linha

Logs e exportações de bancos de dados costumam ser JSON Lines, também chamado de NDJSON: um valor JSON completo por linha, sem lista envolvente e sem vírgulas entre os registros. Um formatador comum o considera inválido porque há conteúdo depois do primeiro registro. Este o detecta. Por padrão, cada registro permanece minificado na própria linha para que o arquivo continue sendo JSON Lines válido. Se você precisa de um único documento, mude JSON Lines para Array único e os registros são reunidos em uma lista indentada com o recuo escolhido.

Checklist quando o JSON não é lido

  1. 1Leia a linha e a coluna do erro e olhe também o caractere anterior; muitos erros são apontados onde o analisador os notou, não onde você os cometeu.
  2. 2Confira as aspas: cada chave e cada texto precisa de aspas duplas retas, não simples nem tipográficas.
  3. 3Procure uma vírgula no fim do último item de um objeto ou lista e uma vírgula faltando entre dois itens.
  4. 4Procure comentários, True, False, None, NaN e undefined e troque por JSON válido.
  5. 5Verifique se cada chave ou colchete de abertura tem o seu par e se o documento é um único valor, não dois colados.
  6. 6Se o JSON veio dentro de um texto com barra invertida antes de cada aspa, ele foi escapado; use primeiro a ferramenta de escape de JSON para desfazer isso.

Perguntas frequentes

Como formato JSON online de graça?

Cole o JSON no formatador ou solte um arquivo, escolha Formatar e um recuo de 2 espaços, 4 espaços ou tabulação e clique em Formatar JSON. Todas as opções de formatação são grátis em arquivos de até 25 MB, e você pode copiar ou baixar o resultado.

Como corrijo um JSON inválido?

Leia a linha e a coluna na mensagem de erro. As causas habituais são vírgulas finais, aspas simples, chaves sem aspas, comentários e valores de Python como True ou None. Marque Reparar JSON inválido para corrigi-los automaticamente; a ferramenta lista cada alteração para você conferir.

Qual a diferença entre formatar e validar JSON?

Formatar reescreve o espaço em branco para o documento ficar fácil de ler. Validar apenas verifica se o documento é válido e relata cada erro com a sua posição. O formatador também mostra um erro de sintaxe quando não consegue ler o arquivo; o validador é melhor quando você quer a lista completa de falhas.

Formatar altera os meus dados?

Não. Só mudam espaços, tabulações e quebras de linha. Números, textos e a ordem das chaves são copiados exatamente do seu texto, inclusive inteiros muito longos e números como 1.10, que não são arredondados nem reescritos.

Devo usar 2 espaços, 4 espaços ou tabulação?

Use o que o resto do seu projeto usa. Dois espaços são comuns em projetos web e mantêm as linhas curtas, quatro espaços leem melhor em dados muito aninhados, e a tabulação serve a equipes que a preferem. A escolha nunca afeta os dados.

Posso formatar um arquivo JSON muito grande?

Sim. O plano grátis aceita um arquivo de até 25 MB. O Pro eleva o limite por arquivo ao que o seu aparelho aguentar e formata até 20 arquivos de uma vez em um ZIP. Se o recuo deixasse o resultado grande demais, use Minificar.

Continue lendo

Mais sobre Documentos →