Como mesclar arquivos JSON online (e o que acontece quando as chaves entram em conflito)
Junte vários arquivos JSON em um: mesclagem profunda ou superficial, quatro formas de combinar arrays e um relatório de cada valor sobrescrito. Grátis até 5 arquivos.
Atualizado em 8 de novembro de 20269 min de leitura
Para mesclar arquivos JSON, adicione-os ao mesclador de JSON na ordem em que devem ser aplicados, escolha Mesclagem profunda ou Mesclagem superficial, defina o que deve acontecer com os arrays e clique em Mesclar JSON. O resultado é baixado como um único arquivo. A ordem é a regra dos conflitos: quando dois arquivos definem a mesma chave, o posterior vence, e a aba Conflitos lista cada valor sobrescrito, com o valor antigo e o novo. O plano gratuito aceita até 5 documentos, 10 MB cada e 30 MB no total, e tudo roda no seu dispositivo, não nos nossos servidores. O resto deste guia explica quais ajustes servem para cada tarefa, porque “mesclar” significa três coisas bem diferentes dependendo do que os seus arquivos contêm.
Mesclar arquivos JSON: três tarefas diferentes
Antes de escolher os ajustes, olhe os colchetes mais externos dos seus arquivos. Um arquivo que começa com { é um objeto (chaves com nome); um que começa com [ é um array (uma lista). O que você precisa da mesclagem depende disso e de os arquivos descreverem as mesmas coisas ou coisas diferentes.
| Seus arquivos | O que você quer | Ajustes |
|---|---|---|
| Objetos: uma configuração base mais substituições | Cada substituição altera só as chaves que cita | Mesclagem profunda, Arrays: Substituir |
| Arrays: várias listas de registros ou entradas de log | Uma lista longa com tudo | Arrays: Concatenar |
| Arrays de tags ou valores que se repetem | Uma lista com cada valor uma única vez | Arrays: União |
| Duas exportações dos mesmos registros com campos diferentes | Um registro por id com todos os campos | Arrays: Mesclar por chave, Campo chave: id |
| Objetos cujas seções aninhadas devem ser trocadas inteiras | Uma seção posterior substitui a anterior por completo | Mesclagem superficial |
A ferramenta aceita qualquer raiz JSON, então você pode mesclar objetos com objetos, arrays com arrays ou misturar. Quando os dois valores na mesma posição são de tipos diferentes (um objeto contra um array, um número contra um texto), eles não podem ser combinados: o posterior substitui o anterior e a substituição é registrada como conflito.
Como juntar arquivos JSON em um, passo a passo
Adicione os documentos
Arraste até cinco arquivos .json, .jsonc, .jsonl ou .ndjson para a ferramenta de mesclar JSON, ou clique em Colar JSON para digitar ou colar um documento. Dá para misturar arquivos e texto colado.
Coloque-os em ordem
O primeiro documento é a base e cada um dos seguintes é aplicado por cima. Use as setas de cada linha para movê-lo para cima ou para baixo, de forma que o arquivo cujos valores devem vencer fique por último.
Escolha como os objetos se combinam
Em Objetos, Mesclagem profunda combina os objetos aninhados chave por chave; Mesclagem superficial combina só as chaves do nível superior e substitui os objetos aninhados inteiros. A profunda é o padrão.
Escolha como os arrays se combinam
Em Arrays, escolha Substituir, Concatenar, União ou Mesclar por chave. Para Mesclar por chave, digite o Campo chave que identifica um registro (o padrão é id). Coloque Valores null em Ignorar se um null em um arquivo posterior nunca puder apagar um valor.
Mescle e confira
Clique em Mesclar JSON. Leia a aba Conflitos para ver o que foi sobrescrito e a aba Entradas para ver chaves duplicadas ou avisos de precisão encontrados em cada origem.
Baixe ou copie
Escolha uma indentação (Minificado, 2 espaços, 4 espaços ou tabulação) e um formato (JSON, ou NDJSON quando o resultado é um array) e clique em Baixar JSON ou Copiar.
Mesclagem profunda ou superficial, quatro estratégias de arrays, uma regra para null e um relatório de conflitos, tudo grátis. Grátis: até 5 documentos, 10 MB cada e 30 MB no total. Pro: até 100 documentos, limitado só pelo seu dispositivo, mais entrega em ZIP.
Mesclar arquivos JSONMesclagem profunda x mesclagem superficial
Pegue um arquivo base {"server": {"host": "localhost", "port": 8080}} e uma substituição {"server": {"port": 9090}}. Com Mesclagem profunda o resultado é {"server": {"host": "localhost", "port": 9090}}: a ferramenta entra em server e altera só a chave que a substituição menciona. Com Mesclagem superficial o resultado é {"server": {"port": 9090}}: o objeto server inteiro do arquivo posterior substitui o anterior, e host some.
A profunda é a certa para configurações em camadas (base, depois produção, depois ajustes locais), para arquivos de tradução divididos entre equipes e para dados de teste em que cada caso muda poucos campos. A superficial serve quando cada seção do nível superior é uma unidade independente e um arquivo posterior deve trazer uma substituição completa, por exemplo um bloco database inteiro para outro ambiente.
Combinar arrays JSON: substituir, concatenar, união ou por chave
Não existe um único jeito certo de mesclar duas listas, por isso a ferramenta pergunta. O ajuste vale onde quer que dois arrays se encontrem: na raiz do arquivo e em qualquer caminho aninhado no modo profundo (ou em uma chave do nível superior no modo superficial).
- Substituir (padrão): o array posterior vence por completo.
[1, 2]e[3]dão[3]. - Concatenar: todos os itens dos dois arrays, em ordem, com duplicatas.
[1, 2]e[2, 3]dão[1, 2, 2, 3]. Use para logs, eventos e exportações de registros que não se sobrepõem. - União: os dois arrays juntos, depois sem itens repetidos.
[1, 2]e[2, 3]dão[1, 2, 3]. Objetos são comparados pelo conteúdo, então{"a":1,"b":2}e{"b":2,"a":1}contam como o mesmo item. - Mesclar por chave: registros com o mesmo valor no Campo chave são combinados campo a campo; registros com uma chave nova entram no final; itens que não são objetos ou não têm a chave são acrescentados sem alteração.
Mesclar por chave compara o tipo além do valor. Um registro com "id": 1 e outro com "id": "1" são registros diferentes e não se juntam. Se as duas exportações discordam sobre os ids serem números ou textos, corrija uma delas antes; senão o resultado terá as duas versões lado a lado.
O que acontece exatamente em um conflito de chaves
Um conflito é qualquer ponto em que um documento posterior substituiu um valor em vez de se mesclar com ele. Estas são, completas, as regras que o mesclador segue:
- 1Uma chave que existe em um só documento é copiada como está. Nada se perde e nada é relatado.
- 2Dois objetos no mesmo caminho são mesclados chave por chave (no modo superficial, só no nível superior).
- 3Dois arrays no mesmo caminho seguem o ajuste de Arrays.
- 4Qualquer outro caso, como dois números diferentes, um texto contra um objeto, ou um objeto contra outro objeto na mesclagem superficial, é substituído pelo valor posterior e registrado como conflito.
- 5Um documento posterior que escreve exatamente o mesmo valor não é conflito, então o relatório mostra só mudanças reais.
- 6Um
nullexplícito em um arquivo posterior sobrescreve por padrão, porque null é um valor JSON real. Com Valores null em Ignorar, ele é pulado e o relatório conta quantos null foram ignorados.
A aba Conflitos mostra cada um em uma linha: o caminho (como $.server.port), o valor que havia, o valor atual e o documento de onde veio. Os primeiros 500 conflitos são listados por inteiro e a contagem continua depois disso. Se a aba disser que nada foi sobrescrito, todos os valores de todos os documentos estão no resultado.
Por padrão, a ordem das chaves segue o documento base, e as chaves que só aparecem em arquivos posteriores são adicionadas no final, o que deixa pequeno o diff no controle de versão. Escolha Ordem das chaves: A-Z quando quiser a mesma saída independentemente de como as entradas foram escritas.
O que pode dar errado e o que fazer
| O que aparece | Por quê | Solução |
|---|---|---|
| Uma linha mostra linha e coluna com um acento circunflexo embaixo | Esse documento não é JSON válido | Corrija com o Validador de JSON ou o Formatador de JSON e mescle de novo |
| Um aviso de que há um comentário e a entrada estrita está ligada | Aceitar comentários e vírgulas finais está desligado | Ligue de novo; arquivos de configuração como tsconfig.json costumam ter comentários |
| A aba Entradas aponta chaves duplicadas | Um arquivo tem a mesma chave duas vezes, e só a última sobrevive à leitura | Confira qual era a certa antes de confiar na mesclagem |
| Aviso de números que perdem precisão | Inteiros acima de 9007199254740991, como alguns ids de banco de dados de 64 bits, mudam ao serem lidos | Guarde esses ids como texto nos arquivos de origem |
| NDJSON não está disponível | O resultado mesclado é um objeto, e NDJSON precisa de um array | Use JSON, ou mescle arquivos de arrays |
| Selo “Ajustes alterados” | Você mudou uma opção ou a ordem depois de mesclar | Clique em Aplicar de novo |
| Aviso de prévia encurtada | O resultado é longo demais para aparecer inteiro na tela | Não falta nada: o download traz o resultado completo |
O limite gratuito que costuma travar uma mesclagem é o total de 30 MB, e não os 10 MB por arquivo, porque a ferramenta mantém na memória ao mesmo tempo todas as entradas e o resultado mesclado. Cinco arquivos de 8 MB cada, 40 MB juntos, passam do total mesmo com cada arquivo abaixo do limite individual. Tirar os espaços com o Minificador de JSON antes costuma deixar o conjunto abaixo do limite sem mudar nenhum dado.
Depois da mesclagem: confira e organize
Para ver a mesclagem pelo outro lado, compare o arquivo mesclado com o arquivo base no JSON Diff: cada adição e cada mudança aparecem listadas por caminho. Como ler esse relatório está em como comparar dois arquivos JSON. Se várias ferramentas regeram o arquivo mesclado, ordene as chaves para que a ordem fique estável entre execuções. E se os seus dados são na verdade uma exportação de planilha, mesclar arquivos CSV os mantém em linhas e colunas.
Perguntas frequentes
Como mesclar dois arquivos JSON em um?
Adicione os dois arquivos ao mesclador de JSON, com o arquivo cujos valores devem vencer em segundo lugar, deixe Mesclagem profunda selecionada e clique em Mesclar JSON. Depois baixe o resultado. O plano gratuito cobre até 5 documentos, 10 MB cada e 30 MB no total.
Como juntar arquivos JSON que são arrays em um único array?
Coloque Arrays em Concatenar antes de mesclar. No padrão, Substituir, o array posterior vence e você fica só com os itens do último arquivo. Escolha União para tirar os itens repetidos, ou Mesclar por chave para juntar registros que têm o mesmo id.
Qual valor vence quando dois arquivos JSON têm a mesma chave?
O do documento posterior na lista. Se os dois valores forem objetos, eles são combinados (no modo profundo); caso contrário, o valor posterior substitui o anterior, e a aba Conflitos registra o caminho, o valor antigo, o novo e qual documento venceu.
Qual a diferença entre mesclagem profunda e superficial em JSON?
A mesclagem profunda entra nos objetos aninhados e altera só as chaves que um arquivo posterior cita. A superficial trabalha só com as chaves do nível superior, então um objeto aninhado de um arquivo posterior substitui o anterior por completo, inclusive as chaves que ele não mencionava.
Dá para impedir que valores null apaguem dados ao mesclar JSON?
Sim. Coloque Valores null em Ignorar. Um null em um arquivo posterior passa a ser pulado onde já existe um valor, e o relatório da mesclagem informa quantos null foram ignorados. Em Sobrescrever, o padrão, um null substitui o valor anterior.
Dá para mesclar arquivos JSON com comentários ou JSON Lines?
Sim. Com Aceitar comentários e vírgulas finais ligado, que é o padrão, arquivos com comentários // ou /* */ e vírgulas finais são lidos normalmente. Arquivos NDJSON e JSON Lines são lidos como um array, e um resultado em array pode ser gravado de volta como NDJSON.