CSV zu JSONL Konverter

Wie man CSV in JSONL konvertiert

Die CSV-zu-JSONL-Konvertierung liest die erste Zeile Ihrer CSV-Datei als Spaltenüberschriften und konvertiert dann jede folgende Zeile in ein JSON-Objekt mit diesen Überschriften als Schlüssel.

Unser Konverter erkennt automatisch das Trennzeichen (Komma, Tab oder Semikolon) und verarbeitet Felder in Anführungszeichen, einschließlich Felder mit Kommas oder Zeilenumbrüchen. Werte werden automatisch typisiert — Zahlen, Booleans und null werden erkannt.

Die Ausgabe ist gültiges JSONL-Format mit einem kompakten JSON-Objekt pro Zeile, bereit für Machine-Learning-Plattformen, Datenpipelines und APIs.

Regeln für die Typinferenz

Eine CSV-Zelle enthält ausschließlich Text. Um daraus nützliches JSON zu erstellen, müssen die Typen abgeleitet werden. Der Konverter verwendet die folgenden Regeln und zeigt, wie Sie sie überschreiben können, wenn die automatische Erkennung Daten verfälschen würde:

Ziffern → Zahl

Zellen wie 42 oder 3.14 werden zu JSON-Zahlen. Der Fallstrick: Werte, die numerisch aussehen, es aber nicht sind — die US-Postleitzahl 00501 würde als Zahl 501 ihre führenden Nullen verlieren. Alles, bei dem führende Nullen oder der exakte Text wichtig sind, sollte in der Quelle in Anführungszeichen stehen oder als String-Spalte beibehalten werden.

true/false → Boolean

true und false werden unabhängig von Groß- und Kleinschreibung zu JSON-Booleans. Die Strings yes, no, 0 und 1 bleiben unverändert — eine Vermutung über die beabsichtigte Bedeutung verursacht hier mehr Fehler, als sie verhindert.

Leere Zelle → null

Leere Zellen werden zu JSON null statt zu leeren Strings. Nachgelagerter Code kann dadurch einfach auf null prüfen, statt auf "" testen zu müssen.

Felder in Anführungszeichen, Kommas und eingebettete Zeilenumbrüche

Die standardmäßige CSV-Zitierung wird berücksichtigt: Ein Feld in Anführungszeichen darf Kommas und sogar Zeilenumbrüche enthalten; doppelte Anführungszeichen ("") werden als einzelnes Anführungszeichen interpretiert. Ein Feld mit eingebettetem Zeilenumbruch ergibt weiterhin nur eine JSONL-Zeile — der Zeilenumbruch wird im JSON-String als \n maskiert.

Häufige Fehler & Lösungen

Was ist die CSV-zu-JSONL-Konvertierung?

Die CSV-zu-JSONL-Konvertierung wandelt tabellarische Daten aus Tabellenkalkulationen und Datenbanken in das JSON-Lines-Format um. Jede Zeile der CSV wird zu einem separaten JSON-Objekt in einer eigenen Zeile, wobei Spaltenüberschriften als Schlüsselnamen verwendet werden.

Diese Konvertierung ist unerlässlich für die Vorbereitung von Tabellendaten für Machine-Learning-Training (OpenAI, Hugging Face), das Laden von Daten in NoSQL-Datenbanken und das Einspeisen strukturierter Daten in Streaming-Pipelines.

Dieselbe Konvertierung mit pandas

Wenn Ihre CSV bereits Teil einer Python-Pipeline ist, erledigt pandas diese Konvertierung mit zwei Aufrufen. Die dtype-Inferenz folgt dabei derselben oben beschriebenen Logik:

import pandas as pd

df = pd.read_csv('input.csv', dtype={'zip': 'string'})  # protect ZIP codes
df.to_json('output.jsonl', orient='records', lines=True, force_ascii=False)

Das Argument dtype ist die pandas-Variante der Regel für führende Nullen: Deklarieren Sie empfindliche Spalten ausdrücklich als Strings, statt sich auf die Inferenz zu verlassen. force_ascii=False lässt Nicht-ASCII-Text lesbar, statt ihn mit \u-Sequenzen zu maskieren.

Häufig gestellte Fragen