Was die Seite csv-to-json leistet
Sie haben eine CSV-Datei – zeilenweise, getrennt durch Kommas, Semikola oder Tabulatoren – und benötigen daraus eine JSON-Datei. Üblicherweise entsteht ein Array von Objekten, bei dem jede Zeile ein Objekt und jede Spalte ein Schlüssel ist. Sie ziehen die Datei auf das Tool oder wählen sie von Ihrem Gerät aus, wählen bei Bedarf das korrekte Trennzeichen (falls Ihre CSV kein Komma verwendet), sehen eine Vorschau des Ergebnisses und laden die fertige JSON-Datei herunter.
Der gesamte Vorgang läuft lokal im Browser ab – keine Datei verlässt Ihren Rechner. Das Tool ist auf die Konvertierung von CSV zu JSON spezialisiert.
Die entscheidenden Unterschiede dieser Seite
Dieses Tool unterscheidet sich von anderen Konvertern in mehreren grundlegenden Punkten, die Sie kennen sollten, bevor Sie eine CSV konvertieren.
Keine Typen in der Quelle, keine Typen im Ziel. CSV speichert alles als flachen Text. JSON hingegen kennt Zahlen, boolesche Werte, null und verschachtelte Strukturen. Jedes CSV-Feld kommt als Zeichenkette an. Zahlen wie Preise oder Mengen, Datumsangaben und führende Nullen (Postleitzahlen, Produktcodes) werden nicht automatisch in numerische oder Datumswerte umgewandelt – sie bleiben Zeichenketten, es sei denn, Sie bearbeiten sie nach dem Download manuell.
Keine Verschachtelung möglich. CSV ist eine strikt flache Tabelle. Die Konvertierung erzeugt daher ein flaches Array flacher Objekte. Hierarchisches JSON (Objekte innerhalb von Objekten) lässt sich aus einer CSV-Datei nicht ohne zusätzliche Regeln erzeugen – und dieses Tool wendet solche Regeln nicht an. (Der umgekehrte Weg – JSON nach CSV – muss hingegen verschachtelte Felder zwangsläufig abflachen.)
Das Trennzeichen ist entscheidend. Sie müssen angeben, ob Ihre CSV Kommas, Semikola oder Tabs verwendet. Bei Seiten, die JSON oder Excel verarbeiten, entfällt diese Wahl – hier ist sie obligatorisch.
Eingebettete Kommas und Zeilenumbrüche sind fragil. Die CSV-Zitierregeln (RFC 4180) werden nicht überall befolgt. Eingebettete Kommas in Anführungszeichen, Zeilenumbrüche innerhalb von Zellen und nicht maskierte Anführungszeichen führen häufig zu Parsing-Fehlern – häufiger als bei anderen Formatwechseln.
Wie die Konvertierung genau abläuft
Das Tool parst die sichtbaren Daten aus der CSV-Datei. Es führt keine Formeln aus und bewahrt keine Formatierung (CSV hat ohnehin keine). Die Benutzeroberfläche zeigt Ihnen nach dem Einlesen:
- eine Vorschau der konvertierten Daten,
- die Anzahl der Zeilen und Spalten,
- die Größe der Ausgabedatei.
Wählen Sie das Trennzeichen (Komma, Semikolon oder Tabulator) passend zu Ihrer CSV. Bei unpassender Wahl wird das Parsing fehlschlagen. Das Tool versucht nicht, das Trennzeichen automatisch zu erraten – diese Entscheidung liegt bei Ihnen.
Das JSON-Objekt für jede Zeile erhält Schlüssel aus der ersten Zeile (den Spaltenüberschriften). Enthält die CSV keine Kopfzeile, werden automatisch Schlüssel wie Column1, Column2 usw. vergeben. Doppelte Kopfzeilen erhalten Suffixe wie _2, _3. Zahlen, Booleans und Datumsangaben behalten ihre Typen, anstatt in Strings umgewandelt zu werden.
Fehlerbehandlung und Grenzen
Das Tool zeigt klare, fest definierte Fehlermeldungen – keine kryptischen Codes.
- Nicht parsbare CSV: „This CSV could not be parsed.“ Tritt auf bei fehlerhafter Zitierung, inkonsistenten Spaltenanzahlen oder anderen strukturellen Problemen.
- Keine Datenzeilen: „This file has no table rows.“ – etwa eine Datei, die nur eine Kopfzeile enthält.
- Zeilen- oder Spaltenlimit überschritten: „This table has more than ‹max› rows.“ bzw. „This table has more than ‹max› columns.“ Das Tool verarbeitet maximal 10.000 Zeilen und 200 Spalten.
- Dateigrößenlimit: „This file is too large. Use a file under ‹max›.“ – lädt man eine Datei, die größer als 8 MB ist, wird sie nicht verarbeitet.
- Falscher Dateityp: „Choose a CSV, JSON or XLSX file.“ Es werden nur diese drei Formate akzeptiert.
- Zeitüberschreitung: „This conversion is taking too long. Try a smaller file.“ Eine Konvertierung, die länger als etwa 12 Sekunden dauert, wird abgebrochen.
Diese Meldungen sind Teil der Benutzeroberfläche und nicht verhandelbar – sie treten genau unter den beschriebenen Bedingungen auf.
Datentypen und die Sache mit den führenden Nullen
Weil jedes CSV-Feld als Zeichenkette behandelt wird, bleiben führende Nullen erhalten. Ein Postleitzahlenfeld wie 01234 wird zu "01234" im JSON – nicht zur Zahl 1234. Das ist häufig genau das, was Sie wollen, denn viele Systeme (Web-APIs, Adressdatenbanken) erwarten Postleitzahlen als Zeichenketten.
Andererseits: Wenn Sie später das JSON in einem JavaScript-Programm laden, das automatisch Typen errät (JSON.parse macht das nicht – es bleibt bei Strings), könnte ein anderes Framework oder eine Datenbank die führenden Nullen dennoch entfernen. Das liegt nicht am Tool, sondern an der nachgelagerten Verarbeitung.
Umgekehrt: Wenn Sie Zahlen wie 42 oder 3.14 im CSV haben, landen sie als "42" und "3.14" im JSON – also als Zeichenketten. Möchten Sie echte Zahlen, müssen Sie diese nach dem Download konvertieren (z. B. durch Number(value) oder durch ein Schema in Ihrer Anwendung).
Zeilenumbrüche in Feldern: Enthält eine CSV-Zelle einen Zeilenumbruch (innerhalb von Anführungszeichen), wird dieser als im JSON-String codiert. Das ist standardkonform und bleibt beim Einlesen in die meisten Umgebungen erhalten.
Wer dieses Tool braucht und typische Anwendungsfälle
Das Tool richtet sich an mehrere Zielgruppen:
- Entwickler, die einen CSV-Export aus einer Datenbank oder Tabellenkalkulation erhalten und die Daten in eine JavaScript-Anwendung oder API einspeisen müssen, die JSON erwartet.
- Datenanalysten, die eine alte CSV-Adressdatei mit führenden Nullen (Postleitzahlen) konvertieren und die Nullen intakt halten müssen.
- Teams, die tabellarische Daten zwischen einem nichttechnischen Kollegen (der Excel/CSV verwendet) und einem Tech-Stack, der JSON spricht, austauschen – ohne sensible Informationen auf einen Server hochzuladen.
- Jeder, der eine einfache Tabelle mit Produkten, Kontakten oder Logdaten für ein Web-Tool aufbereitet, das JSON liest.
- Studenten oder Forscher, die eine einmalige CSV in ein strukturiertes Format für eine Programmieraufgabe umwandeln.
Der häufigste Fehler: Man wählt versehentlich das falsche Trennzeichen. Eine CSV, die mit Semikolon gespeichert wurde (häufig bei deutschen Excel-Einstellungen), aber als kommagetrennt behandelt wird, führt zu falschen Ergebnissen – jede Zeile wird als ein einziges Feld mit Semikola interpretiert.
Vergleich mit der Rückrichtung (JSON → CSV)
Während die Konvertierung CSV → JSON relativ geradlinig ist (flache Tabelle → flaches JSON), ist der umgekehrte Weg komplizierter. JSON kann beliebig tiefe Verschachtelungen enthalten. Ein Tool, das JSON in CSV umwandelt, muss diese Verschachtelung zwangsläufig abflachen – etwa durch Punktnotation (adresse.strasse). Dieser Schritt ist hier nicht nötig, weil die Quelle (CSV) keine Hierarchie kennt.
Die Typbehandlung unterscheidet sich ebenfalls. CSV → JSON bewahrt alle Werte als Zeichenketten. JSON → CSV muss hingegen entscheiden, wie Zahlen, null oder true/false in CSV dargestellt werden – üblicherweise als unquotierte Werte, was den umgekehrten Weg später erschwert.
Dieses Tool spezialisiert sich also auf die einfachere, aber dennoch fehlerträchtige Richtung.
FAQ
Frage: Warum werden meine Zahlen im JSON als Strings dargestellt, nicht als Zahlen?
Antwort: CSV kann keine Typen speichern – jeder Wert ist Text. Das Tool versucht nicht, Typen zu erraten, sondern behandelt jeden Wert aus der Quell-CSV als String. Wenn Sie echte Zahlen benötigen, müssen Sie die Werte nach dem Download in Ihrer Anwendung konvertieren (z. B. mit parseInt() oder Number()).
Frage: Meine CSV enthält Postleitzahlen wie 01234. Verschwindet die führende Null im JSON?
Antwort: Nein. Da das Tool alle Felder als Zeichenketten behandelt, bleibt die Null erhalten. Sie erhalten "01234" im JSON. Erst wenn Sie das JSON später in einem System laden, das automatisch Typen umwandelt (z. B. Excel beim Import), könnte die Null verlorengehen – das liegt dann aber nicht am Konverter.
Frage: Ich habe eine CSV mit Semikolon als Trennzeichen. Muss ich etwas beachten?
Antwort: Ja. Wählen Sie im Tool das Trennzeichen „Semikolon“ aus. Standardmäßig ist „Komma“ eingestellt. Wählen Sie das falsche, erkennt das Tool die Spalten nicht richtig und zeigt „This CSV could not be parsed.“ an.
Frage: Kann ich mit diesem Tool auch Excel-Dateien (XLSX) in JSON umwandeln?
Antwort: Nein, diese Seite ist ausschließlich für die Konvertierung von CSV zu JSON vorgesehen.
Frage: Meine CSV hat Zeilenumbrüche innerhalb einer Zelle. Werden die korrekt übernommen?
Antwort: Ja – vorausgesetzt, die CSV folgt den Regeln von RFC 4180: Zeilenumbrüche innerhalb eines Feldes müssen durch doppelte Anführungszeichen eingeschlossen sein. Das Tool parst solche Felder korrekt und codiert den Umbruch als im JSON-String.
Frage: Ich bekomme die Meldung „This file is too large. Use a file under ‹max›.“ Was nun?
Antwort: Ihre Datei überschreitet das zulässige Limit von 8 MB. Sie müssen die CSV verkleinern (z. B. Zeilen löschen oder die Datei in mehrere Teile aufteilen) oder ein anderes Tool verwenden.