What Does Flattening a JSON Mean? Der Begriff erklärt (Anleitung 2026)

Das Wort selbst: was "flach" bei Daten bedeutet

Vergessen Sie JSON für einen Moment und stellen Sie sich das Wort vor. Eine flache Oberfläche hat keine Unebenheiten, keine Schichten, keine verborgene Tiefe: Alles liegt auf derselben Ebene, auf einmal sichtbar. Datenleute haben sich dieses Bild ausgeliehen. Flache Daten sind Daten ohne Verschachtelung: Jeder Wert sitzt auf der obersten Ebene, ein Wert pro Platz, nichts in irgendetwas anderem versteckt.

Eine Tabellenzeile ist das reinste Beispiel für flache Daten. Eine Zeile, ein Satz Spalten, ein Wert pro Zelle. Der Wert in Zelle C4 enthält keine weitere Tabelle. Er enthält Text, oder eine Zahl, oder nichts. Das ist flach.

JSON dagegen ist fast nie flach. Es verschachtelt: Objekte halten Objekte, Arrays halten Objekte, Objekte halten Arrays. Ein Kundendatensatz kann ein Adressobjekt tragen, das Koordinaten trägt, die ein Zahlenpaar tragen. Diese Verschachtelung ist der ganze Sinn von JSON, und sie ist auch der Grund, warum es das Wort "abflachen" überhaupt gibt. Man kann einen Baum nicht in eine Tabelle gießen, ohne etwas mit den Ästen zu tun. Abflachen ist der Name für dieses Etwas.

Wenn also jemand sagt "flache das JSON ab", meint er: Schreibe diese verschachtelte Struktur so um, dass jeder Wert auf der obersten Ebene lebt, mit Namen, die festhalten, woher er kam. Der Wert selbst ändert sich nicht. Seine Adresse ändert sich, von einem Pfad durch verschachtelte Objekte zu einem einzigen flachen Namen.

Warum es das Wort gibt: JSON verschachtelt, CSV nicht

Hier ist die Spannung in einem Bild. JSON ist ein Baum: Äste, Unteräste, Blätter. CSV ist eine Tabelle: Zeilen und Spalten, und nichts Tieferes. Eine CSV-Zelle kann kein Objekt halten. Sie kann nur Text halten. Jede Umwandlung von JSON in CSV muss also dieselbe Frage beantworten: Was machen wir mit der Verschachtelung?

Es gibt nur wenige mögliche Antworten, und "Abflachen" ist die häufigste. Nehmen Sie diesen echten Datensatz, wie ihn eine API zurückgeben könnte:

Nested: the address object lives inside the customer record

{
  "id": "A-101",
  "customer": { "name": "Amelia", "city": "Austin" },
  "tags": ["new", "vip"]
}

Das customer-Objekt liegt eine Ebene tiefer. Die tags-Liste liegt eine Ebene tiefer. Eine CSV kennt kein "eine Ebene tiefer", also zieht die abgeflachte Version alles an die Oberfläche. Verifizierte Ausgabe des Konverters auf dieser Seite:

Was das Abflachen tatsächlich tut, Schritt für Schritt

Abflachen ist kein einziger Trick, es sind vier kleine Regeln, überall angewendet. Führen Sie den Datensatz oben mit eingeschaltetem Abflachen durch den Konverter auf dieser Seite, und genau das kommt heraus, verifiziert auf der Build-Maschine:

Flattened: depth 1, one value per slot (verified converter output)

{
  "id": "A-101",
  "customer.name": "Amelia",
  "customer.city": "Austin",
  "tags": "new; vip"
}

Regel eins: Verschachtelte Objekte werden zu Spalten in Punktnotation. Der Pfad zum Wert wird zum Namen: customer.name, customer.city. Die Punkte sind nur eine Brotkrumenspur. Amelias Name hat sich nicht geändert, nur seine Adressbezeichnung.

Regel zwei: Kurze Listen einfacher Werte werden zu einer Zelle verbunden. Aus "new" und "vip" wurde der einzelne Text "new; vip". Die beiden Werte sind noch da, aber sie sind jetzt eine Zeichenkette mit einem Trennzeichen, und dass es zwei waren, ist nicht mehr maschinenlesbar.

Regel drei: Listen von Objekten lassen sich nicht sinnvoll verbinden, also kollabieren sie zu JSON-Text in einer einzigen Zelle. Eine Artikelliste wie [{"sku":"B1","qty":2}] wird zu einer langen Zelle in Anführungszeichen. Die Daten überleben, aber als Text, den Sie erneut parsen müssten, nicht als Struktur.

