Vollständiger Leitfaden zur CSV-zu-JSON-Konvertierung

JSON

Strukturelle Unterschiede zwischen CSV und JSON

CSV (Comma-Separated Values) und JSON (JavaScript Object Notation) sind zwei der häufigsten Datenformate, aber ihre Strukturen sind grundlegend verschieden:

Merkmal CSV JSON
Struktur Flache Tabelle Verschachtelter Baum
Datentypen Nur Strings String, Zahl, Boolean, null
Verschachtelung Nicht unterstützt Native Unterstützung
Kommentare Nicht unterstützt Nicht unterstützt (JSON5 schon)
Anwendungsfälle Tabellarische Daten, Excel-Export API-Antworten, Konfigurationsdateien

Konvertierungsregeln erklärt

CSV zu JSON

Jede CSV-Zeile wird in ein JSON-Objekt umgewandelt. Die erste Zeile dient als Schlüssel (Kopfzeilen) und die nachfolgenden Zeilen liefern die Werte:

name,age,city
Alice,28,New York
Bob,32,London

Konvertierungsergebnis:

[
  { "name": "Alice", "age": 28, "city": "New York" },
  { "name": "Bob", "age": 32, "city": "London" }
]

JSON zu CSV

Jedes Objekt in einem JSON-Array wird in eine CSV-Zeile expandiert, wobei die Objektschlüssel die Kopfzeile bilden.

Konvertierung mit dem JSON↔CSV-Tool

Schritt 1: Daten vorbereiten

Stellen Sie sicher, dass Ihre CSV-Datei wohlgeformt ist: Die erste Zeile enthält Kopfzeilen, jede Zeile hat die gleiche Anzahl an Feldern und Felder mit Kommas sind in doppelte Anführungszeichen eingeschlossen.

Schritt 2: Konvertierungsrichtung wählen

Öffnen Sie das JSON↔CSV-Tool und wählen Sie entweder den Modus "CSV → JSON" oder "JSON → CSV".

Schritt 3: Daten einfügen oder hochladen

Fügen Sie Ihre Daten in den Eingabebereich ein oder laden Sie direkt eine .csv- oder .json-Datei hoch.

Schritt 4: Optionen konfigurieren

  • Trennzeichen: Standardmäßig Komma; unterstützt auch Tabulator (TSV) und Semikolon
  • Kopfzeilen einbeziehen: Steuert, ob die erste Zeile als Feldnamen behandelt wird
  • Verschachtelungsexpansion: Wie verschachtelte Objekte in JSON behandelt werden
  • Zahlen automatisch erkennen: Wandelt "28" automatisch in 28 um

Schritt 5: Ergebnisse abrufen

Klicken Sie auf die Konvertierungsschaltfläche. Die Ergebnisse erscheinen sofort im Ausgabebereich und können mit einem Klick kopiert oder heruntergeladen werden.

Umgang mit Kopfzeilen

Kopfzeilen sind der Kern von CSV. Beachten Sie bei der Konvertierung:

  • Leerzeichen und Sonderzeichen in Kopfzeilen werden als JSON-Schlüssel beibehalten
  • Verwenden Sie Kleinbuchstaben + Unterstrich-Namensgebung (z.B. user_name) für einfachere Weiterverarbeitung
  • Wenn CSV keine Kopfzeile hat, generiert das Tool automatisch Standard-Spaltennamen wie col_1, col_2

Umgang mit verschachtelten Objekten

CSV unterstützt nativ keine Verschachtelung, aber einige CSV-Dateien verwenden Punkt-Notation für Hierarchien:

user.name,user.email,order.id
Alice,alice@example.com,1001

Aktivieren Sie die Option "Verschachtelung automatisch expandieren" im JSON↔CSV-Tool um zu generieren:

{
  "user": { "name": "Alice", "email": "alice@example.com" },
  "order": { "id": 1001 }
}

Tipps für große Dateien

  • Bei CSV-Dateien über 10 MB sollten Sie Stapelkonvertierung in Betracht ziehen
  • Verwenden Sie Stream-Verarbeitung, um Speicherüberlauf zu vermeiden
  • Das Tool unterstützt Online-Konvertierung für Dateien bis zu 50 MB
  • Für sehr große Dateien sollten Sie eine lokale Vorverarbeitung mit Python (pandas) durchführen

Häufige Fehler und Lösungen

Fehler Ursache Lösung
Inkonsistente Feldanzahl Extra/fehlendes Komma in einer Zeile Prüfen Sie, ob die Anführungszeichen vollständig sind
Kodierungskauderwelsch Datei ist nicht UTF-8 Konvertieren Sie die Kodierung zuerst mit einem Texteditor
JSON-Parse-Fehler Ungültiges Format Korrigieren Sie mit dem JSON-Formatierer
Verschachtelungsexpansion fehlgeschlagen Unregelmäßige Schlüsselhierarchie Prüfen Sie die Konsistenz der Punkt-Trennzeichen

Praktische Tipps

  1. Formatieren Sie die Ausgabe nach der Konvertierung mit dem JSON-Formatierer
  2. Validieren Sie Ergebnisse schnell mit JSONPath
  3. Aus Excel exportiertes CSV enthält oft einen BOM-Header — entfernen Sie diesen vor der Konvertierung
  4. Standardisieren Sie Datumsfelder auf das ISO 8601-Format

Zusammenfassung

Die CSV-zu-JSON-Konvertierung ist eine häufige Operation in der täglichen Entwicklung. Das Verständnis struktureller Unterschiede und Konvertierungsregeln in Kombination mit dem JSON↔CSV-Tool ermöglicht eine effiziente Datenformatkonvertierung. Für komplexe Verschachtelungs- oder Großdatei-Szenarien wenden Sie die Tipps in diesem Leitfaden an, um Probleme nacheinander zu lösen.

#CSV#JSON#数据转换#表格#开发