CSV in JSON umwandeln

CSV ist ein flaches, zeilenbasiertes Format. Jede Zeile ist ein Datensatz, die Werte sind durch ein Trennzeichen wie Komma oder Semikolon getrennt. Das Format eignet sich gut für Tabellen, kennt aber keine verschachtelten Strukturen und keine Datentypen. Ein Wert ist immer nur Text.

JSON hingegen beschreibt Daten als Objekte und Arrays mit klaren Typen wie Zahl, Zeichenkette, Wahrheitswert oder null. Genau diese Struktur erwarten die meisten Programmierschnittstellen und modernen Anwendungen.

Bei der Umwandlung wird in der Regel die erste CSV-Zeile als Kopfzeile gelesen. Ihre Spaltennamen werden zu den Schlüsseln der JSON-Objekte. Jede weitere Zeile wird zu einem eigenen Objekt, in dem die Werte den passenden Schlüsseln zugeordnet werden.

So entsteht aus einer Tabelle mit Hunderten Zeilen ein sauberes Array aus Objekten. Wer den umgekehrten Weg braucht, nutzt den JSON zu CSV Konverter. Damit lässt sich derselbe Datenbestand jederzeit zwischen beiden Welten hin und her bewegen, ohne die Inhalte manuell neu zu tippen.

Der Konverter liest deine CSV-Eingabe Zeichen für Zeichen und erkennt zunächst das verwendete Trennzeichen. Unterstützt werden Komma, Semikolon und Tabulator, also die Varianten, die in Tabellenprogrammen und Datenbank-Exporten üblich sind.

Die erste Zeile dient als Kopfzeile und liefert die Schlüssel. Anschließend wird jede Datenzeile in ein Objekt überführt. Felder in Anführungszeichen werden korrekt behandelt, sodass ein Trennzeichen innerhalb eines Wertes nicht versehentlich eine neue Spalte erzeugt. Auch mehrzeilige Werte und maskierte Anführungszeichen bleiben erhalten.

Das Ergebnis kannst du in zwei Formen ausgeben:

• JSON-Array: alle Datensätze in einer Liste, ideal für komplette Antworten
• NDJSON: ein Objekt pro Zeile, gut für Streaming und große Datenmengen

Eine kurze Eingabe wie

`` name,alter Anna,30 ``

wird zu [{"name":"Anna","alter":"30"}]. Zahlen bleiben dabei standardmäßig als Text erhalten, weil CSV selbst keine Typen kennt. Für die anschließende Lesbarkeit hilft der JSON Formatter, der die Ausgabe sauber einrückt.

CSV ist das Standardformat, wenn Daten eine Tabellenkalkulation oder ein Datenbanksystem verlassen. Doch sobald diese Daten in eine Webanwendung oder eine Schnittstelle fließen sollen, wird JSON gebraucht. Genau an dieser Stelle setzt der Konverter an.

Häufige Situationen sind:

• Tabellen in Anwendungen importieren: Ein Export aus einem Tabellenprogramm wird zu JSON, das eine Anwendung direkt verarbeiten kann.
• Schnittstellen befüllen: Datenbank-Exporte werden in das Format gebracht, das eine API als Anfrage oder Antwort erwartet.
• Datenpipelines: In einem Transformationsschritt wird CSV in JSON umgewandelt, bevor die Daten weiterverarbeitet werden.
• Migration: Beim Wechsel von einem flachen Dateiformat zu strukturierten Daten dient die Umwandlung als erster Schritt.

Kommt die Quelle aus anderen Formaten, helfen verwandte Werkzeuge. Für Konfigurationsdateien eignet sich der YAML zu JSON Konverter, für Datenexporte mit Tags der XML zu JSON Konverter. So lässt sich nahezu jede Quelle auf ein einheitliches JSON-Ziel bringen.

Nicht jede CSV-Datei sieht gleich aus. Im deutschsprachigen Raum nutzen Tabellenprogramme oft das Semikolon als Trennzeichen, weil das Komma bereits als Dezimaltrennzeichen dient. Der Konverter erkennt das und ordnet die Spalten richtig zu.

Einige Fälle verdienen besondere Aufmerksamkeit:

Wichtig ist, dass die Kopfzeile eindeutige Spaltennamen enthält. Doppelte Namen würden beim Aufbau der Objekte zu Überschreibungen führen, da ein JSON-Objekt jeden Schlüssel nur einmal kennt.

Fehlt in einer Zeile ein Wert, entsteht ein leeres Feld statt eines fehlerhaften Objekts. Auf diese Weise bleibt die Struktur über alle 1.000 Zeilen hinweg stabil, auch wenn einzelne Datensätze lückenhaft sind.

Die reine Struktur lässt sich verlustfrei übertragen: Jede Zelle deiner Tabelle findet sich als Wert im passenden JSON-Objekt wieder. Reihenfolge und Anzahl der Datensätze bleiben erhalten.

Einen Punkt solltest du dennoch beachten. CSV speichert alles als Text und kennt keine Datentypen. Die Zahl 42 und die Zeichenkette 42 sehen in einer CSV-Datei identisch aus. Standardmäßig übernimmt der Konverter Werte deshalb als Zeichenketten, um nichts falsch zu interpretieren. Eine Postleitzahl mit führender Null bleibt so unversehrt.

Wer echte Zahlen oder Wahrheitswerte im JSON braucht, wandelt die betroffenen Felder im Anschluss gezielt um. Das ist eine bewusste Entscheidung und kein automatischer Schritt, weil sonst gültige Textwerte verfälscht werden könnten.

Prüfe nach der Umwandlung am besten kurz das Ergebnis. Stimmt die Zahl der Objekte mit den Datenzeilen überein und sind die Schlüssel korrekt benannt, ist die Umwandlung sauber gelaufen und das JSON bereit für den nächsten Verarbeitungsschritt.