Regel vier: Null und leere Werte werden zu leeren Zellen. Es gibt keine Art, "ausdrücklich nichts" in einer flachen Tabelle zu schreiben, also verschwindet null einfach in einer leeren Zelle. Merken Sie sich diese Regel: Nach dem Abflachen können Sie "war null" nicht mehr von "war eine leere Liste" oder "fehlte ganz" unterscheiden.

Vergleichen Sie das mit ausgeschaltetem Abflachen auf denselben Daten, und der Unterschied ist die ganze Bedeutung des Wortes. Bei ausgeschaltetem Schalter bleibt das customer-Objekt als eine Zelle mit JSON-Text: {"name":"Amelia","city":"Austin"}. Die Daten gehen nicht verloren, aber sie sind auch nicht flach: Es steckt noch Verschachtelung in der Zelle, und eine Tabellenkalkulation zeigt Ihnen einen unleserlichen Klumpen. Flach heißt flach bis ganz nach unten, ein Wert pro Zelle, keine Ausnahmen.

Die zu klärende Verwechslung: Abflachen ist nicht Minifizieren

Fragen Sie fünf Anfänger, was "ein JSON abflachen" bedeutet, und einer von ihnen tut dies: alle Zeilenumbrüche und Leerzeichen löschen und eine einzige riesige Zeile erzeugen. Das ist Minifizieren, nicht Abflachen, und die Unterscheidung zählt, weil die Wörter verwandt klingen, aber völlig verschiedene Dinge beschreiben.

Minifizieren ändert Leerzeichen. Abflachen ändert Struktur. Eine minifizierte JSON-Datei ist immer noch verschachtelt, sie ist nur auf einer Zeile verschachtelt. Auf der Build-Maschine verifiziert: Das Parsen der minifizierten und der hübsch eingerückten Version desselben Datensatzes erzeugt Byte-identische Strukturen, und das customer-Objekt ist in beiden Fällen immer noch ein Objekt. Der Baum hat sich nicht bewegt. Nur der Anstrich hat sich geändert.

Minified is still nested (depth 2); flattened is depth 1

# minified: no whitespace, STILL nested -> customer is an object
{"id":"A-101","customer":{"name":"Amelia","city":"Austin"},"tags":["new","vip"]}

# flattened: depth 1, nothing nested at any width
{"id":"A-101","customer.name":"Amelia","customer.city":"Austin","tags":"new; vip"}

Warum passiert die Verwechslung? Weil "flach" in der Umgangssprache manchmal "eine Zeile" bedeutet, wie in "mache das flach zu einer Zeile". In der Datenarbeit bedeutet "flach" "keine Verschachtelung". Wenn Ihnen ein Tutorial sagt, Sie sollten JSON vor dem Import in eine Tabellenkalkulation abflachen, meint es die strukturelle Art: Spalten in Punktnotation, verbundene Listen, ein Wert pro Zelle. Leerzeichen zu löschen hilft Ihrem Import kein bisschen.

Dieselbe Idee trägt unterschiedliche Namen

Sobald Sie wissen, was Abflachen bedeutet, sehen Sie es überall, in unterschiedlichen Kleidern. In Pythons pandas-Bibliothek heißt die Funktion json_normalize, und "normalize" macht genau den Abflach-Job: Verschachtelte Objekte werden zu Spalten in Punktnotation. In unseren früheren Tests verifiziert: Sie flacht customer.address zu customer.city ab, genau wie der Konverter auf dieser Seite.

In Excels Power Query heißt die Schaltfläche "Erweitern": Sie klicken den kleinen Doppelpfeil auf einer Spalte mit verschachtelten Datensätzen, und er erweitert sie zu neuen Spalten. Dieselbe Idee, freundlicheres Verb. In SQL verwandelt UNNEST ein verschachteltes Array in Zeilen. Dieselbe Familie.

Eine ehrliche Warnung: In jq, dem Kommandozeilen-JSON-Werkzeug, bedeutet "flatten" etwas Engeres. jq kollabiert verschachtelte Arrays zu einem einzigen Array, es verwandelt keine Objekte in Punktnotation-Pfade. Wenn ein jq-Tutorial "flatten" sagt, prüfen Sie, welche Bedeutung es meint, bevor Sie etwas annehmen. Die Datenwelt verwendet ihre Wörter locker, und dies ist die eine Stelle, an der der Begriff sich wirklich spaltet.

