KI auf dem Gerät – professionell und privat.

Dokumente

Zwei JSON-Dateien vergleichen (und warum ein reiner Textvergleich in die Irre führt)

Vergleichen Sie zwei JSON-Dateien und sehen Sie, welche Schlüssel hinzukamen, fehlen oder sich geändert haben. Warum Text-Diffs rauschen und wie Arrays gepaart werden.

Aktualisiert am 7. November 20268 Min. Lesezeit

Um zwei JSON-Dateien zu vergleichen, öffnen Sie das JSON-Diff-Werkzeug, legen auf jeder Seite eine Datei ab (oder fügen den Text ein) und lesen die Liste der Unterschiede. Jeder ist als hinzugefügt, entfernt, geändert oder Typ geändert markiert, mit dem genauen Pfad zum Wert. Verglichen werden die Daten, nicht der Text: Vertauschte Schlüssel und andere Einrückungen erscheinen daher nicht als Änderungen. Genau deshalb nutzt man es statt eines normalen Textvergleichs.

Warum ein Text-Diff bei JSON so viel Rauschen erzeugt

Ein Textvergleich arbeitet Zeile für Zeile. JSON kümmern Zeilen nicht. Diese beiden Dokumente enthalten exakt dieselben Daten, doch ein Text-Diff markiert jede Zeile als verschieden: Das eine steht in einer einzigen Zeile, das andere ist mit vier Leerzeichen eingerückt, und die Schlüssel stehen in anderer Reihenfolge.

Was sich unterscheidetDer Text-Diff sagtDie Daten sagen
Einrückung (2 Leerzeichen, 4 oder ein Tab)Jede Zeile geändertNichts geändert
Ganze Datei in eine Zeile minifiziertEine Zeile durch eine andere ersetztNichts geändert
Schlüssel in anderer ReihenfolgeZeilen verschoben oder neu geschriebenNichts geändert: Objekte haben keine Reihenfolge
1 als 1.0 geschriebenZeile geändertDieselbe Zahl
Ein Preis von 9,99 auf 10,99Eine Zeile geändertEin Wert geändert

Die letzte Zeile ist die, die Sie interessiert, und im Text-Diff geht sie unter den ersten vier unter. Viele APIs liefern die Schlüssel bei jedem Aufruf in anderer Reihenfolge, und viele Programme schreiben die Einrückung beim Speichern neu. Das Rauschen ist also der Normalfall, nicht die Ausnahme.

Zwei JSON-Dateien vergleichen, Schritt für Schritt

1

Das linke Dokument hinzufügen

Öffnen Sie das JSON-Diff-Werkzeug. Fügen Sie das Original in das Feld Links (Original) ein oder legen Sie eine .json-Datei auf dem Ablagebereich ab. Das Werkzeug öffnet auch .jsonc-, .geojson-, .map- und .txt-Dateien.

2

Das rechte Dokument hinzufügen

Fügen Sie die geänderte Fassung unter Rechts (geändert) ein oder legen Sie sie dort ab. Legen Sie beide Dateien gleichzeitig ab, werden sie nach Namen gepaart: billing.before.json und billing.after.json landen so auf der richtigen Seite. Mit Seiten tauschen korrigieren Sie eine vertauschte Zuordnung.

3

Die Unterschiede lesen

Der Vergleich läuft beim Tippen. Wählen Sie Nebeneinander, Inline oder Nach Pfad. Die Zusammenfassung zeigt, wie viele Werte hinzugefügt, entfernt und geändert wurden, und die Schaltflächen Nächste Änderung und Zurück springen von einer zur nächsten. Mit dem Filter zeigen Sie nur Hinzugefügtes, Entferntes, Geändertes oder Typänderungen.

4

Festlegen, was als Unterschied zählt

Öffnen Sie die Vergleichseinstellungen, um die Array-Reihenfolge, Groß-/Kleinschreibung oder Leerzeichen zu ignorieren, eine Zahlentoleranz zu setzen oder Schlüssel auszulassen, die sich ohnehin ständig ändern. Die nächsten Abschnitte erklären jede Option.

5

Exportieren, wenn Sie einen Nachweis brauchen

Zusammenfassung kopieren legt eine einfache Liste der Änderungen in die Zwischenablage. JSON-Patch herunterladen liefert eine Standarddatei, die das linke Dokument in das rechte überführt. Markdown herunterladen liefert einen Bericht, den Sie in ein Ticket oder einen Pull Request einfügen können.

Vergleichen Sie zwei Dokumente und sehen Sie jeden hinzugefügten, entfernten und geänderten Wert nach Pfad. Gratis: ein Paar nach dem anderen, bis zu 10 MB pro Seite, mit allen Optionen und Exporten. Läuft auf Ihrem Gerät, nicht auf unseren Servern.

Zwei JSON-Dateien vergleichen

Was der Bericht zeigt: hinzugefügt, entfernt, geändert

