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… | Use | O que você obtém |
|---|---|---|
| Ler ou editar um documento bagunçado ou de uma linha só | Formatador no modo Formatar | JSON indentado, com quebras de linha |
| Saber se um arquivo é válido e onde não é | Validador | Uma lista de erros com linha, coluna e um marcador |
| Reduzir o JSON antes de enviar ou guardar | Minificador ou Minificar no formatador | Uma linha compacta, os mesmos dados |
| Tornar duas exportações comparáveis | Ordenar chaves | A 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
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.
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.
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.
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.
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 JSONOs 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.
| Erro | Exemplo | Correçã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 JavaScript | True, False, None, NaN, undefined | Use true, false e null; o JSON não tem NaN |
| Quebra de linha real dentro de um texto | Uma quebra de linha de verdade entre aspas | Escreva 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.
| Recuo | Melhor para | Contrapartida |
|---|---|---|
| 2 espaços | Projetos web, arquivos de configuração, a maior parte da documentação de APIs | Compacto; dados muito aninhados ainda podem ser difíceis de acompanhar |
| 4 espaços | Ler dados muito aninhados, material didático | Linhas mais largas; mais rolagem horizontal |
| Tabulação | Equipes cujo guia de estilo usa tabulação | A largura depende do visualizador, então aparece diferente em cada editor |
| Minificar | Enviar, guardar ou incorporar | O 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
- 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.
- 2Confira as aspas: cada chave e cada texto precisa de aspas duplas retas, não simples nem tipográficas.
- 3Procure uma vírgula no fim do último item de um objeto ou lista e uma vírgula faltando entre dois itens.
- 4Procure comentários, True, False, None, NaN e undefined e troque por JSON válido.
- 5Verifique se cada chave ou colchete de abertura tem o seu par e se o documento é um único valor, não dois colados.
- 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.