JSON Schlüssel sortieren: Was die Sortierung tatsächlich ändert

Inhalt
Das Sortieren von JSON-Schlüsseln ändert nur die Reihenfolge der Eigenschaften eines Objekts (object) – alphabetisch oder in umgekehrter Reihenfolge. Die Reihenfolge der Elemente in einem Array und die Datenwerte selbst bleiben unangetastet. Die Funktion ist hilfreich, wenn Sie zwei JSON-Dateien oder API-Antworten, die zu unterschiedlichen Zeitpunkten gespeichert wurden, nebeneinander vergleichen möchten oder wenn Sie eine unübersichtliche Konfigurationsdatei aufräumen müssen. Nur wenn Sie genau wissen, welche Option wie weit sortiert, erhalten Sie das gewünschte Ergebnis.
Zusammenfassung ① Das Sortieren ändert nur die Reihenfolge der Schlüssel in Objekten. Die Reihenfolge der Array-Elemente und alle Werte bleiben erhalten. ② Erst mit der Option „Rekursiv sortieren“ werden auch die Schlüssel in verschachtelten Objekten und in Objekten innerhalb von Arrays sortiert. Ist sie ausgeschaltet, werden nur die Schlüssel der obersten Ebene sortiert. ③ Ist die JSON-Syntax fehlerhaft, erscheint statt eines Sortierergebnisses nur die Fehlermeldung, die der Browser selbst ausgibt.
Warum die Schlüsselreihenfolge überhaupt variiert
Bei API-Antworten und Konfigurationsdateien kann sich die Reihenfolge der Schlüssel bei jeder Erzeugung ändern. Je nachdem, in welcher Reihenfolge der Code einem Objekt Eigenschaften hinzufügt oder eine Bibliothek Werte ausgibt, kann die Reihenfolge der Schlüssel selbst bei JSON mit identischem Inhalt jedes Mal anders sein.
Vergleichen Sie in diesem Zustand das gestern gespeicherte JSON mit dem heute empfangenen per Diff oder mit bloßem Auge, scheinen die Werte zwar identisch zu sein, nur die Zeilenpositionen unterscheiden sich – echte Unterschiede sind dadurch schwer zu finden. Bringen Sie die Schlüssel nach derselben Regel (alphabetisch) in eine einheitliche Reihenfolge, verschwindet dieses Rauschen, und nur die tatsächlich geänderten Werte fallen auf.
Allerdings „räumt“ das Sortieren keinen Inhalt auf. Es ändert ausschließlich die Reihenfolge, in der die Schlüssel aufgelistet werden. Wer diese Grenze genau kennt, interpretiert das Ergebnis nicht falsch.
Schlüssel ohne Tool von Hand sortieren
JSON-Schlüssel lassen sich auch ohne Browser oder zusätzliches Tool im Terminal oder mit wenigen Zeilen Code sortieren. Es gibt zwei gängige Wege:
- Mit jq: Das Kommandozeilenwerkzeug jq zur Verarbeitung von JSON hat die Option
-S(sortieren). Mitjq -S '.' data.jsonerhalten Sie eine Ausgabe, in der die Objektschlüssel auf allen Ebenen alphabetisch sortiert sind. - Mit Python: Mit
python3 -c "import json;print(json.dumps(json.load(open('data.json')),sort_keys=True,indent=2))"erhalten Sie ebenfalls ein Ergebnis, in dem die Schlüssel auf allen Ebenen sortiert sind.
Bei beiden Methoden können Sie nicht zwischen „nur oberste Ebene sortieren“ und „vollständig rekursiv sortieren“ wählen: Ist die Sortierung aktiv, werden immer alle Ebenen sortiert. Die Reihenfolge der Arrays selbst lassen dagegen beide Methoden unangetastet. Sowohl jq als auch Python behandeln Arrays als geordnete Listen und ordnen sie nicht neu an.
Syntaxfehler vorab prüfen
Ob die Syntax korrekt ist, können Sie vorab mit python3 -m json.tool data.json prüfen. Ist das JSON fehlerhaft, erscheint ein Fehler, der angibt, in welcher Zeile und Spalte das Problem aufgetreten ist. Ist es korrekt, wird das formatierte Ergebnis ausgegeben.
Statt jedes Mal einen Befehl einzutippen, können Sie dasselbe auch im Browser per Einfügen prüfen. Mit unserem Tool „JSON-Formatierer mit Schlüsselsortierung“ prüfen.
Sortiert und formatiert Ihr JSON direkt im Browser. Die Daten werden nicht an einen Server übertragen.

