Startseite › Entwickler-Tools › JSON zusammenführen

JSON zusammenführen

Kombiniere zwei oder mehr JSON-Dokumente zu einem. Lege fest, wie Arrays verbunden werden und welcher Wert gewinnt, wenn derselbe Schlüssel verschiedene Werte hat, und prüfe jeden überschriebenen Wert im Konfliktbericht, bevor du das Ergebnis kopierst oder herunterlädst.

Zuletzt aktualisiert:

Anzeige
Anzeige

Anleitung: JSON zusammenführen

  1. Füge das Basis-JSON in das erste Feld ein und das JSON, das hineingemergt werden soll, in das zweite – oder lade .json-Dateien hoch.
  2. Füge bei Bedarf weitere Eingaben hinzu. Sie werden von links nach rechts und von oben nach unten zusammengeführt.
  3. Wähle Modus und Array-Strategie, zum Beispiel Deep Merge mit Vereinigung oder Zusammenführen über das Schlüsselfeld id.
  4. Lege die Konfliktregel fest: Spätere Eingabe gewinnt (typisch für Konfigurations-Overrides) oder frühere Eingabe gewinnt (Standardwerte füllen nur Lücken).
  5. Prüfe den Tab „Konflikte“ und kopiere dann das Ergebnis oder lade merged.json herunter.

Merge-Strategien im Vergleich

Beispiel: {"tags":["a","b"],"db":{"host":"x","port":1}} wird mit {"tags":["b","c"],"db":{"port":2}} zusammengeführt, spätere Eingabe gewinnt.

Einstellungtags wird zudb wird zu
Deep Merge + Verketten["a","b","b","c"]{"host":"x","port":2}
Deep Merge + Vereinigen["a","b","c"]{"host":"x","port":2}
Deep Merge + Ersetzen["b","c"]{"host":"x","port":2}
Deep Merge + Nach Index zusammenführen["b","c"] (Element für Element){"host":"x","port":2}
Flaches Zusammenführen["b","c"]{"port":2} (host geht verloren)
JSON Merge Patch (RFC 7396)["b","c"]{"host":"x","port":2}

Typische Anwendungen

  • Mehrstufige Konfiguration: Führe config.default.json, dann config.production.json und dann lokale Overrides zusammen, mit „Spätere Eingabe gewinnt“.
  • API-Seiten kombinieren: Vereinige oder verkette die Arrays paginierter Endpunkte zu einem Datensatz.
  • Datensätze synchronisieren: Nutze „Über Schlüsselfeld zusammenführen“ mit id, um bestehende Datensätze zu aktualisieren und neue ohne Duplikate anzuhängen.
  • Übersetzungsdateien: Führe zuerst eine Basisdatei en.json und danach eine unvollständige Sprachdatei zusammen (spätere Eingabe gewinnt), damit übersetzte Strings die englischen ersetzen und alles Fehlende auf Englisch zurückfällt.
  • PATCH-Request vorbereiten: Sieh dir vor dem Senden an, was ein application/merge-patch+json-Body mit einer Ressource macht.

Wissenswerte Regeln

  • Die Schlüsselreihenfolge bleibt erhalten: Schlüssel aus früheren Eingaben kommen zuerst, neue Schlüssel werden in der Reihenfolge ihres Auftretens angehängt.
  • Vereinigung und Duplikaterkennung vergleichen ganze Werte, die Reihenfolge der Objektschlüssel spielt keine Rolle ({"a":1,"b":2} entspricht {"b":2,"a":1}).
  • Zahlen werden als JavaScript-Zahlen geparst, daher können Ganzzahlen über 253 (etwa 9 Billiarden) an Genauigkeit verlieren. Speichere sehr große IDs als Strings.
  • Leere Eingabefelder werden übersprungen, du kannst also zusätzliche Eingaben offen lassen, ohne das Ergebnis zu beeinflussen.

Häufige Fragen

Was bedeutet Deep Merge bei JSON?

Ein Deep Merge kombiniert Objekte Schlüssel für Schlüssel auf jeder Ebene. Haben beide Eingaben unter demselben Schlüssel ein Objekt, werden auch diese Objekte zusammengeführt, statt dass das spätere das frühere ersetzt. Erst wenn zwei Werte kollidieren, die nicht beide Objekte sind (zum Beispiel zwei verschiedene Strings), entscheidet die Konfliktregel, welcher behalten wird.

Wie werden Arrays zusammengeführt?

Das hängt von der Strategie ab. Verketten hängt das spätere Array hinter das frühere. Vereinigen macht dasselbe, überspringt aber Elemente, die exakt einem bereits vorhandenen entsprechen. Ersetzen behandelt das Array als einen Wert, sodass die Konfliktregel ein ganzes Array auswählt. Nach Index zusammenführen merged Element 0 mit Element 0 und so weiter. Nach Schlüssel zusammenführen ordnet Objekte über ein Feld wie id zu, merged passende Objekte und hängt den Rest an.

Was ist JSON Merge Patch (RFC 7396)?

RFC 7396 definiert ein einfaches Patch-Format: Der Patch sieht aus wie das Zieldokument, Objekte werden rekursiv zusammengeführt, jeder auf null gesetzte Schlüssel wird aus dem Ziel entfernt, und jeder andere Wert, auch Arrays, ersetzt den alten. Es wird von HTTP-PATCH-APIs mit dem Content-Type application/merge-patch+json und von Kubernetes verwendet.

Welcher Wert gewinnt bei Schlüsselkonflikten?

Standardmäßig gewinnt die spätere Eingabe – so funktionieren die meisten Konfigurationsebenen: zuerst Basiseinstellungen, dann Umgebungs- oder Benutzer-Overrides. Wähle „Frühere Eingabe gewinnt“, wenn das erste Dokument maßgeblich ist und spätere nur fehlende Schlüssel ergänzen sollen. Jede Entscheidung wird im Tab „Konflikte“ aufgelistet.

Kann ich JSON-Arrays auf oberster Ebene zusammenführen?

Ja. Wenn jede Eingabe ein Array ist, wird die Array-Strategie auf oberster Ebene angewendet, sodass du Listen verketten, eine Vereinigung bilden oder Datensätze mit gleicher id zusammenführen kannst. Ein Objekt und ein Array auf oberster Ebene zu mischen ist ein Typkonflikt, und die Konfliktregel wählt eines davon aus.

Ist das dasselbe wie lodash merge oder Object.assign?

Object.assign und der Spread-Operator sind flache Merges, wie der Modus „Flach“ hier. Lodash merge ist ein Deep Merge, der Arrays nach Index zusammenführt – das entspricht Deep Merge mit „Nach Index zusammenführen“. Beachte, dass lodash undefined-Werte überspringt, aber nicht null; das entspricht einer nicht aktivierten null-Option.

Werden meine Dateien hochgeladen?

Nein. Parsen und Zusammenführen passieren in JavaScript in deinem Browser, daher verlässt das JSON nie dein Gerät, und das Tool funktioniert nach dem Laden der Seite auch offline.

Werden alle Tools auf FreeToolCabin auf Qualität und Genauigkeit getestet?

Ja. Jedes Tool auf der Website durchläuft automatische Tests in echten Browsern, die prüfen, ob das Ergebnis stimmt und keine Fehler auftreten. Wenn du einen Fehler findest oder einen Vorschlag hast, schreib uns an [email protected] – wir sehen es uns an.

Ähnliche Tools

Alle Daten- & Dateiformat-Konverter ansehen →