JSON zu CSV Konverter

Warum die JSON-zu-CSV-Konvertierung ein so häufiger Workflow ist

JSON ist das dominante Payload-Format für moderne Web-APIs; CSV ist das Lowest-Common-Denominator-Format für tabellarische Daten. Excel, Google Sheets, SQL LOAD DATA, R, Pandas, Tableau, Power BI und fast jede ETL-Pipeline können CSV ohne Weiteres einlesen. Wenn API-Ausgaben in einer Tabelle für eine Stakeholderin landen müssen oder in einer Datenbank für die Analyse, muss jemand das JSON in Zeilen abflachen. Dieses Tool macht das Abflachen in Ihrem Browser, ohne Server-Roundtrip und ohne Upload potenziell sensibler Daten.

Das CSV-Format (RFC 4180)

Es gibt keinen einzelnen formalen CSV-Standard, aber die RFC 4180 (Oktober 2005, „Common Format and MIME Type for Comma-Separated Values (CSV) Files") ist das, was der Industrie an kanonischer Referenz am nächsten kommt. Die Regeln, auf die sich alle einigen:

• Ein Datensatz pro Zeile, getrennt durch Zeilenumbrüche. Die RFC spezifiziert CRLF; die meisten modernen Parser akzeptieren auch LF.
• Felder eines Datensatzes werden durch ein einzelnes Trennzeichen separiert, in der kanonischen Form ein Komma, aber Semikolon, Tab oder Pipe sind in regionalen und älteren Varianten verbreitet.
• Jeder Datensatz sollte dieselbe Feldanzahl haben. Fehlende Werte werden zu leeren Zellen; zusätzliche Trennzeichen sind ein Fehler.
• Kopfzeile ist optional; falls vorhanden, ist sie die erste Zeile.
• Felder mit Kommas, Zeilenumbrüchen oder doppelten Anführungszeichen müssen in doppelte Anführungszeichen eingeschlossen werden.
• Eingebettete doppelte Anführungszeichen innerhalb eines in Anführungszeichen stehenden Feldes werden durch Verdopplung escaped: "She said ""hello""".
• Der für CSV registrierte MIME-Typ ist text/csv.

Warum vier Trennzeichen statt einem

Der Default ist das Komma, aber jedes Trennzeichen löst ein bestimmtes Problem:

• Komma (,), der Standard in den USA, im UK und anderen englischsprachigen Locales. Excel liest CSV mit Komma, wenn die OS-Regionaleinstellung Englisch ist. Default für application/csv im breiteren Tool-Ökosystem.
• Semikolon (;), der De-facto-Default in Kontinentaleuropa, Lateinamerika und anderen Regionen, in denen das Komma der Dezimaltrenner ist. Excel nutzt den OS-Listentrenner, also produziert ein Excel mit französischer oder deutscher Locale semikolon-getrennte CSVs.
• Tab, TSV (tab-separated values) ist üblich in wissenschaftlichen Daten, der Bioinformatik und in jedem Kontext, in dem die Daten selbst Kommas enthalten (Freitextfelder, Adressen).
• Pipe (|), beliebt in einigen Legacy-Enterprise-Systemen, in denen die Daten Kommas, Semikolons UND Tabs enthalten können. Selten die richtige Erstwahl, aber nützlich, wenn nichts anderes klappt.

Verschachteltes JSON abflachen: drei Strategien

JSON ist hierarchisch; CSV ist flach. Es gibt kein allgemeines verlustfreies Mapping zwischen beiden. Wenn die Eingabe verschachtelte Objekte oder Arrays enthält, muss jeder Konverter eine Entscheidung treffen:

1. Inline als JSON-String. Der verschachtelte Teil wird zurück nach JSON serialisiert und in eine einzelne CSV-Zelle gelegt. Der Default-Ansatz dieses Tools. Verlustfrei; roundtrip-sicher; der Konsument muss das innere JSON parsen, wenn er die Struktur braucht.
2. Punkt-Schlüssel-Abflachung. {address: {street, city}} wird zu den Spalten address.street und address.city. Pandas' json_normalize funktioniert so. Sauberer für Analysten, aber die Spaltenanzahl explodiert bei tief verschachtelten Daten.
3. Zeilen-Explosion. Ein Array wird zu mehreren Zeilen mit wiederholten Eltern-Feldern. {name: "Alice", tags: ["a", "b"]} wird zu zwei Zeilen, beide mit name=Alice. Am besten für Eins-zu-viele-Beziehungen; verliert das mentale Modell „ein Datensatz pro Zeile".

Wenn Sie Punkt-Schlüssel- oder Zeilen-explodierte Ausgabe brauchen, verarbeiten Sie das JSON vor dem Einfügen vor, entweder mit einem kleinen Python-/Node-Skript oder mit Pandas' json_normalize.

Header, Typ-Roundtrip und Excels Auto-Format-Falle

JSON hat ein echtes Typsystem (Zahl, String, Boolean, null, Array, Objekt); CSV hat nur Strings. Die Konvention ist, dass der Konsument Typen aus dem Kontext ableitet. Das Tool generiert Kopfzeilen aus der Vereinigung aller Schlüssel über alle Eingabeobjekte, lässt fehlende Felder als leere Zellen, schreibt Booleans als true/false und JSON-null als leere Zelle.

Excel ist hilfsbereit auf Arten, die manchmal wehtun:

• Entfernen führender Nullen. Eine Spalte mit Postleitzahlen wie 01234 öffnet sich als Zahl 1234. Workaround: im CSV mit einem Apostroph präfixen ('01234) oder den Importassistenten verwenden und den Spaltentyp explizit auf Text setzen.
• Auto-Datum-Konvertierung. Strings, die wie Datumsangaben aussehen (3/4/5, Mar-23), werden stillschweigend konvertiert. Gleiche Workarounds.
• Wissenschaftliche Notation. Lange numerische IDs (Kreditkartennummern, große Ganzzahlen) werden zu 1.23E+15 und verlieren an Präzision. JSON kann Zahlen bis 2⁵³−1 exakt erhalten; für größeres im JSON als String übertragen.
• UTF-8-BOM-Diskrepanz. Excel auf Windows nutzt standardmäßig Windows-1252; das Öffnen einer UTF-8-CSV ohne BOM beschädigt Nicht-ASCII-Zeichen (é, ü, å werden Mojibake). Ein UTF-8-BOM () am Anfang der Datei behebt das. Google Sheets verarbeitet UTF-8 ohne BOM korrekt, das BOM ist also plattformspezifisch.

CSV-Injektion, ein Sicherheitshinweis, den man kennen sollte

Wenn ein CSV in Excel oder Google Sheets geöffnet wird, wird eine Zelle, die mit =, +, - oder @ beginnt, als Formel interpretiert. Die OWASP-Seite zu CSV Injection dokumentiert die Angriffsklasse, ein bösartiger String wie =cmd|' /c calc'!A0 in einem nutzer-eingereichten Feld kann Befehle ausführen, wenn ein Administrator den Export öffnet. Defensive Praxis: präfixieren Sie jede Zelle, die mit einem dieser vier Zeichen beginnt, mit einem einfachen Anführungszeichen, oder umschließen Sie sie in Anführungszeichen plus führendem Apostroph. Wichtig, wenn Sie nutzergenerierte Inhalte exportieren.

Häufige Sonderfälle, die der Konverter behandelt

• Feld, das das Trennzeichen enthält, automatisch in Anführungszeichen. San Francisco, CA in einer Komma-CSV wird zu "San Francisco, CA".
• Feld mit literalem Zeilenumbruch, in Anführungszeichen; mehrzeilige Inhalte sind nach RFC 4180 innerhalb von Anführungszeichen zulässig.
• Feld mit einem doppelten Anführungszeichen, in Anführungszeichen, mit verdoppelten inneren Anführungszeichen: She said "yes" wird zu "She said ""yes""".
• Leere Arrays und Objekte, serialisiert als [] bzw. {} in ihren Zellen.
• Datensätze mit unterschiedlichen Schlüsseln, die Vereinigung aller Schlüssel bildet die Kopfzeile; fehlende Felder sind leere Zellen.
• Einzelobjekt vs Array, ein einzelnes JSON-Objekt wird zu einer Einzeilen-CSV.

Wann dieses Tool nutzen

• Export von API-Antworten für Stakeholder, die eine Tabelle zum Sortieren und Filtern wollen.
• Massenimport von JSON-Daten in eine SQL-DB über LOAD DATA INFILE (MySQL) oder COPY (PostgreSQL). Beide erwarten Eingaben in CSV-Form.
• Schnelle Datenanalyse in Excel, Google Sheets, Pandas, R, Tableau oder Power BI.
• Mailinglisten generieren aus einer JSON-API-Antwort von Kontakten.
• Daten migrieren zwischen Systemen, die keine gemeinsame API haben, aber beide CSV sprechen.
• Eine JSON-Datei per Auge prüfen, wenn sie zu repetitiv ist, um sie direkt zu lesen, die Tabellenansicht ist oft einfacher.

Privatsphäre

CSV-Exporte enthalten fast immer PII, Kundendaten, Mitarbeiterdaten, Transaktionsprotokolle, Kontaktlisten. Server-seitige Konvertierung schickt jeden Datensatz durch die Infrastruktur eines Dritten, wo er in Transit-Logs, Server-Logs und möglicherweise gecachten Antworten lebt. Browser-basierte Konvertierung behält die Daten auf Ihrer Maschine. Der gesamte Abflachen- und Zitieren-Schritt passiert hier in JavaScript in Ihrem Browser; nichts wird hochgeladen.

Häufige Fehler

1. Falsches Trennzeichen für das Publikum. Ein Komma-CSV an einen französischen Excel-Nutzer schicken liefert eine einspaltige Datei. Passen Sie das Trennzeichen an die Locale des Empfängers an.
2. Ein einzelnes Objekt statt eines Arrays einfügen. Ein Einzelobjekt wird zu einer Einzeilen-CSV mit Kopfzeilen aus den Schlüsseln. Für mehrere Datensätze in einem Array einpacken.
3. Pandas-artige Abflachung erwarten. Verschachtelte Objekte werden in diesem Tool als JSON-Strings in Zellen serialisiert. Wenn Sie address.street-Spalten brauchen, vorher abflachen.
4. CSV für sehr große Zahlen nutzen. JSON stellt Ganzzahlen sicher bis 2⁵³−1 dar (etwa 9 Billiarden). Darüber hinaus als String übertragen. Excel verstümmelt lange numerische IDs, selbst wenn das CSV sie bewahrt.
5. In Excel öffnen, ohne an Codierung zu denken. Nicht-ASCII-Zeichen brauchen das UTF-8-BOM für Excel unter Windows; Google Sheets und das moderne Excel im Web brauchen es nicht.
6. Nutzergenerierten Text ohne Bereinigung der Formel-Präfixe exportieren. Zellen, die mit =, +, - oder @ beginnen, sind Formeln in Excel und Sheets. CSV-Injektion ist ein echter Angriff gegen Administratoren, die exportierte Dateien öffnen.

Häufig gestellte Fragen

Mein JSON hat verschachtelte Objekte. Wie werden sie behandelt?

Jedes verschachtelte Objekt oder Array wird als JSON-String innerhalb seiner CSV-Zelle serialisiert. Also wird {user: {name: "Alice", role: "admin"}} zu einer Spalte user mit {"name":"Alice","role":"admin"}. Das ist verlustfrei roundtrip-fähig. Wenn Sie separate user.name- und user.role-Spalten brauchen, mit Pandas' json_normalize oder einem kleinen Flatten-Skript vorverarbeiten.

Warum sehen meine nicht-englischen Zeichen in Excel kaputt aus?

Excel auf Windows öffnet CSV standardmäßig in Windows-1252. UTF-8-CSV ohne Byte Order Mark sieht aus wie Mojibake (é → é). Lösung: entweder Datei mit UTF-8-BOM speichern, Excels Daten → Aus Text-Importassistent verwenden und explizit UTF-8 auswählen, oder die Datei in Google Sheets öffnen, das UTF-8 ohne BOM korrekt verarbeitet.

Behandelt das Tool Kommas innerhalb von Feldern?

Ja. Nach RFC 4180 werden Felder, die das Trennzeichen, Zeilenumbrüche oder doppelte Anführungszeichen enthalten, automatisch in doppelten Anführungszeichen eingeschlossen. Eingebettete doppelte Anführungszeichen werden durch Verdopplung escaped. So wird San Francisco, CA zu "San Francisco, CA" und She said "hi" zu "She said ""hi""".

Wird mein JSON an einen Server gesendet?

Nein. Die Konvertierung läuft komplett in Ihrem Browser. Der Textarea-Inhalt wird nicht übertragen, geloggt oder irgendwo gespeichert. Das ist wichtig, weil exportierte Datensätze oft PII enthalten, Kundendaten, Mitarbeiterinfos, Transaktionshistorien, die nicht durch die Infrastruktur einer anderen Person fließen sollen.

Kann ich Tab-separierte Ausgabe (TSV) bekommen?

Ja, wählen Sie „Tab" im Trennzeichen-Dropdown. TSV ist die richtige Wahl, wenn Ihre Daten Kommas enthalten (Adressen, Freitextfelder, Finanzdaten mit Tausendertrennern) und Sie nicht jede zweite Zelle in Anführungszeichen einschließen wollen. Viele Bioinformatik- und wissenschaftliche Datenformate sind standardmäßig TSV.

Wo liegt die Größenbeschränkung?

So viel Ihr Browser halten kann. Es gibt keine serverseitige Grenze, weil kein Server beteiligt ist. Zehn Megabyte JSON konvertieren in ein, zwei Sekunden auf einem modernen Gerät; hunderte Megabyte fangen an, langsam zu werden. Für sehr große Datasets in Batches aufteilen oder zu einem Streaming-Konverter auf der Kommandozeile wechseln.

Verwandte Tools