{"id":10424,"date":"2026-09-17T12:30:00","date_gmt":"2026-09-17T10:30:00","guid":{"rendered":"https:\/\/www.lukaswojcik.com\/blog\/?p=10424"},"modified":"2026-09-09T17:08:58","modified_gmt":"2026-09-09T15:08:58","slug":"zwei-gtm-container-exporte-vergleichen-normalisieren-vor-dem-diff","status":"publish","type":"post","link":"https:\/\/www.lukaswojcik.com\/blog\/de\/web-entwicklung\/zwei-gtm-container-exporte-vergleichen-normalisieren-vor-dem-diff\/","title":{"rendered":"Zwei GTM-Container-Exporte vergleichen: Normalisieren vor dem Diff und was ein Zeilenvergleich nicht zeigt"},"content":{"rendered":"

Zwei Ausgaben derselben Konfiguration zu vergleichen ist der schnellste Weg herauszufinden, was jemand ge\u00e4ndert hat, und der erste Versuch liefert fast immer ein unbrauchbares Ergebnis. Es sind mehrere hundert abweichende Zeilen, von denen eine z\u00e4hlt und der Rest das Dateiformat mit sich selbst reden l\u00e4sst.<\/p>\n

Alles Folgende handelt vom Abstand zwischen diesen beiden Zahlen – wovon er gef\u00fcllt ist, wie er verschwindet und was auch danach unsichtbar bleibt.<\/p>\n

\n\"Dieselbe
Drei Ebenen f\u00fcr eine \u00c4nderung und ein viertes Paar, das ein Zeilenvergleich verschieden nennt und ein Parser gleich.<\/figcaption><\/figure>\n

Wovon der Abstand gef\u00fcllt ist<\/h2>\n

Ausgaben werden erzeugt, und Erzeuger sind zu nichts verpflichtet. Dieselbe Konfiguration, zweimal ausgegeben, kann sich in der Reihenfolge der Objektschl\u00fcssel unterscheiden, in Kennungen, die beim Ausgeben vergeben werden, in einem Fingerabdruck, der ein Zeitstempel ist, und darin, ob die Datei mit einem Zeilenumbruch endet. Nichts davon ist eine \u00c4nderung; alles davon ist ein Unterschied.<\/p>\n\n\n\n\n\n\n\n\n\n\n
Quelle des Rauschens<\/th>\nWie es aussieht<\/th>\nWie es verschwindet<\/th>\n<\/tr>\n<\/thead>\n
Schl\u00fcsselreihenfolge<\/td>\nganze Bl\u00f6cke gelten als ge\u00e4ndert<\/td>\njq -S .<\/code> sortiert die Schl\u00fcssel rekursiv<\/td>\n<\/tr>\n
Fingerabdr\u00fccke, Zeitstempel<\/td>\neine ge\u00e4nderte Zeile je Objekt<\/td>\ndie Felder vor dem Vergleich l\u00f6schen<\/td>\n<\/tr>\n
Beim Ausgeben vergebene Kennungen<\/td>\njeder Verweis weicht ab<\/td>\nebenso – oder \u00fcber Namen vergleichen<\/td>\n<\/tr>\n
Einr\u00fcckung<\/td>\nalles weicht ab<\/td>\njq<\/code> formatiert beide Seiten gleich<\/td>\n<\/tr>\n
Zeilenenden<\/td>\njede Zeile weicht ab und sieht gleich aus<\/td>\ndos2unix<\/code> oder die Option des Vergleichswerkzeugs<\/td>\n<\/tr>\n
Minimierung<\/td>\neine Zeile weicht ab und sagt nichts<\/td>\nneu formatieren, dann vergleichen<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Die Zeile mit den Zeilenenden kostet eine Stunde, weil die beiden Zeilen auf dem Bildschirm genau gleich aussehen. Eine Datei, die durch einen Windows-Editor gegangen ist, unterscheidet sich von ihrem Ursprung in jeder einzelnen Zeile, und jeder dieser Unterschiede ist unsichtbar.<\/p>\n

Erst normalisieren, dann vergleichen<\/h2>\n

Die Abhilfe ist eine Verarbeitungskette und kein besseres Vergleichswerkzeug. Beide Dateien laufen durch dieselbe Normalisierung, die fl\u00fcchtigen Felder werden entfernt, und erst danach werden die Ergebnisse verglichen – dann enth\u00e4lt der Vergleich, was sich ge\u00e4ndert hat, und sonst nichts.<\/p>\n

norm() {\n  jq -S 'walk(if type == \"object\"\n              then del(.fingerprint, .accountId, .containerVersionId)\n              else . end)' \"$1\"\n}\n\ndiff <(norm alt.json) <(norm neu.json)<\/code><\/pre>\n
walk<\/code> steigt in jedes Objekt hinab, die Felder verschwinden also \u00fcberall, wo sie vorkommen, und nicht nur auf der obersten Ebene. -S<\/code> sortiert die Schl\u00fcssel jedes Objekts und beseitigt damit allein die gr\u00f6\u00dfte Rauschquelle. Was beides \u00fcbersteht, ist eine \u00c4nderung, die jemand gemacht hat.<\/p>\n
Drei Ebenen, drei verschiedene Antworten<\/h2>\n
Zeile, Wort und Zeichen sind keine G\u00fcteklassen, sondern verschiedene Fragen. Ein Zeilenvergleich beantwortet, welche Zeilen nicht gleich sind, und das ist die richtige Frage f\u00fcr Quelltext, wo eine Zeile ungef\u00e4hr eine Anweisung ist. Es ist die falsche Frage f\u00fcr eine JSON-Datei mit einem Objekt je Zeile und vollends unbrauchbar f\u00fcr eine minimierte, in der das ganze Dokument eine einzige Zeile ist.<\/p>\n
Die Wortebene vergleicht Bausteine und macht eine \u00c4nderung an einem Wert lesbar. Die Zeichenebene ist feiner, als zum Lesen n\u00f6tig w\u00e4re, und genau das Richtige, wenn die Zeile lang ist: In einer minimierten Containerausgabe kann nur ein Zeichenvergleich auf den einen umgekippten Wahrheitswert zeigen.<\/p>\n
Was keine Ebene zeigt<\/h2>\n
Ein Textvergleich sieht Text. Drei Arten von \u00c4nderung bleiben deshalb unsichtbar, gleich wie fein die Aufl\u00f6sung wird. Ein verschobener Block erscheint als L\u00f6schung an einer und als Erg\u00e4nzung an anderer Stelle, ohne dass etwas die beiden verbindet. Eine umbenannte Variable, die an zw\u00f6lf Stellen vorkommt, erscheint als zw\u00f6lf einzelne \u00c4nderungen statt als eine Absicht. Und ein Wert, der den Typ gewechselt hat, ohne das Aussehen zu wechseln – aus \"1\"<\/code> wird 1<\/code> -, ist ein Unterschied von zwei Zeichen mit Folgen, die keine Hervorhebung vermittelt.<\/p>\n
Der umgekehrte Fall steht in der vierten Zeile des Diagramms: zwei Dateien, die sich in jeder Zeile unterscheiden und dasselbe Objekt beschreiben. Ein Vergleich von Text kann immer nur Fragen \u00fcber Text beantworten – und die Frage, die tats\u00e4chlich gestellt wird, ob sich die Konfiguration ge\u00e4ndert hat, ist eine Frage \u00fcber Struktur.<\/p>\n
Was stattdessen zu vergleichen ist, wenn es auf die Antwort ankommt<\/h2>\n
Bei allem, was ein Schema hat, ist der ehrliche Vergleich der zwischen zerlegten Objekten und nicht der zwischen Dateien. jq<\/code> kann das unmittelbar: Zwei Dokumente sind gleich oder sie sind es nicht, und die Antwort ist ein einzelner Wahrheitswert, den Formatierung, Reihenfolge und Leerraum nicht ber\u00fchren.<\/p>\n
# ist es überhaupt dasselbe Objekt?\njq -e --slurpfile b neu.json '. == $b[0]' alt.json >\/dev\/null && echo \"gleich\"\n\n# welche Schlüssel der obersten Ebene weichen ab?\njq -n --slurpfile a alt.json --slurpfile b neu.json \\\n  '($a[0] | keys) as $ka | ($b[0] | keys) as $kb\n   | { nur_alt: ($ka - $kb), nur_neu: ($kb - $ka) }'<\/code><\/pre>\n
Dem Zeilenvergleich bleibt damit die Aufgabe, die er gut kann: einem Menschen zu zeigen, was ein anderer getan hat, in einer Form, die sich liest wie die Datei, die er bearbeiten wird. Er beantwortet sehr gut, worauf zu schauen ist, und \u00fcberhaupt nicht, ob etwas dasselbe ist – und der meiste \u00c4rger mit ihm kommt daher, dass ihm die zweite Frage gestellt wird.<\/p>\n
\n
Quellen<\/h2>\n