JSON Toolkit

JSON-Arrays und -Objekte schreiben: Struktur und Verschachtelung für Einsteiger

Fazit: JSON kennt nur zwei Container: das Objekt für benannte Felder, das Array für geordnete Listen. Lernen Sie, beide zu kombinieren, das richtige zu wählen und die drei häufigsten Fehler zu korrigieren: Schein-Arrays mit numerischen Schlüsseln, abschließende Kommas und einfache Anführungszeichen.

Einsteiger~6 Min. LesezeitVeröffentlicht 2026-11-20Aktualisiert 2026-11-20
Einführungscover zu JSON-Array- und Objektstrukturen

JSON gibt Ihnen nur zwei Container: Das Objekt trägt benannte Felder, das Array trägt geordnete Listen — und fast jeder kaputte Payload erklärt sich durch Anführungszeichen, Kommas oder eine Liste, die als Schein-Objekt geschrieben wurde.

Erstens: JSON hat nur zwei Container

So komplex eine API-Antwort auch sein mag, sie reduziert sich auf zwei Container und sechs Wertetypen. Ein Objekt ist eine Sammlung von Schlüssel-Wert-Paaren in geschweiften Klammern {}; ein Array ist eine geordnete Liste von Werten in eckigen Klammern []. Ein Wert kann ein String, eine Zahl, true, false, null sein — oder wiederum ein Objekt oder Array. Objekte in Arrays, Arrays in Objekten: Diese Rekursion ist die gesamte Ausdruckskraft von JSON.

{
  "user": { "name": "Ada", "active": true },
  "roles": ["admin", "editor"],
  "lastLogin": null,
  "loginCount": 42
}

