← Voltar à ferramenta JSON

Comparar JSON

Última atualização: 2 de outubro de 2026

Compare dois documentos JSON e veja apenas o que realmente difere. Como a comparação é estrutural, reordenar chaves ou reformatar não conta; o relatório lista cada mudança real com seu caminho, dentro do navegador.

O que uma comparação estrutural vê

Os dois documentos são analisados primeiro e depois percorridos juntos. Só as diferenças nos próprios dados são reportadas: uma chave presente de um lado e ausente do outro, um valor que mudou, ou um valor cujo tipo mudou —um número que virou string, um objeto que virou array—. Espaços e ordem das chaves não participam da comparação, porque depois da análise eles deixam de existir.

Uma mudança de tipo é reportada uma vez, no caminho onde ocorre, em vez de ser desdobrada em uma remoção e uma adição para cada folha abaixo. Isso mantém o relatório legível quando uma subárvore inteira muda de forma.

Por que isto não é um diff de linhas

Um diff de texto —o que o git diff mostra— compara linhas. Para JSON isso costuma enganar. Reindentar um arquivo, ou emitir as mesmas chaves em outra ordem, é normal quando o JSON é gerado por ferramentas diferentes ou versões diferentes de uma biblioteca, e um diff de linhas transforma isso em uma parede de mudanças embora os dados sejam idênticos.

Os dois documentos abaixo são o mesmo documento. Um diff de linhas reporta quatro linhas alteradas; esta ferramenta não reporta nada:

{"a": 1, "b": 2}

{
  "b": 2,
  "a": 1
}

O contrário também vale, e é a parte útil: um único caractere alterado dentro do nome de uma chave, ou um número que passou de 3 para 4, aparece como exatamente uma mudança em vez de ficar enterrado no ruído da reformatação.

Como ler a notação de caminhos

Cada mudança é reportada com um caminho. $ é a raiz do documento; um ponto entra em uma chave de objeto e um colchete indexa um array. Assim, $.settings.indent é a chave indent dentro de settings, $.features[2] é o terceiro item do array features, e $["weird key"] nomeia uma chave que não é um identificador simples. A notação segue o estilo do JSON Pointer, então um caminho do relatório pode ser colado em outras ferramentas JSON.

O que a comparação não consegue dizer

• Arrays são emparelhados por posição. Inserir um item no início de um array longo desloca cada elemento seguinte, então todos são reportados como alterados embora os valores apenas tenham se movido. É uma limitação real de qualquer comparação sem uma chave para emparelhar. Se seus itens tiverem um id estável, ordene os dois lados por ele primeiro, ou compare uma versão indexada por ele.
• Não é um patch. Isto reporta diferenças; não emite um documento JSON Patch (RFC 6902) nem detecta blocos movidos. Um valor movido aparece como remoção no caminho antigo e adição no novo.
• Os valores são comparados exatamente. 1 e 1.0 são o mesmo número para o analisador, mas 1 e "1" são diferentes, e uma chave ausente é diferente de uma chave definida explicitamente como null.

Perguntas frequentes