IA en tu dispositivo: profesional y privado.

Documentos

Cómo comparar dos archivos JSON (y por qué una comparación de texto te engaña)

Compara dos archivos JSON y ve qué claves se añadieron, quitaron o cambiaron. Por qué el diff de texto es ruidoso, cómo se emparejan los arrays y qué ignorar.

Actualizado el 7 de noviembre de 20269 min de lectura

Para comparar dos archivos JSON, abre el comparador Diff JSON, suelta un archivo en cada lado (o pega el texto) y lee la lista de diferencias. Cada una aparece como añadida, eliminada, modificada o con tipo cambiado, con la ruta exacta del valor. Compara los datos, no el texto, así que las claves reordenadas y las sangrías distintas no aparecen como cambios. Esa es toda la razón para usarlo en lugar de una comparación de texto normal.

Por qué un diff de texto de JSON hace tanto ruido

Una comparación de texto trabaja línea por línea. A JSON no le importan las líneas. Estos dos documentos contienen exactamente los mismos datos, pero un diff de texto marca todas las líneas como distintas: uno está escrito en una sola línea, el otro tiene sangría de cuatro espacios y las claves aparecen en otro orden.

Qué es distintoEl diff de texto diceLos datos dicen
Sangría (2 espacios, 4 o un tabulador)Todas las líneas cambiaronNo cambió nada
Archivo entero minificado en una líneaUna línea sustituida por otraNo cambió nada
Claves en otro ordenLíneas movidas o reescritasNo cambió nada: los objetos no tienen orden
1 escrito como 1.0Línea modificadaEs el mismo número
Un precio que pasa de 9,99 a 10,99Una línea modificadaUn valor modificado

La última fila es la que te importa, y en un diff de texto queda enterrada bajo las cuatro primeras. Muchas API devuelven las claves en un orden distinto en cada llamada, y muchas herramientas reescriben la sangría al guardar un archivo, así que el ruido es lo normal, no la excepción.

Comparar dos archivos JSON, paso a paso

1

Añade el documento de la izquierda

Abre el comparador Diff JSON. Pega el original en el cuadro Izquierda (original) o suelta un archivo .json en la zona de carga. La herramienta también abre archivos .jsonc, .geojson, .map y .txt.

2

Añade el documento de la derecha

Pega o suelta la versión modificada en Derecha (modificado). Si sueltas los dos archivos a la vez, se emparejan por nombre, así que billing.before.json y billing.after.json van a su lado correcto. Usa Intercambiar lados si quedaron al revés.

3

Lee las diferencias

La comparación se ejecuta mientras escribes. Elige En paralelo, En línea o Por ruta. El resumen indica cuántas se añadieron, eliminaron y modificaron, y los botones Siguiente cambio y Anterior saltan de una a otra. Usa el filtro para ver solo las añadidas, eliminadas, modificadas o los cambios de tipo.

4

Ajusta qué cuenta como diferencia

Abre los ajustes de comparación para ignorar el orden de los arrays, las mayúsculas o los espacios, fijar una tolerancia numérica u omitir las claves que siempre cambian. Las secciones siguientes explican cada opción.

5

Exporta si necesitas un registro

Copiar resumen pone en el portapapeles una lista sencilla de cambios. Descargar parche JSON da un archivo estándar que convierte el documento de la izquierda en el de la derecha. Descargar Markdown da un informe que puedes pegar en una incidencia o en una pull request.

Compara dos documentos y ve cada valor añadido, eliminado y modificado por ruta. Gratis: un par cada vez, hasta 10 MB por lado, con todas las opciones y exportaciones incluidas. Funciona en tu dispositivo, no en nuestros servidores.

Comparar dos archivos JSON

Qué te dice el informe: añadido, eliminado, modificado

La herramienta recorre los dos documentos a la vez e informa de cada diferencia con su ubicación. Los objetos se comparan clave por clave, a cualquier profundidad. Una clave que solo existe a la derecha está añadida. Una que solo existe a la izquierda está eliminada. Una clave presente en ambos lados con otro valor está modificada. Un valor cuyo tipo cambió, como el texto "3" que pasa a ser el número 3, se indica aparte como tipo cambiado, porque es el cambio que más probablemente rompa lo que lea el archivo después.

Las ubicaciones se escriben como rutas. En Por ruta ves dónde está cada cambio, por ejemplo el nombre del segundo elemento de una lista de usuarios. El parche exportado usa la forma estándar JSON Pointer (/users/1/name), que no es ambigua ni siquiera cuando una clave contiene un punto o una barra.

  • Los números se comparan por valor, así que 1, 1.0 y 1e0 son el mismo número y no se señalan.
  • Reordenar las claves de un objeto nunca es un cambio.
  • El nivel superior puede ser cualquier cosa que admita JSON: un objeto, un array o incluso una sola cadena o un número.
  • Si un documento declara la misma clave dos veces, la herramienta te avisa, porque los analizadores conservan en silencio solo el último valor y una diferencia en el anterior resulta invisible.

Cómo se comparan los arrays

Los arrays son donde fallan las comparaciones de JSON. Si dos listas se comparan estrictamente posición por posición, añadir un elemento al principio hace que todos los siguientes parezcan distintos. La herramienta lo evita alineando antes los elementos, y muestra junto al resumen qué estrategia usó.

EstrategiaCuándo se usaSirve para
Por idIndicas un campo en Emparejar elementos por campo y todos los elementos tienen un valor único en élRegistros de una API que llegaron en otro orden
Por subsecuencia común más largaEs la opción por defectoListas donde se insertaron o quitaron elementos
Como conjuntoIgnorar orden de arrays está activadaEtiquetas, permisos, todo lo que no depende del orden
Por posiciónLas dos listas casi no tienen nada en comúnListas que de verdad se reemplazaron