Daraus folgt eine praktische Konsequenz: Bei einem verwirrenden Payload nicht Zeichen für Zeichen lesen. Prüfen Sie zuerst, ob das äußerste Zeichen { oder [ ist. Bei einem Objekt lesen Sie es als benannte Felder; bei einem Array lesen Sie es als Liste und steigen dann Ebene für Ebene hinab. Das Syntaxdiagramm auf json.org passt auf eine einzige Seite, gerade weil zwei Strukturen plus Rekursion alles abdecken.

Zweitens: Objekte schreiben, vier harte Regeln

Objekte sind der Ort, an dem Einsteiger die meisten Fehler machen, aber die Regeln reduzieren sich auf vier:

  1. Schlüssel müssen Strings in doppelten Anführungszeichen sein. {name: "Ada"} und {'name': 'Ada'} sind beide ungültig; korrekt ist {"name": "Ada"}. JavaScript-Objektliterale erlauben nackte Schlüssel und einfache Anführungszeichen, JSON nicht — das ist die häufigste Verwechslung zwischen beiden.
  2. Trennen Sie Paare mit Kommas und lassen Sie niemals ein Komma nach dem letzten Paar stehen. {"a": 1, "b": 2,} schlägt mit Unexpected token } an der schließenden Klammer fehl.
  3. Schlüssel sollten eindeutig sein. RFC 8259 formuliert das als SHOULD, nicht MUST: Doppelte Schlüssel erzeugen keinen Fehler, aber ob der erste oder letzte Wert erhalten bleibt, hängt von der Implementierung ab, und die Sprachen weichen ab. Verlassen Sie sich nie darauf.
  4. Die Reihenfolge der Schlüssel hat keine Bedeutung. {"a":1,"b":2} und {"b":2,"a":1} sind dasselbe Objekt; Diff-Tools und Vergleichsfunktionen ignorieren die Schlüsselreihenfolge. Wenn die Reihenfolge zählt, gehören die Daten in ein Array.

Drittens: Arrays schreiben, die Reihenfolge ist Daten

Arrays speichern Werte nach Position, und die Indizierung beginnt bei 0: In ["admin", "editor"] ist der String "editor" das [1]. Diese Reihenfolge ist bedeutsam — das ist der wesentliche Unterschied zwischen Arrays und Objekten. Nach Relevanz sortierte Suchergebnisse, nach Datum geordnete Log-Einträge: Diese Information lebt nur in der Sequenz, und die Umwandlung in ein Objekt zerstört sie.

Zwei praktische Empfehlungen. Erstens: Halten Sie die Elemente homogen. [{"id":1},{"id":2}] ist deutlich einfacher zu verarbeiten als [1, "text", true] — legal, aber jeder Consumer muss an jedem Schritt die Typen prüfen. Zweitens: Ein leeres Array [] ist ein völlig gültiger Wert. Wenn ein Listenfeld noch keinen Inhalt hat, geben Sie [] statt null aus, damit der Consumer nicht erst die Existenz und dann die Leere prüfen muss.

[
  { "city": "Tokyo", "population": 13960000 },
  { "city": "Delhi", "population": 16780000 }
]

Viertens: Verschachtelung, die vier Formen echter Payloads

Reale Daten sind nur diese zwei Container, ineinander verschachtelt, und die Muster reduzieren sich auf vier Formen:

Form Wie es aussieht Typischer Einsatz
Objekt enthält Array {"tags": ["a","b"]} Listenfeld einer Entität
Array von Objekten [{"id":1},{"id":2}] Datensatzlisten, paginierte Ergebnisse
Objekt enthält Objekt {"db": {"host": "..."}} Gruppierte Konfiguration, Adressblöcke
Array von Arrays [[1,2],[3,4]] Matrizen, Tabellenzeilen

Eine typische API-Antwort nutzt ein Objekt als Hülle und ein Array als Inhalt:

{
  "code": 0,
  "data": {
    "items": [
      { "id": 1, "title": "first" },
      { "id": 2, "title": "second" }
    ],
    "page": 1,
    "total": 2
  }
}

Verschachteln Sie nicht um des Verschachtelns willen. Jenseits von drei bis vier Ebenen werden Zugriffspfade unlesbar, und der Consumer-Code schwillt parallel an. Felder, die immer zusammen reisen, gehören in ein Unterobjekt: Ersetzen Sie addrCity und addrZip durch address: {city, zip}.

Fünftens: Objekt oder Array, eine Entscheidungstabelle

Frage Antwort Warum
Hat jeder Wert einen Namen? Objekt Zugriff per Schlüssel; Felder hinzufügen oder entfernen bricht nichts
Ist es eine Liste ähnlicher Datensätze? Array Reihenfolge zählt; map und filter sind möglich
Schneller Schlüsselzugriff nötig? Objekt, nach ID indiziert O(1)-Zugriff statt Durchlauf
Mehrere Attribute einer Entität? Objekt Attribute haben keine inhärente Reihenfolge
Wachsende Sammlung ähnlicher Elemente? Array Die Länge dehnt sich frei

Ein Anti-Pattern verdient eigene Erwähnung: ein Array mit einem Objekt zu imitieren, dessen Schlüssel "0", "1", "2" sind. Es parst ohne Fehler, aber Sie verlieren die Längensemantik und die Iterationswerkzeuge eines echten Arrays, und Consumer müssen Object.keys sortieren, bevor sie irgendetwas lesen. Wenn die Schlüssel fortlaufende Nummern sind, schreiben Sie ein echtes Array. Umgekehrt gilt: Eine Liste von Schlüssel-Wert-Paaren wie [{"key":"theme","value":"dark"}] ist schlechter als das Objekt {"theme": "dark"} — außer die Schlüssel sind wirklich dynamisch und lassen sich nicht vorab deklarieren.

Sechstens: drei häufige Fehler und ihre Meldungen

Fehlerhafte Form Typischer Fehler Korrektur
Abschließendes Komma {"a":1,} Unexpected token } Letztes Komma entfernen
Einfache Anführungszeichen / nackte Schlüssel {name:'Ada'} Unexpected token ' / Expected property name Doppelte Anführungszeichen für Schlüssel und Strings, immer
Python-Literale True / None Unexpected token T Ersetzen durch true / null
Schein-Array mit numerischen Schlüsseln Kein Fehler, falsche Semantik Als echtes Array umschreiben