Abflachen hat auch zwei enge Verwandte, die es wert sind, genannt zu werden, weil die Leute alle drei verwechseln. Abflachen behält eine Zeile pro Datensatz und verbreitert die Spalten. Explodieren behält die Spalten und vervielfacht die Zeilen: eine Zeile pro Listenelement. Verbinden faltet eine Liste in eine einzelne Zelle, was Regel zwei oben mit kurzen Listen tut. Unser Guide "How to Flatten the JSON Data: Explodieren, Verbinden oder Verschachtelt Lassen (Anleitung 2026)" geht die Explodieren-oder-Verbinden-Entscheidung mit echten Beispielen durch, und der Guide "Verschachteltes JSON in CSV umwandeln: Was der Schalter wirklich tut (Anleitung 2026)" zeigt, was der Abflachen-Schalter des Konverters Zelle für Zelle tut.

Was das Abflachen kostet

Abflachen ist ehrliche Arbeit, aber es ist verlustbehaftete Arbeit, und die Verluste sind es wert, genannt zu werden, bevor Sie irgendetwas anklicken. Erstens: Die Form ist für immer weg. Nach dem Abflachen zeichnet nichts mehr auf, dass city und state Geschwister in einem Adressobjekt waren. Sie sind nur zwei Spalten, die zufällig ein Präfix teilen.

Zweitens: Die Punktnotation hat eine Mehrdeutigkeit, vor der niemand Sie warnt. Enthält Ihr JSON wörtlich einen Schlüssel namens "a.b" auf der obersten Ebene UND ein verschachteltes Objekt a mit Schlüssel b, flachen beide zum selben Spaltennamen ab, und ein Wert überschreibt den anderen stillschweigend. In der Praxis selten, brutal, wenn es trifft.

Drittens: Verbundene Listen verlieren ihre Anzahl als Information. "new; vip" sieht aus wie eine einzige Zeichenkette. Ein Programm, das die CSV liest, kann ohne Teilen am Trennzeichen nicht wissen, dass es zwei Tags waren, und enthält ein Tag selbst je ein Semikolon, bricht sogar das zusammen.

Viertens: Typen kollabieren. Aus 101 werden die Zeichen "101". Aus true werden die Zeichen "true". Was auch immer die CSV öffnet, entscheidet, was sie bedeuten, und Excel interpretiert Ihre Daten besonders gern um: Führende Nullen verschwinden, lange IDs werden zu wissenschaftlicher Notation. Die Werte haben das Abflachen überlebt; die Tabellenkalkulation überleben sie vielleicht nicht.

Nichts davon heißt, dass Abflachen falsch ist. Es heißt, dass Abflachen eine Einbahnstraße ist, und Sie sollten das ursprüngliche JSON als Ihre Quelle der Wahrheit behalten. Flachen Sie eine Kopie ab, arbeiten Sie auf der Kopie, und werfen Sie niemals den Baum weg, aus dem Sie sie abgeflacht haben.

Sollten Sie abflachen? Eine 60-Sekunden-Entscheidung

Ihr Ziel entscheidet, nicht Ihre Daten. Ist das Ziel eine Tabellenkalkulation, ein CSV-Import oder ein Mensch, der Zeilen überfliegt, flachen Sie ab: Genau dafür sind diese Werkzeuge gebaut, und eine abgeflachte Datei öffnet sich überall sauber.

Ist das Ziel ein anderes Programm, eine API oder ein Rückweg nach JSON später, flachen Sie nicht ab. Behalten Sie die Verschachtelung, denn jeder Abflach-Verlust von oben wird auf dem Rückweg zu einem Fehler, den Sie mühsam entwirren müssen.

Wenn Sie unsicher sind, flachen Sie eine Kopie ab und sehen Sie sie sich an. Öffnen Sie die CSV, prüfen Sie, dass die Spalten in Punktnotation sinnvoll aussehen, dass die verbundenen Listen richtig aussehen, dass nichts Wichtiges zu einem unleserlichen Klumpen wurde. Sechzig Sekunden Schauen schlägt eine Stunde Debuggen eines schlechten Imports.

Tabellenkalkulation, CSV-Import, menschliche Prüfung: Abflachen, genau das erwarten diese Werkzeuge.
API, Datenbank, Rückweg nach JSON: Verschachtelung behalten, Abflach-Verluste werden zu Fehlern.
Unsicher: Eine Kopie abflachen, öffnen und die Spalten prüfen, bevor Sie sich festlegen.

Probieren Sie es auf dieser Seite

Der Konverter oben auf dieser Seite flacht standardmäßig ab. Fügen Sie beliebiges verschachteltes JSON ein und beobachten Sie die Vorschau: Verschachtelte Objekte werden zu Spalten in Punktnotation, Listen verbinden sich mit "; ", und jede Zelle hält genau einen Wert. Schalten Sie das Abflachen aus und fügen Sie dasselbe JSON ein, um den Unterschied zu sehen, den das Wort macht: verschachtelte Klumpen in Zellen gegen eine saubere flache Tabelle. Dieser Vergleich nebeneinander, an Ihren eigenen Daten, ist der schnellste Weg, den Begriff zu verankern.

