← Volver a la herramienta JSON

Comparar JSON

Última actualización: 2 de octubre de 2026

Compara dos documentos JSON y ve solo lo que realmente difiere. Como la comparación es estructural, reordenar claves o cambiar el formato no cuenta; el informe lista cada cambio real con su ruta, dentro de tu navegador.

Qué ve una comparación estructural

Los dos documentos se analizan primero y luego se recorren juntos. Solo se reportan las diferencias en los datos: una clave presente en un lado y no en el otro, un valor que cambió, o un valor cuyo tipo cambió —un número que pasó a ser cadena, un objeto que pasó a ser array—. Los espacios y el orden de las claves no forman parte de la comparación, porque después de analizar ya no existen.

Un cambio de tipo se reporta una vez, en la ruta donde ocurre, en lugar de desglosarse en una eliminación y una adición por cada hoja que hay debajo. Eso mantiene legible el informe cuando cambia de forma un subárbol entero.

Por qué esto no es un diff de líneas

Un diff de texto —lo que muestra git diff— compara líneas. Para JSON eso suele engañar. Reindentar un archivo, o emitir las mismas claves en otro orden, es normal cuando el JSON lo generan herramientas distintas o versiones distintas de una biblioteca, y un diff de líneas lo convierte en un muro de cambios aunque los datos sean idénticos.

Los dos documentos de abajo son el mismo. Un diff de líneas reporta cuatro líneas cambiadas; esta herramienta no reporta nada:

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

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

Lo contrario también se cumple, y es la parte útil: un solo carácter cambiado dentro del nombre de una clave, o un número que pasó de 3 a 4, aparece como exactamente un cambio en vez de quedar enterrado en el ruido del reformateo.

Cómo leer la notación de rutas

Cada cambio se reporta con una ruta. $ es la raíz del documento; un punto entra en una clave de objeto y un corchete indexa un array. Así, $.settings.indent es la clave indent dentro de settings, $.features[2] es el tercer elemento del array features, y $["weird key"] nombra una clave que no es un identificador simple. La notación sigue el estilo de JSON Pointer, así que una ruta del informe se puede pegar en otras herramientas JSON.

Lo que la comparación no puede decirte

• Los arrays se emparejan por posición. Insertar un elemento al principio de un array largo desplaza cada elemento posterior, así que todos se reportan como modificados aunque los valores solo se movieran. Es una limitación real de cualquier comparación sin una clave con la que emparejar. Si tus elementos llevan un id estable, ordena ambos lados por él primero, o compara una versión indexada por él.
• No es un parche. Esto reporta diferencias; no emite un documento JSON Patch (RFC 6902) ni detecta bloques movidos. Un valor movido aparece como una eliminación en la ruta antigua y una adición en la nueva.
• Los valores se comparan exactamente. 1 y 1.0 son el mismo número para el analizador, pero 1 y "1" son distintos, y una clave ausente es distinta de una clave puesta a null explícitamente.

Preguntas frecuentes