Das Werkzeug geht beide Dokumente gemeinsam durch und meldet jeden Unterschied mit seiner Fundstelle. Objekte werden Schlüssel für Schlüssel verglichen, in jeder Tiefe. Ein Schlüssel, den es nur rechts gibt, ist hinzugefügt. Ein Schlüssel, den es nur links gibt, ist entfernt. Ein Schlüssel, der auf beiden Seiten mit anderem Wert vorkommt, ist geändert. Ein Wert, dessen Art sich geändert hat, etwa der Text "3", der zur Zahl 3 wird, wird gesondert als Typ geändert gemeldet, weil das die Änderung ist, die am ehesten kaputt macht, was die Datei danach liest.

Fundstellen werden als Pfade geschrieben. Unter Nach Pfad sehen Sie, wo jede Änderung liegt, etwa der Name des zweiten Eintrags einer Benutzerliste. Der exportierte Patch nutzt die Standardform JSON Pointer (/users/1/name), die eindeutig bleibt, selbst wenn ein Schlüssel einen Punkt oder Schrägstrich enthält.

  • Zahlen werden nach Wert verglichen: 1, 1.0 und 1e0 sind dieselbe Zahl und werden nicht gemeldet.
  • Das Umsortieren der Schlüssel eines Objekts ist nie eine Änderung.
  • Die oberste Ebene kann alles sein, was JSON erlaubt: ein Objekt, ein Array oder auch nur eine Zeichenkette oder Zahl.
  • Deklariert ein Dokument denselben Schlüssel zweimal, warnt das Werkzeug Sie, denn Parser behalten stillschweigend nur den letzten Wert, und ein Unterschied im früheren ist unsichtbar.

Wie Arrays verglichen werden

Bei Arrays gehen JSON-Vergleiche schief. Werden zwei Listen strikt Position für Position verglichen, lässt ein vorn eingefügtes Element alle folgenden unterschiedlich aussehen. Das Werkzeug vermeidet das, indem es die Elemente zuerst ausrichtet, und zeigt neben der Zusammenfassung, welche Strategie es verwendet hat.

StrategieWann sie verwendet wirdGut für
Nach IDSie nennen unter Array-Elemente nach Feld paaren ein Feld, und jedes Element hat darin einen eindeutigen WertDatensätze aus einer API, die in anderer Reihenfolge kamen
Nach längster gemeinsamer TeilfolgeDie VoreinstellungListen, in die Elemente eingefügt oder aus denen sie entfernt wurden
Als MengeArray-Reihenfolge ignorieren ist aktivTags, Berechtigungen, alles, wo die Reihenfolge nichts bedeutet
Nach PositionDie beiden Listen haben fast nichts gemeinsamListen, die tatsächlich ersetzt wurden

Das Paaren nach ID ist die richtige Wahl für Listen von Datensätzen. Geben Sie den Feldnamen ein (id ist üblich), und eine umsortierte Liste wird als umsortiert gemeldet, mit nur dem Datensatz, der sich wirklich geändert hat. Das Werkzeug nutzt das Feld nur, wenn jedes Element es hat und kein Wert doppelt vorkommt. Andernfalls entstünde eine ordentliche, aber falsche Zuordnung, deshalb fällt es auf die Voreinstellung zurück, statt zu raten.

Rauschen ausblenden: Schlüssel, Pfade, Schreibweise und Zahlen