Wenn Ihr JSON Listen von Objekten enthält, die Sie wirklich als Zeilen wollen, reicht Abflachen allein nicht: Das ist Explodieren, eine andere Operation, und der Guide "How to Flatten the JSON Data: Explodieren, Verbinden oder Verschachtelt Lassen (Anleitung 2026)" behandelt genau, wann Sie stattdessen explodieren sollten.

Häufig gestellte Fragen

Was bedeutet das Abflachen eines JSON in einfachen Worten?

Es bedeutet, verschachteltes JSON so umzuschreiben, dass nichts mehr verschachtelt ist. Objekte in Objekten werden zu Namen in Punktnotation wie customer.city, kurze Listen werden zu einer verbundenen Zelle, und jeder Wert sitzt auf der obersten Ebene, einer pro Zelle. Das Ergebnis ist eine flache Tabelle, und genau die brauchen CSV-Dateien und Tabellenkalkulationen.

Ist das Abflachen von JSON dasselbe wie das Minifizieren?

Nein, und das ist die häufigste Verwechslung. Minifizieren entfernt Leerzeichen und erzeugt eine lange Zeile, die immer noch vollständig verschachtelt ist. Abflachen ändert die Struktur selbst und zieht verschachtelte Werte auf die oberste Ebene. Eine minifizierte Datei parst zum exakt selben Baum; eine abgeflachte Datei ist eine andere, flachere Form.

Verändert das Abflachen einer JSON-Datei meine Daten?

Es verändert die Form, nicht die Werte. Jeder Blattwert überlebt, aber Verschachtelung wird zu Spalten in Punktnotation, Listen werden zu verbundenem Text, Typen kollabieren zu Text, und null wird zu einer leeren Zelle. Behalten Sie das ursprüngliche JSON als Ihre Quelle der Wahrheit und betrachten Sie die abgeflachte Datei als Arbeitskopie.

Was ist der Unterschied zwischen Abflachen und Explodieren von JSON?

Abflachen behält eine Zeile pro Datensatz und verbreitert die Spalten: Verschachtelte Pfade werden zu neuen Spalten. Explodieren behält die Spalten und vervielfacht die Zeilen: Jedes Element in einer Liste bekommt seine eigene Zeile, der Rest des Datensatzes wird wiederholt. Flachen Sie einen Kunden mit drei Tags ab, erhalten Sie eine Zeile mit einer "tag1; tag2; tag3"-Zelle; explodieren Sie ihn, erhalten Sie drei Zeilen. Unser Guide "How to Flatten the JSON Data: Explodieren, Verbinden oder Verschachtelt Lassen (Anleitung 2026)" behandelt, wann Sie welche wählen sollten.

Warum brauchen CSV-Dateien flache Daten?

Weil eine CSV nur Zeilen, Spalten und Text hat. Es gibt keinen Ort für Verschachtelung: Eine Zelle kann kein Objekt enthalten, nur Zeichen. Verschachtelte Strukturen müssen also abgeflacht (oder als JSON-Text in einer Zelle verpackt) werden, bevor sie in einer CSV überhaupt leben können.

Kann man eine CSV-Datei zurück in verschachteltes JSON verwandeln?

Nur ungefähr. Spalten in Punktnotation wie customer.city lassen sich per Skript wieder zu verschachtelten Objekten gruppieren, und manche Werkzeuge tun das, aber die Information, die das Abflachen zerstört hat, ist weg: Verbundene Listen lassen sich nicht verlässlich zurück in Arrays teilen, Typen sind Ratesache, und null gegen fehlend ist nicht erkennbar. Wenn Sie die Verschachtelung zurückbrauchen, behalten Sie das ursprüngliche JSON.

Flacht der JSON-in-CSV-Konverter auf dieser Seite automatisch ab?

Ja, Abflachen ist standardmäßig eingeschaltet: Fügen Sie verschachteltes JSON ein, und die Vorschau zeigt sofort Spalten in Punktnotation. Sie können es ausschalten, dann bleiben verschachtelte Objekte und Arrays als JSON-Text in einzelnen Zellen. Für Tabellenkalkulations-Arbeit lassen Sie es eingeschaltet.

Abflachung live erleben

Fügen Sie verschachteltes JSON in den Konverter ein und sehen Sie, wie die Abflachung es in Punktnotation-Spalten verwandelt. Kostenlos, keine Anmeldung, läuft vollständig in Ihrem Browser.

Den JSON-zu-CSV-Konverter öffnen

Alle Anleitungen