Zwei Debug-Gewohnheiten: Parser melden die Position meist nach dem fehlerhaften Zeichen — wenn Sie also position 42 sehen, schauen Sie ein bis zwei Zeichen zurück; und einen riesigen Einzeiler-JSON zuerst formatieren — Zeilen- und Spaltennummern schlagen Zeichenoffsets jedes Mal. Der komplette Fehlerkatalog steht in der JSON-Fehler-Lookup-Tabelle, der Schritt-für-Schritt-Triage-Ablauf in JSON-Parse-Fehler beheben.

Siebtens: nach dem Schreiben die Struktur prüfen

Handgeschriebenes JSON sollte vor der Übergabe immer durch einen Parser laufen. Die leichteste Prüfung ist ein Einzeiler:

python3 -m json.tool config.json > /dev/null && echo OK
jq empty config.json && echo OK

Online fügen Sie den Inhalt auf der Seite JSON-Formatierer und -Validator ein — Syntaxfehler kommen mit Zeile und Spalte zurück. Wechseln Sie in die Baumansicht, um den Typ jeder Ebene auf einen Blick zu sehen: ob eine Zahl als String interpretiert wurde, ob die Array-Längen stimmen. Und wenn das Publikum nicht technisch ist, lässt sich ein Array-of-Objects-Payload auf der Seite JSON zu Tabelle in Zeilen und Spalten entfalten — das prüft nebenbei, ob Ihre Daten wirklich eine reguläre Datensatzliste sind.

Fragen zum Feld, das ein Array hätte sein sollen, oder zur Umgestaltung einer zu tiefen Verschachtelung gehören zur Typmodellierung — die nächste Lektüre ist sechs Typen, Zahlenpräzision und Encoding-Fallstricke.

Kann man JSON-Arrays und -Objekte ineinander umwandeln?

Ja, aber nicht verlustfrei. Ein Objekt in ein Array umzuwandeln bedeutet meist, Schlüssel in Werte zu verwandeln und den Schlüsselzugriff zu verlieren; ein Array in ein Objekt umzuwandeln erfordert, für jedes Element einen Schlüssel zu erfinden, und die Herkunft dieser Schlüssel ist ein neues Designproblem. Entscheiden Sie danach, wie der Consumer die Daten liest, nicht nach syntaktischer Bequemlichkeit.

Dürfen Objektschlüssel doppelt vorkommen?

Syntaxtechnisch ja — RFC 8259 sagt nur, dass Schlüssel eindeutig SEIN SOLLTEN. Aber JavaScript behält den letzten Wert, während manche Bibliotheken der C-Familie den ersten behalten: Das Verhalten unterscheidet sich zwischen Parsern. In Signaturen, Diffs oder Hashes führen doppelte Schlüssel zu direkten Diskrepanzen. Vermeiden Sie sie auf der Produzentenseite und behandeln Sie Duplikate aus unbekannten Quellen als Risiko auf der Consumer-Seite.

Kann ein Array Werte unterschiedlicher Typen enthalten?

Syntaxtechnisch ja: [1, "a", true] ist gültiges JSON. Aber heterogene Arrays erzwingen Typprüfungen an jeder Position im Consumer-Code, und sie lassen sich schwer in einem Schema ausdrücken. Außer bei Matrizen und Tupeln, wo die Position die Semantik ist, halten Sie Arrays homogen.

Warum scheitert {name:'json'} an der Validierung?

Weil JSON doppelte Anführungszeichen um jeden Schlüssel und jeden String-Wert verlangt. {name:'json'} ist ein JavaScript-Objektliteral, kein JSON. Ersetzen Sie es durch {"name": "json"}, und die Validierung geht durch. Einfache Anführungszeichen, nackte Schlüssel und Kommentare gehören zu Dialekten wie JSON5/JSONC, die eigene Parser statt des Standard-JSON.parse erfordern.