CSV in JSON umwandeln: Aufbau, Stolperfallen und Vorgehen

CSV und JSON sind zwei der am häufigsten genutzten Formate, um Daten zwischen Programmen auszutauschen. CSV kommt aus Excel-Exporten, Datenbanken und Reports, JSON ist die Sprache moderner APIs und JavaScript-Anwendungen. Wer mit Daten arbeitet, steht früher oder später vor der Aufgabe, das eine ins andere zu überführen. Dieser Artikel erklärt, wie beide Formate aufgebaut sind, wo die typischen Fallstricke liegen und wie du eine CSV-Tabelle zuverlässig in sauberes JSON verwandelst.

Was ist CSV?

CSV steht für "Comma-Separated Values", also durch Kommas getrennte Werte. Das Format ist denkbar einfach: Jede Zeile entspricht einem Datensatz, die einzelnen Felder werden durch ein Trennzeichen voneinander abgegrenzt. Die erste Zeile enthält in der Regel die Kopfzeile (Header) mit den Spaltennamen.

name,alter,stadt
Anna,29,Berlin
Tom,34,Hamburg

So simpel das aussieht, so viele Tücken stecken im Detail. Das Trennzeichen ist nicht immer ein Komma: Im deutschsprachigen Raum nutzen Excel-Exporte oft ein Semikolon, weil das Komma als Dezimaltrennzeichen reserviert ist. Felder, die selbst ein Komma oder einen Zeilenumbruch enthalten, müssen in Anführungszeichen stehen. Und Anführungszeichen innerhalb eines Feldes werden verdoppelt. Diese Regeln stammen aus dem Standard RFC 4180, an den sich aber nicht jedes Programm hält.

Was ist JSON?

JSON (JavaScript Object Notation) ist ein strukturiertes, hierarchisches Format. Statt flacher Zeilen beschreibt es Objekte mit benannten Schlüsseln und Werten. Aus der CSV oben wird ein Array von Objekten, bei dem jede Kopfzeile zum Schlüssel wird:

[
  {"name": "Anna", "alter": "29", "stadt": "Berlin"},
  {"name": "Tom", "alter": "34", "stadt": "Hamburg"}
]

JSON kennt im Gegensatz zu CSV echte Datentypen: Strings, Zahlen, Wahrheitswerte (true/false), null und verschachtelte Strukturen. Genau hier liegt eine der wichtigsten Entscheidungen beim Konvertieren – bleibt die Zahl 29 ein Text in Anführungszeichen oder wird sie zur echten Zahl?

Die typischen Stolperfallen

• Falsches Trennzeichen: Wenn die CSV mit Semikolon arbeitet, ein Tool aber Komma erwartet, landet die ganze Zeile in einem einzigen Feld. Immer zuerst das Trennzeichen prüfen.
• Anführungszeichen und Kommas im Text: Ein Feld wie "Müller, Anna & Co." enthält selbst ein Komma. Ohne korrektes Parsen reißt es den Datensatz auseinander.
• Datentypen: Aus CSV kommt grundsätzlich alles als Text. Ob "29" eine Zahl oder ein String werden soll, muss bewusst entschieden werden.
• Leere Felder: Eine leere Zelle kann als leerer String, als null oder als fehlender Schlüssel interpretiert werden.
• Zeichenkodierung: Umlaute werden zu Zeichensalat, wenn die CSV in Windows-1252 vorliegt, aber als UTF-8 gelesen wird.

So gehst du beim Konvertieren vor

Der schnellste Weg führt über ein Browser-Tool, bei dem du die Daten einfach einfügst. Mit dem CSV zu JSON Konverter wandelst du eine CSV mit Kopfzeile direkt in sauberes JSON um – ohne Installation, ohne dass die Daten deinen Browser verlassen. Du kopierst die Tabelle hinein, das Tool liest die erste Zeile als Schlüssel und erzeugt für jede weitere Zeile ein Objekt. Gerade für schnelle Tests, kleine Datensätze oder zum Befüllen einer Test-API ist das ideal.

Bei sensiblen oder sehr großen Datenmengen lohnt sich die Konvertierung über ein Skript (z. B. mit Python und der pandas-Bibliothek), weil du dort die volle Kontrolle über Typumwandlung und Kodierung behältst. Für den Alltag und schnelle Aufgaben reicht das Browser-Tool aber vollkommen aus.

Verwandte Werkzeuge

Bevor du eine CSV weiterverarbeitest, solltest du das erzeugte JSON kurz auf Gültigkeit prüfen. Dafür eignet sich der JSON Validator, der das Ergebnis formatiert und Syntaxfehler aufzeigt. Brauchst du den umgekehrten Weg, also JSON zurück in eine Tabelle, hilft der JSON zu CSV Konverter. Eine Übersicht über alle verfügbaren Helfer findest du in der Sammlung der kotsch.tech Webtools.

Häufige Fragen

Werden meine Daten irgendwo hochgeladen?

Bei einem reinen Browser-Tool wie dem CSV zu JSON Konverter läuft die Umwandlung lokal in deinem Browser ab. Die Daten werden nicht an einen Server gesendet, was gerade bei vertraulichen Tabellen wichtig ist.

Was mache ich, wenn meine CSV ein Semikolon nutzt?

Ersetze das Semikolon vorher durch ein Komma, oder prüfe, ob das Tool das Trennzeichen automatisch erkennt. Häufig reicht ein kurzer Blick in die Rohdaten, um das richtige Zeichen zu identifizieren.

Bleiben Zahlen Zahlen oder werden sie zu Text?

Das hängt vom Konverter ab. Viele einfache Tools übernehmen alle Werte als Strings, weil CSV keine Typinformationen mitliefert. Wenn du echte Zahlen brauchst, musst du das JSON nachträglich anpassen oder ein Tool mit Typerkennung nutzen.