Vor und nach dem Sortieren: ein konkretes Beispiel
Vergleichen wir anhand des folgenden JSON den Zustand vor und nach dem Sortieren.
{
"name": "Kabellose Ohrhörer",
"price": 89000,
"stock": { "seoul": 12, "busan": 5, "daegu": 20 },
"reviews": [
{ "rating": 5, "comment": "Gefällt mir" },
{ "rating": 3, "comment": "Durchschnittlich" }
]
}
Rekursion aus: Nur die äußeren Schlüssel werden sortiert
Wenn Sie nur „Schlüssel alphabetisch sortieren“ aktivieren und die rekursive Option ausgeschaltet lassen, sieht das Ergebnis so aus:
{
"name": "Kabellose Ohrhörer",
"price": 89000,
"reviews": [
{ "rating": 5, "comment": "Gefällt mir" },
{ "rating": 3, "comment": "Durchschnittlich" }
],
"stock": { "seoul": 12, "busan": 5, "daegu": 20 }
}
Nur die Schlüssel der äußersten Ebene (name, price, reviews, stock) wurden alphabetisch neu angeordnet. Die Reihenfolge der beiden Rezensionen im Array reviews, die Reihenfolge von rating und comment in jedem Rezensionsobjekt und die Reihenfolge von seoul, busan und daegu in stock sind unverändert.
Rekursion an: Auch innere Objekte und Objekte in Arrays werden sortiert
Schalten Sie im selben Zustand zusätzlich „Rekursiv sortieren“ ein, ändert sich das Ergebnis:
{
"name": "Kabellose Ohrhörer",
"price": 89000,
"reviews": [
{ "comment": "Gefällt mir", "rating": 5 },
{ "comment": "Durchschnittlich", "rating": 3 }
],
"stock": { "busan": 5, "daegu": 20, "seoul": 12 }
}
Die Schlüssel des Objekts stock sind nun in der Reihenfolge busan, daegu, seoul sortiert, und auch die Schlüssel jedes Rezensionsobjekts im Array reviews stehen in der Reihenfolge comment, rating. Die Reihenfolge der beiden Rezensionen im Array reviews selbst ist jedoch weiterhin unverändert: Die Rezension mit der Bewertung 5 steht nach wie vor an erster Stelle. Die rekursive Option wirkt nur auf die Schlüsselreihenfolge von Objekten und greift nicht in die Reihenfolge der Elemente eines Arrays ein.
Die Einrückung ändert nur die Optik
Die Auswahl der Einrückung (2 Leerzeichen/4 Leerzeichen/Tab) hat keinen Einfluss auf das Sortierergebnis oder die Werte, sondern ändert lediglich die Breite des Leerraums am Zeilenanfang. Geben Sie dasselbe Sortierergebnis jeweils mit 2 und mit 4 Leerzeichen aus, sieht es so aus:
{
"a": 1,
"b": 2
}
{
"a": 1,
"b": 2
}
Wählen Sie Tab, wird statt mit Leerzeichen mit Tabulatorzeichen eingerückt. Die Breite, in der ein Tab angezeigt wird, hängt von der Tabulatorbreite in den Einstellungen Ihres Code-Editors ab.
Fehlermeldung bei fehlerhafter Syntax
Ist auch nur ein Teil der JSON-Syntax fehlerhaft, erscheint gar kein Sortierergebnis, sondern nur eine Fehlermeldung, dass das Parsen fehlgeschlagen ist. Geben Sie zum Beispiel {"a":1 ein, bei dem die schließende geschweifte Klammer fehlt, meldet der Browser einen Fehler wie „Unexpected end of JSON input“, also dass die Eingabe mittendrin abbricht.
Auch wenn nach dem letzten Eintrag ein überzähliges Komma steht wie in {"a":1,"b":2,} oder wenn Schlüssel ohne Anführungszeichen geschrieben sind wie in {a:1}, schlägt das Parsen fehl. In diesem Fall erscheint ein Fehler mit Positionsangabe, an welchem Zeichen das Problem aufgetreten ist. Der genaue Wortlaut und die Schreibweise der Position unterscheiden sich je nach Browser (JavaScript-Engine) und Version leicht.
Eines haben alle Fälle gemeinsam: Das Tool erzeugt keine eigenen Fehlertexte, sondern zeigt den Fehler an, den die JavaScript-Engine tatsächlich ausgegeben hat. Anhand der in der Fehlermeldung genannten Position können Sie an dieser Stelle Kommas, Anführungszeichen und Klammern prüfen.
Häufige Irrtümer und Fehler
Diese Irrtümer kommen bei der ersten Nutzung der Sortierfunktion häufig vor:
| Irrtum | Tatsächliches Verhalten |
|---|---|
| Beim Sortieren ändert sich auch die Reihenfolge von Arrays | Die Reihenfolge der Array-Elemente bleibt unabhängig von der Sortieroption immer unverändert |
| Es genügt, das Sortier-Kontrollkästchen zu aktivieren, damit auch verschachtelte Objekte sortiert werden | „Rekursiv sortieren“ muss separat aktiviert werden, damit auch innere Objekte sortiert werden |
| Beim Sortieren werden auch die Werte (value) umgestellt | Geändert wird nur die Reihenfolge der Schlüssel, die Werte bleiben exakt wie im Original |
| Bei kleineren Syntaxfehlern wird automatisch aufgeräumt | Bei fehlerhafter Syntax schlägt bereits das Parsen fehl, und es erscheint überhaupt kein Ergebnis |
| Die umgekehrte Sortierung stellt die ursprüngliche (Eingabe-)Reihenfolge wieder her | Umgekehrt bedeutet Z–A, also die umgekehrte alphabetische Reihenfolge, nicht die ursprüngliche Eingabereihenfolge |
Zusammenfassung
- Das Sortieren ändert nur die Reihenfolge der Objektschlüssel in alphabetischer (oder umgekehrter) Reihenfolge. Die Reihenfolge der Array-Elemente und alle Werte bleiben erhalten.
- Ist „Rekursiv sortieren“ ausgeschaltet, werden nur die Schlüssel der äußersten Ebene sortiert. Ist es eingeschaltet, werden auch die Schlüssel verschachtelter Objekte und von Objekten in Arrays sortiert.
- Die Einrückung (2 Leerzeichen/4 Leerzeichen/Tab) ist reine Formatierung für die bessere Lesbarkeit und hat keinen Einfluss auf Sortierergebnis oder Werte.
- Ist die JSON-Syntax fehlerhaft, wird statt eines Ergebnisses die Fehlermeldung angezeigt, die die JavaScript-Engine tatsächlich ausgegeben hat.
- Mit jq -S oder Python sort_keys=True lässt sich dieselbe Aufgabe auch von Hand erledigen. Beide sortieren jedoch immer vollständig rekursiv, sodass sich „nur oberste Ebene sortieren“ nicht auswählen lässt.
Sortiert und formatiert Ihr JSON direkt im Browser. Die Daten werden nicht an einen Server übertragen.
Häufig gestellte Fragen
Ändern sich beim Sortieren auch die Werte der Originaldaten?
Nein. Geändert wird nur die Reihenfolge, in der die Schlüssel innerhalb eines Objekts aufgeführt sind. Die Werte selbst, etwa Strings, Zahlen oder Booleans, bleiben vollkommen unverändert. Auch die JSON-Spezifikation (RFC 8259) legt die Reihenfolge der Objektmitglieder nicht als bedeutungstragende Information fest. Das Sortieren ordnet die Einträge also lediglich so an, dass sie für Menschen leichter lesbar sind, und verändert die Bedeutung der Daten nicht.
Werden auch numerische Schlüssel in der Reihenfolge 1, 2, 10 sortiert?
Nein. Beim Sortieren werden die Schlüssel als Zeichenketten verglichen. Auch Schlüssel, die wie Zahlen aussehen, etwa "10" und "2", werden daher Zeichen für Zeichen verglichen. Da die „1“ vor der „2“ kommt, steht "10" vor "2". Das Ergebnis entspricht einer lexikografischen (zeichenweisen) Sortierung.
Wie kann ich die Reihenfolge von Objekten innerhalb eines Arrays ändern?
Mit dieser Funktion ist das nicht möglich. Die Sortieroption ändert nur die Reihenfolge der Schlüssel eines Objekts. Auf die Reihenfolge der Elemente eines Arrays hat sie keinen Einfluss, auch wenn die rekursive Option aktiviert ist. Um die Reihenfolge der Elemente selbst zu ändern, ist ein separater Sortiervorgang nötig.
Wird das eingegebene JSON an einen Server übertragen?
Nein. Parsen, Sortieren und Formatieren finden ausschließlich in Ihrem Browser statt. Es werden keine Daten an einen Server übertragen.
Dieser Artikel basiert auf unserem koreanischen Original. Koreanisches Original lesen