Cómo combinar archivos JSON en línea (y qué pasa cuando las claves chocan)
Une varios archivos JSON en uno: fusión profunda o superficial, cuatro formas de combinar arrays y un informe de cada valor sobrescrito. Gratis hasta 5 archivos.
Actualizado el 8 de noviembre de 20269 min de lectura
Para combinar archivos JSON, añádelos al fusionador de JSON en el orden en que quieres aplicarlos, elige Fusión profunda o Fusión superficial, decide qué debe pasar con los arrays y pulsa Fusionar JSON. El resultado se descarga como un solo archivo. El orden es la regla de los conflictos: cuando dos archivos definen la misma clave, gana el posterior, y la pestaña Conflictos enumera cada valor sobrescrito, con el valor anterior y el nuevo. El plan gratuito admite hasta 5 documentos, 10 MB cada uno y 30 MB en total, y todo se ejecuta en tu dispositivo, no en nuestros servidores. El resto de la guía explica qué ajustes sirven para cada tarea, porque «combinar» significa tres cosas bastante distintas según lo que contengan tus archivos.
Combinar archivos JSON: tres tareas distintas
Antes de elegir ajustes, mira los corchetes exteriores de tus archivos. Un archivo que empieza por { es un objeto (claves con nombre); uno que empieza por [ es un array (una lista). Lo que necesitas de la fusión depende de eso y de si los archivos describen las mismas cosas o cosas diferentes.
| Tus archivos | Lo que quieres | Ajustes |
|---|---|---|
| Objetos: una configuración base más ajustes que la sobrescriben | Que cada ajuste cambie solo las claves que nombra | Fusión profunda, Arrays: Reemplazar |
| Arrays: varias listas de registros o entradas de log | Una lista larga con todo | Arrays: Concatenar |
| Arrays de etiquetas o valores que se repiten | Una lista con cada valor una sola vez | Arrays: Unión |
| Dos exportaciones de los mismos registros con campos distintos | Un registro por id con todos sus campos | Arrays: Fusionar por clave, Campo clave: id |
| Objetos cuyas secciones anidadas deben sustituirse enteras | Una sección posterior reemplaza por completo a la anterior | Fusión superficial |
La herramienta acepta cualquier raíz JSON, así que puedes fusionar objetos con objetos, arrays con arrays o mezclarlos. Cuando los dos valores en la misma posición son de tipos distintos (un objeto frente a un array, un número frente a un texto), no se pueden combinar: el posterior reemplaza al anterior y el reemplazo queda registrado como conflicto.
Cómo unir archivos JSON en uno, paso a paso
Añade los documentos
Arrastra hasta cinco archivos .json, .jsonc, .jsonl o .ndjson a la herramienta para fusionar JSON, o pulsa Pegar JSON para escribir o pegar un documento. Puedes mezclar archivos y texto pegado.
Ordénalos
El primer documento es la base y cada uno de los siguientes se coloca encima. Usa las flechas de cada fila para subirlo o bajarlo, de modo que el archivo cuyos valores deben ganar quede el último.
Elige cómo se combinan los objetos
En Objetos, Fusión profunda combina los objetos anidados clave por clave; Fusión superficial combina solo las claves del nivel superior y reemplaza enteros los objetos anidados. La profunda es la opción predeterminada.
Elige cómo se combinan los arrays
En Arrays, elige Reemplazar, Concatenar, Unión o Fusionar por clave. Para Fusionar por clave, escribe el Campo clave que identifica un registro (por defecto, id). Pon Valores null en Ignorar si un null de un archivo posterior nunca debe borrar un valor.
Fusiona y revisa
Pulsa Fusionar JSON. Lee la pestaña Conflictos para ver qué se sobrescribió y la pestaña Entradas para ver claves duplicadas o avisos de precisión encontrados en cada origen.
Descarga o copia
Elige una sangría (Minificado, 2 espacios, 4 espacios o tabulación) y un formato (JSON, o NDJSON cuando el resultado es un array) y pulsa Descargar JSON o Copiar.
Fusión profunda o superficial, cuatro estrategias de arrays, una política para null y un informe de conflictos, todo gratis. Gratis: hasta 5 documentos, 10 MB cada uno y 30 MB en total. Pro: hasta 100 documentos, limitado solo por tu dispositivo, y entrega en ZIP.
Combinar archivos JSONFusión profunda frente a fusión superficial
Toma un archivo base {"server": {"host": "localhost", "port": 8080}} y un ajuste {"server": {"port": 9090}}. Con Fusión profunda el resultado es {"server": {"host": "localhost", "port": 9090}}: la herramienta entra en server y cambia solo la clave que menciona el ajuste. Con Fusión superficial el resultado es {"server": {"port": 9090}}: el objeto server completo del archivo posterior reemplaza al anterior, y host desaparece.
La profunda es la que necesitas para configuraciones por capas (base, luego producción, luego ajustes locales), para archivos de traducción repartidos entre equipos y para datos de prueba en los que cada caso cambia unos pocos campos. La superficial es la adecuada cuando cada sección del nivel superior es una unidad independiente y un archivo posterior debe aportar un reemplazo completo, por ejemplo un bloque database entero para otro entorno.
Combinar arrays JSON: reemplazar, concatenar, unión o por clave
No hay una única forma correcta de fusionar dos listas, así que la herramienta te pregunta. El ajuste se aplica allí donde se encuentran dos arrays: en la raíz del archivo y en cualquier ruta anidada en modo profundo (o en una clave del nivel superior en modo superficial).
- Reemplazar (predeterminado): gana el array posterior sin más.
[1, 2]y[3]dan[3]. - Concatenar: todos los elementos de ambos arrays, en orden y con duplicados.
[1, 2]y[2, 3]dan[1, 2, 2, 3]. Úsalo para logs, eventos y exportaciones de registros que no se solapan. - Unión: ambos arrays unidos y luego sin elementos repetidos.
[1, 2]y[2, 3]dan[1, 2, 3]. Los objetos se comparan por contenido, así que{"a":1,"b":2}y{"b":2,"a":1}cuentan como el mismo elemento. - Fusionar por clave: los registros que comparten el valor del Campo clave se combinan campo por campo; los registros con una clave nueva se añaden al final; los elementos que no son objetos o no tienen la clave se añaden sin tocarlos.
Fusionar por clave compara el tipo además del valor. Un registro con "id": 1 y otro con "id": "1" son registros distintos y no se unen. Si tus dos exportaciones no coinciden en si los id son números o textos, corrige una de ellas antes; si no, el resultado tendrá las dos versiones una al lado de la otra.
Qué pasa exactamente cuando dos claves chocan
Un conflicto es cualquier punto en el que un documento posterior reemplazó un valor en vez de fusionarse con él. Estas son, completas, las reglas que sigue el fusionador:
- 1Una clave que existe en un solo documento se copia tal cual. No se pierde nada y no se informa de nada.
- 2Dos objetos en la misma ruta se fusionan clave por clave (en modo superficial, solo en el nivel superior).
- 3Dos arrays en la misma ruta siguen el ajuste de Arrays.
- 4Cualquier otro caso, como dos números distintos, un texto frente a un objeto, o un objeto frente a otro objeto con fusión superficial, se resuelve con el valor posterior y queda registrado como conflicto.
- 5Un documento posterior que escribe exactamente el mismo valor no es un conflicto, así que el informe muestra solo cambios reales.
- 6Un
nullexplícito en un archivo posterior sobrescribe por defecto, porque null es un valor JSON real. Con Valores null en Ignorar, se omite y el informe cuenta cuántos null se ignoraron.
La pestaña Conflictos muestra cada uno en una fila: la ruta (como $.server.port), el valor que tenía, el que tiene ahora y el documento del que procede. Los primeros 500 conflictos se listan completos y el contador sigue sumando a partir de ahí. Si la pestaña dice que no se sobrescribió nada, todos los valores de todos los documentos están en el resultado.
El orden de las claves sigue por defecto al documento base, y las claves que solo aparecen en archivos posteriores se añaden al final, lo que mantiene pequeño el diff en el control de versiones. Elige Orden de claves: A-Z cuando quieras el mismo resultado sin importar cómo estuvieran escritas las entradas.
Lo que puede fallar y qué hacer
| Lo que ves | Por qué | Solución |
|---|---|---|
| Una fila muestra una línea y una columna con un acento circunflejo debajo | Ese documento no es JSON válido | Corrígelo con el Validador de JSON o el Formateador de JSON y vuelve a fusionar |
| Un aviso de que hay un comentario y la entrada estricta está activada | Aceptar comentarios y comas finales está desactivado | Vuelve a activarlo; los archivos de configuración como tsconfig.json suelen llevar comentarios |
| La pestaña Entradas informa de claves duplicadas | Un archivo contiene la misma clave dos veces y solo la última sobrevive al análisis | Comprueba cuál querías antes de fiarte de la fusión |
| Aviso de números que pierden precisión | Los enteros mayores que 9007199254740991, como algunos id de base de datos de 64 bits, cambian al leerse | Guarda esos id como textos en los archivos de origen |
| NDJSON no está disponible | El resultado fusionado es un objeto y NDJSON necesita un array | Usa JSON o fusiona archivos de arrays |
| Distintivo «Ajustes cambiados» | Cambiaste una opción o el orden después de fusionar | Pulsa Volver a aplicar |
| Aviso de vista previa acortada | El resultado es demasiado largo para mostrarlo entero | No falta nada: la descarga contiene el resultado completo |
El límite gratuito que suele frenar una fusión es el total de 30 MB, más que los 10 MB por archivo, porque la herramienta mantiene en memoria a la vez todas las entradas y el resultado fusionado. Cinco archivos de 8 MB cada uno, 40 MB en conjunto, superan el total aunque cada archivo esté por debajo del límite individual. Quitar los espacios con el Minificador de JSON antes suele dejar el conjunto por debajo del límite sin cambiar ningún dato.
Después de fusionar: revisa y ordena
Para ver la fusión desde el otro lado, compara el archivo fusionado con tu archivo base en JSON Diff: cada adición y cada cambio aparecerán listados por ruta. Cómo leer ese informe se explica en cómo comparar dos archivos JSON. Si varias herramientas regeneran el archivo fusionado, ordena sus claves para que el orden se mantenga estable entre ejecuciones. Y si tus datos son en realidad una exportación de hoja de cálculo, combinar archivos CSV los mantiene en filas y columnas.
Preguntas frecuentes
¿Cómo combino dos archivos JSON en uno?
Añade los dos archivos al fusionador de JSON, con el archivo cuyos valores deben ganar en segundo lugar, deja seleccionada Fusión profunda y pulsa Fusionar JSON. Después descarga el resultado. La versión gratuita cubre hasta 5 documentos, 10 MB cada uno y 30 MB en total.
¿Cómo uno archivos JSON que son arrays en un solo array?
Pon Arrays en Concatenar antes de fusionar. Con el valor predeterminado, Reemplazar, gana el array posterior y solo obtienes los elementos del último archivo. Elige Unión para quitar los elementos repetidos, o Fusionar por clave para unir registros que comparten un id.
¿Qué valor gana cuando dos archivos JSON tienen la misma clave?
El del documento posterior en la lista. Si ambos valores son objetos, se combinan (en modo profundo); si no, el valor posterior reemplaza al anterior y la pestaña Conflictos registra la ruta, el valor antiguo, el nuevo y qué documento ganó.
¿Qué diferencia hay entre fusión profunda y superficial en JSON?
La fusión profunda entra en los objetos anidados y cambia solo las claves que nombra un archivo posterior. La superficial trabaja solo con las claves del nivel superior, así que un objeto anidado de un archivo posterior reemplaza por completo al anterior, incluidas las claves que no mencionaba.
¿Puedo evitar que los valores null borren datos al fusionar JSON?
Sí. Pon Valores null en Ignorar. Un null de un archivo posterior se omite entonces allí donde ya existe un valor, y el informe de la fusión indica cuántos null se ignoraron. Con Sobrescribir, la opción predeterminada, un null reemplaza el valor anterior.
¿Puedo fusionar archivos JSON con comentarios o JSON Lines?
Sí. Con Aceptar comentarios y comas finales activado, que es lo predeterminado, los archivos con comentarios // o /* */ y comas finales se leen con normalidad. Los archivos NDJSON y JSON Lines se leen como un array, y un resultado en array puede volver a escribirse como NDJSON.