Emparejar por id es lo que conviene usar con listas de registros. Escribe el nombre del campo (id es el habitual) y una lista reordenada se muestra como reordenada, con solo el registro que de verdad cambió. La herramienta usa el campo únicamente si todos los elementos lo tienen y ningún valor se repite. Si no fuera así, produciría un emparejamiento ordenado pero erróneo, de modo que vuelve a la opción por defecto en lugar de adivinar.

Ignora el ruido: claves, rutas, mayúsculas y números

La comparación estricta es la opción por defecto: cada valor, tipo y posición en un array debe coincidir. Cada ajuste relaja exactamente una cosa, y el informe exportado registra cuáles estaban activados.

  • Claves que ignorar: escribe nombres como updatedAt o requestId, separados por comas. Se omiten donde aparezcan, a cualquier profundidad. Así dos capturas de una API se convierten en un diff legible.
  • Rutas que ignorar: omite una ubicación concreta, con * para un nivel y ** para cualquier número de niveles. /users/*/lastSeen omite ese campo en todos los usuarios.
  • Ignorar mayúsculas e Ignorar espacios: para etiquetas que cambiaron de estilo o descripciones que se volvieron a ajustar de línea.
  • Tolerancia numérica: cuánto pueden diferir dos números para contar como iguales. Con una tolerancia de 0,0001 desaparece el ruido de redondeo de decimales, pero un cambio real de precio sigue apareciendo.
  • Permitir comentarios y comas finales: para archivos de configuración escritos como JSONC.

Usos habituales: cambios de una API y deriva de configuración

Si una API cambió, guarda la respuesta de antes y de después, añade los campos que siempre cambian (marcas de tiempo, ids de petición, etags) a las claves ignoradas, y lo que quede es el cambio real de estructura. Para la deriva de configuración entre dos entornos, como preproducción y producción, carga ambos archivos y mira Por ruta: lista exactamente qué ajustes difieren y nada más. En una migración o exportación, compara el archivo antiguo y el nuevo y descarga el informe en Markdown como registro de lo que se movió.

Si prefieres seguir con un diff de texto normal, por ejemplo dentro de una herramienta de revisión de código, primero haz que los dos archivos se vean igual: pasa cada uno por el formateador de JSON con la misma sangría y pon las claves en un solo orden con ordenar claves JSON. Ordenar claves solo mueve las claves, y los valores no se tocan. Eso elimina casi todo el ruido de texto, pero no puede hacer lo que hace el comparador con los arrays, las tolerancias o los campos ignorados.

Límites y qué puede salir mal

  • Tamaño: Gratis compara un par cada vez, hasta 10 MB por lado. Pro eleva el tamaño a lo que aguante tu dispositivo y compara hasta 50 pares a la vez, emparejados por nombre de archivo, con todos los informes y parches en un ZIP. Un archivo que supera el límite gratuito se rechaza indicando su tamaño real y con un enlace al minificador, porque el JSON con formato suele ser sobre todo sangría.
  • Otros formatos: los archivos YAML, XML, CSV y Excel se rechazan en la entrada con un enlace al conversor adecuado, como YAML a JSON. Convierte primero y compara después.
  • "Sin diferencias" parece raro: comprueba si lo explica un ajuste de ignorar, una tolerancia numérica alta o un aviso de clave duplicada.
  • Demasiadas diferencias: por encima de 100.000 la lista deja de crecer, pero los totales siguen siendo exactos, y la página indica que la lista se truncó.
  • Una lista muy grande en dos órdenes distintos: indica un campo id o activa Ignorar orden de arrays, en vez de leer miles de movimientos.

La comparación se ejecuta en tu dispositivo, no en nuestros servidores, así que las credenciales y los datos de clientes de una respuesta no se suben para compararlos. Para un resumen de en qué se diferencia JSON de otros formatos de datos, consulta JSON vs CSV vs XML.

Preguntas frecuentes

¿Cómo comparo dos archivos JSON online?

Abre el comparador Diff JSON, suelta un archivo en cada lado o pega el texto, y lee la lista de valores añadidos, eliminados y modificados. Compara mientras escribes. La versión gratuita cubre un par de hasta 10 MB por lado.

¿Importa que las claves estén en otro orden?

No. Los objetos no tienen orden, así que un objeto reordenado se compara como idéntico. Solo los arrays tienen orden, y puedes activar Ignorar orden de arrays si tampoco te importa.

¿Cómo comparo dos arrays JSON cuando los elementos cambiaron de sitio?

Escribe el nombre de un campo único, normalmente id, en Emparejar elementos por campo. Los elementos se alinean entonces por ese valor y no por posición, así que una lista reordenada solo muestra los registros que de verdad cambiaron. O activa Ignorar orden de arrays.

¿Puedo ignorar campos como las marcas de tiempo?

Sí. Escribe los nombres de clave en Claves que ignorar, por ejemplo updatedAt, requestId. Se omiten a cualquier profundidad. Para omitir solo una ubicación, usa Rutas que ignorar, que admite los comodines * y **.

¿Puedo comparar JSON con comentarios, como un archivo de configuración?

Sí. Activa Permitir comentarios y comas finales, o suelta un archivo .jsonc, que lo activa por ti. YAML y XML no se abren directamente: conviértelos antes a JSON.

¿Puedo guardar las diferencias?

Sí, de tres formas, todas en el plan gratuito: copiar un resumen sencillo, descargar un parche JSON RFC 6902 o descargar un informe en Markdown. Pro añade lotes de hasta 50 pares en un ZIP.

Sigue leyendo

Más sobre Documentos →