CSV und JSON: zwei Wege, dieselben Daten zu tragen
Die meisten tabellarischen Daten landen in einem von zwei Formaten. CSV ist die Muttersprache der Tabellenkalkulation: eine reine Textdatei, in der jede Zeile eine Reihe ist und Kommas die Spalten trennen. JSON ist die Sprache von APIs und Apps: ein strukturiertes Textformat, aufgebaut aus Objekten (Schlüssel-Wert-Paaren) und Arrays (geordneten Listen). Sie beschreiben dieselbe Information in sehr unterschiedlichen Formen, und genau deshalb kommt das Umwandeln zwischen ihnen so oft vor. Diese Seite erledigt diese Umwandlung in beide Richtungen, vollständig in Ihrem Browser.
CSV glänzt überall dort, wo sich ein Raster natürlich anfühlt. Exportieren Sie einen Bericht aus einer Datenbank, laden Sie eine Bestellliste herunter oder speichern Sie ein Blatt aus Excel oder Google Sheets, und Sie bekommen fast immer CSV. Es ist kompakt, menschenlesbar, und jedes Analysewerkzeug der Welt kann es öffnen. JSON glänzt überall dort, wo Software mit Software spricht. REST-APIs senden und empfangen es, Konfigurationsdateien nutzen es, und JavaScript liest es ohne jede Parsing-Bibliothek. Wenn Sie einen Tabellen-Export in eine API einspeisen oder eine API-Antwort in eine Tabelle ziehen müssen, übersetzen Sie eigentlich zwischen diesen zwei Welten.
Wie Zeilen und Kopfzeilen zu Objekten werden
Die Zuordnung ist einfacher, als sie aussieht. Die erste Zeile einer CSV-Datei ist meist die Kopfzeile, und diese Kopfnamen werden zu den Schlüsseln in JSON. Jede folgende Zeile wird zu einem Objekt, in dem jede Zelle mit der passenden Kopfzeile gepaart wird. Die ganze Datei wird zu einem Array dieser Objekte. So wird ein CSV mit den Spalten name,email,age zu einer Liste wie [{"name": "Ada", "email": "ada@example.com", "age": "36"}, ...]. In die andere Richtung liest JSON zu CSV die Schlüssel des ersten Objekts, um die Kopfzeile zu bauen, und schreibt dann eine Zeile pro Objekt. Es ist ein sauberer, vorhersehbarer Hin- und Rückweg, solange Ihre Daten wirklich tabellarisch sind.
Die Stolpersteine, die man kennen sollte
CSV wirkt trivial, verbirgt aber ein paar scharfe Kanten. Die größte sind Kommas innerhalb eines Feldes. Enthält eine Adresse Berlin, Deutschland, würde ein naives Aufteilen an Kommas diesen einzelnen Wert in zwei Spalten zerreißen. Der CSV-Standard handhabt das, indem er solche Felder in doppelte Anführungszeichen hüllt, und Anführungszeichen innerhalb eines zitierten Feldes werden verdoppelt (""). Ein guter Konverter respektiert diese Regeln, damit Ihre Daten nicht stillschweigend Spalten verrutschen. Achten Sie auch auf das Trennzeichen: Viele europäische Exporte nutzen ein Semikolon statt eines Kommas, weil das Komma dort bereits ein Dezimaltrennzeichen ist. Tabulatoren und Pipes tauchen ebenfalls auf.
Der tiefere Unterschied sind Datentypen. CSV hat überhaupt kein Konzept von Datentypen. Alles ist Text, also sehen die Zahl 42, der boolesche Wert true und eine leere Zelle alle wie reine Zeichenketten aus. JSON dagegen unterscheidet Zahlen, Zeichenketten, boolesche Werte, null und verschachtelte Strukturen. Wenn Sie CSV zu JSON umwandeln, kommen Werte als Zeichenketten an, sofern dem Werkzeug nicht gesagt wird, Zahlen und boolesche Werte zu deuten. Beim Umwandeln von JSON zu CSV gibt es das umgekehrte Problem: Verschachtelte Objekte und Arrays passen nicht ordentlich in ein flaches Raster, also werden sie meist verflacht oder in eine einzelne Zelle als Zeichenkette gepackt. Das vorab zu wissen erspart Ihnen, später zu grübeln, warum eine Spalte falsch aussieht.
Ein echter Hin- und Rückweg
Hier ist ein Szenario, das ständig vorkommt. Eine Kollegin schickt Ihnen eine Tabelle mit neuen Nutzern und bittet Sie, sie über eine interne API zu laden. Die API akzeptiert nur JSON. Sie exportieren das Blatt als CSV, fügen es hier ein und erhalten ein sauberes Array von Objekten zurück, bereit, in Ihre Anfrage-Payload zu fallen. Später gibt die API eine JSON-Liste der erstellten Datensätze zurück, und Sie müssen diese derselben Kollegin zur Durchsicht zurückgeben. Sie fügen das JSON ein, wandeln es zu CSV um, und es öffnet sich direkt in ihrer Tabelle. Keine Skripte, keine Installationen, nur zwei schnelle Übersetzungen mitten in einem normalen Arbeitsablauf.
Nur lokal, von Grund auf
All das läuft in Ihrem Browser. Ihr CSV und JSON werden von JavaScript auf Ihrer eigenen Maschine geparst und umgewandelt, und nichts wird auf einen Server hochgeladen. Das zählt, weil Exporte oft echte Namen, E-Mails, Bestelldetails oder interne Kennungen enthalten, die Sie nicht in einen beliebigen entfernten Dienst einfügen sollten. Hier verlassen die Daten nie die Seite. Wenn Sie das Ergebnis danach aufräumen wollen, formatiert und validiert unser JSON-Formatierer es übersichtlich, und Sie können den Rest unserer Datenkonverter für verwandte Formate durchstöbern.
Häufig gestellte Fragen
Werden meine Daten irgendwo hochgeladen?
Nein. Die Umwandlung läuft vollständig in Ihrem Browser mit JavaScript, sodass Ihr CSV und JSON auf Ihrem eigenen Gerät bleiben und nie an einen Server gesendet werden.
Bewältigt der Konverter Kommas innerhalb von Feldern?
Ja. Felder, die Kommas enthalten, sollten im CSV in doppelte Anführungszeichen gehüllt werden, und der Parser respektiert diese Anführungszeichen, sodass der Wert in einer einzelnen Spalte bleibt.
Warum erscheinen meine Zahlen in JSON als Text?
CSV hat keine Datentypen, also ist jede Zelle reiner Text. Werte werden zu JSON-Zeichenketten, sofern keine Zahlen- und Booleschwert-Deutung angewendet wird, weil die Quelldatei keine Möglichkeit bietet, eine Zahl von einem Wort zu unterscheiden.
Was geschieht mit verschachteltem JSON, wenn ich zu CSV umwandle?
Ein flaches Raster kann keine verschachtelten Strukturen halten, also werden verschachtelte Objekte und Arrays typischerweise verflacht oder als einzelner, in eine Zelle gepackter Zeichenkettenwert geschrieben.
Kann ich ein Semikolon oder einen Tabulator statt eines Kommas nutzen?
Ja. Viele Exporte, besonders europäische, nutzen Semikolons oder Tabulatoren als Trennzeichen, und das Werkzeug kann diese statt des Standardkommas lesen.
Wandelt es in beide Richtungen um?
Ja. Sie können CSV in JSON und JSON zurück in CSV verwandeln, was Hin- und Rückwege zwischen Tabellen und APIs unkompliziert macht.