Voreingestellt ist der strikte Vergleich: Jeder Wert, jeder Typ und jede Array-Position muss übereinstimmen. Jede Einstellung lockert genau eine Sache, und der exportierte Bericht hält fest, welche aktiv waren.

  • Zu ignorierende Schlüssel: Nennen Sie Namen wie updatedAt oder requestId, durch Kommas getrennt. Sie werden überall übersprungen, wo sie vorkommen, in jeder Tiefe. So werden aus zwei API-Momentaufnahmen ein lesbarer Diff.
  • Zu ignorierende Pfade: Überspringen Sie eine einzelne Stelle, mit * für eine Ebene und ** für beliebig viele. /users/*/lastSeen überspringt dieses Feld bei allen Benutzern.
  • Groß-/Kleinschreibung ignorieren und Leerzeichen ignorieren: für Bezeichnungen, deren Stil sich geändert hat, oder Beschreibungen, die neu umbrochen wurden.
  • Zahlentoleranz: wie nah zwei Zahlen beieinander liegen müssen, um als gleich zu gelten. Bei einer Toleranz von 0,0001 verschwindet das Rauschen durch Rundung von Dezimalzahlen, während eine echte Preisänderung sichtbar bleibt.
  • Kommentare und abschließende Kommas erlauben: für Konfigurationsdateien, die als JSONC geschrieben sind.

Typische Aufgaben: API-Änderungen und Konfigurationsabweichungen

Hat sich eine API geändert, speichern Sie die Antwort vor und nach der Änderung, tragen die sich ständig ändernden Felder (Zeitstempel, Anfrage-IDs, ETags) bei den ignorierten Schlüsseln ein, und was übrig bleibt, ist die echte Strukturänderung. Bei Konfigurationsabweichungen zwischen zwei Umgebungen, etwa Staging und Produktion, laden Sie beide Dateien und sehen unter Nach Pfad genau, welche Einstellungen sich unterscheiden, und nichts sonst. Bei einer Migration oder einem Export vergleichen Sie die alte und die neue Datei und laden den Markdown-Bericht als Nachweis herunter, was sich bewegt hat.

Möchten Sie weiter mit einem gewöhnlichen Text-Diff vergleichen, etwa in einem Code-Review-Werkzeug, machen Sie beide Dateien zuerst gleich aussehend: Schicken Sie jede mit derselben Einrückung durch den JSON-Formatierer und bringen Sie die Schlüssel mit JSON-Schlüssel sortieren in eine Reihenfolge. Das Sortieren verschiebt nur die Schlüssel, die Werte bleiben unberührt. Damit verschwindet der Großteil des Text-Rauschens, aber es leistet nicht, was das Diff-Werkzeug bei Arrays, Toleranzen oder ignorierten Feldern leistet.

Grenzen und was schiefgehen kann

  • Größe: Gratis vergleicht ein Paar nach dem anderen, bis zu 10 MB pro Seite. Pro hebt die Größe auf das, was Ihr Gerät bewältigt, und vergleicht bis zu 50 Paare gleichzeitig, nach Dateinamen gepaart, mit allen Berichten und Patches in einer ZIP-Datei. Eine Datei über der Gratisgrenze wird mit ihrer tatsächlichen Größe und einem Link zum Minifizierer abgelehnt, denn formatiertes JSON besteht oft hauptsächlich aus Einrückung.
  • Andere Formate: YAML-, XML-, CSV- und Excel-Dateien werden gleich am Eingang mit einem Link zum passenden Konverter abgelehnt, etwa YAML in JSON. Erst konvertieren, dann vergleichen.
  • „Keine Unterschiede“ wirkt falsch: Prüfen Sie, ob eine Ignorieren-Einstellung, eine hohe Zahlentoleranz oder eine Warnung zu doppelten Schlüsseln das erklärt.
  • Zu viele Unterschiede: Ab 100.000 wächst die Liste nicht weiter, die Summen bleiben aber exakt, und die Seite weist darauf hin, dass die Liste gekürzt wurde.
  • Eine sehr große Liste in zwei Reihenfolgen: Nennen Sie ein ID-Feld oder aktivieren Sie Array-Reihenfolge ignorieren, statt Tausende Verschiebungen zu lesen.

Der Vergleich läuft auf Ihrem Gerät, nicht auf unseren Servern; Zugangsdaten und Kundendaten in einer Antwort werden also nicht zum Vergleichen hochgeladen. Einen Überblick, wie sich JSON von anderen Datenformaten unterscheidet, finden Sie unter JSON, CSV und XML im Vergleich.

Häufige Fragen

Wie vergleiche ich zwei JSON-Dateien online?

Öffnen Sie das JSON-Diff-Werkzeug, legen Sie auf jeder Seite eine Datei ab oder fügen Sie den Text ein und lesen Sie die Liste hinzugefügter, entfernter und geänderter Werte. Verglichen wird beim Tippen. Gratis deckt ein Paar bis zu 10 MB pro Seite ab.

Spielt es eine Rolle, wenn die Schlüssel in anderer Reihenfolge stehen?

Nein. Objekte haben keine Reihenfolge, ein umsortiertes Objekt gilt daher als identisch. Nur Arrays haben eine Reihenfolge, und Sie können Array-Reihenfolge ignorieren aktivieren, wenn auch sie keine Rolle spielt.

Wie vergleiche ich zwei JSON-Arrays, wenn Elemente verschoben wurden?

Geben Sie unter Array-Elemente nach Feld paaren den Namen eines eindeutigen Feldes ein, meist id. Die Elemente werden dann nach diesem Wert statt nach Position ausgerichtet, und eine umsortierte Liste zeigt nur die Datensätze, die sich wirklich geändert haben. Oder aktivieren Sie Array-Reihenfolge ignorieren.

Kann ich Felder wie Zeitstempel ignorieren?

Ja. Tragen Sie die Schlüsselnamen unter Zu ignorierende Schlüssel ein, zum Beispiel updatedAt, requestId. Sie werden in jeder Tiefe übersprungen. Um nur eine Stelle auszulassen, nutzen Sie Zu ignorierende Pfade, die die Platzhalter * und ** akzeptieren.

Kann ich JSON mit Kommentaren vergleichen, etwa eine Konfigurationsdatei?

Ja. Aktivieren Sie Kommentare und abschließende Kommas erlauben, oder legen Sie eine .jsonc-Datei ab, die die Option für Sie einschaltet. YAML und XML werden nicht direkt geöffnet: Konvertieren Sie sie zuerst in JSON.

Kann ich die Unterschiede speichern?

Ja, auf drei Wegen, alle im Gratis-Tarif: eine einfache Zusammenfassung kopieren, einen JSON-Patch nach RFC 6902 herunterladen oder einen Markdown-Bericht herunterladen. Pro ergänzt Stapel von bis zu 50 Paaren in einer ZIP-Datei.

Weiterlesen

Mehr zu Dokumente →