JSON Array vs CSV vs Line List: Welches Format sollten Sie verwenden?

Die drei Formate verstehen

Ein JSON-Array ist eine geordnete Sammlung von Werten, die in eckige Klammern eingeschlossen sind. Es kann Zeichenketten, Zahlen, Boolesche Werte, Objekte und verschachtelte Arrays enthalten. CSV (kommagetrennte Werte) stellt tabellarische Daten als Zeilen von Feldern dar, die durch Kommas getrennt sind, oft mit einer optionalen Kopfzeile. Eine Line-Liste ist die einfachste Form: ein Wert pro Zeile, keine Trennzeichen, keine Spaltenstruktur.

• JSON-Arrays verarbeiten heterogene Daten und verschachtelte Objekte.
• CSV ist der Standard für Tabellenkalkulations- und Datenbankexporte.
• Line-Listen eignen sich am besten für einfache geordnete Sammlungen wie E-Mail-Adressen oder Dateinamen.

["apple", "banana", "cherry"]

fruit,quantity
apple,3
banana,5
cherry,2

apple
banana
cherry

Arbeiten mit JSON-Arrays

JSON-Arrays werden häufig in Web-APIs und Konfigurationsdateien verwendet, da sie verschachtelte Strukturen unterstützen. Ein Array kann Objekte mit mehreren Eigenschaften enthalten, was es einfach macht, reale Entitäten darzustellen. Das Format ist streng: Nachfolgende Kommas, nicht in Anführungszeichen gesetzte Schlüssel oder nicht übereinstimmende Klammern führen zu Parsing-Fehlern.

Für einfache Listen ist JSON ausführlicher als eine Line-Liste, aber seine Maschinenlesbarkeit und Unterstützung für verschiedene Datentypen überwiegen oft den Overhead. Escaping wird mit Backslashes in Zeichenketten gehandhabt: doppelte Anführungszeichen werden zu \", Backslashes zu \\ und Zeilenumbrüche zu \n.

• Vorteile: unterstützt komplexe Verschachtelung, sprachunabhängig, selbsterklärend.
• Nachteile: ausführlicher, erfordert Validierung, weniger manuell bearbeitbar für große Datensätze.

[
  {"name": "Alice", "email": "[email protected]"},
  {"name": "Bob", "email": "[email protected]"}
]

["line1\nline2", "path\\to\\file", "She said \"hello\""]

Arbeiten mit CSV

CSV-Dateien sind der De-facto-Standard für den Datenaustausch zwischen Tabellenkalkulationen und Datenbanken. Jede Zeile stellt einen Datensatz dar, und Felder werden durch ein Trennzeichen getrennt – typischerweise ein Komma, manchmal aber auch Semikolon in Regionen, in denen das Komma als Dezimaltrennzeichen verwendet wird. Gemäß RFC 4180 müssen Felder, die ein Trennzeichen, ein doppeltes Anführungszeichen oder einen Zeilenumbruch enthalten, in doppelte Anführungszeichen eingeschlossen werden.

Daten in CSV werden immer als Zeichenfolgen dargestellt; Zahlen, Daten und Boolesche Werte können von verschiedenen Programmen unterschiedlich interpretiert werden. Kopfzeilen sind üblich, aber nicht zwingend. Die größte Herausforderung bei CSV ist der Umgang mit gebietsschemaspezifischen Trennzeichen und der Kodierung (UTF-8, UTF-8 mit BOM oder ISO-8859-1).

• Vorteile: nativ für Tabellenkalkulationen, einfach in Tabellenform anzuzeigen, kompakt.
• Nachteile: begrenzte Datentypen (alle Zeichenfolgen), keine verschachtelten Strukturen, Anführungszeichen-Escaping kann verwirrend sein.

"Name","Comment"
"Smith, John","He said ""hello"""

Arbeiten mit Line-Listen

Eine Line-Liste ist das einfachste textbasierte Datenformat: ein Wert pro Zeile, keine Trennzeichen, keine Zitierregeln. Sie ist ideal für Sammlungen von Elementen, bei denen jedes Element eine einzelne Zeichenfolge ohne Zeilenumbrüche ist, wie z. B. E-Mail-Adressen, Domainnamen, Dateinamen oder Produktcodes. Das Format ist äußerst benutzerfreundlich und funktioniert gut mit Befehlszeilenwerkzeugen wie grep, sort und uniq.

Da es kein Escaping gibt, können Line-Listen keine mehrzeiligen Werte enthalten. Wenn ein Element einen Zeilenumbruch enthalten könnte, müssen Sie entweder ein anderes Format verwenden oder den Zeilenumbruch als wörtlichen Backslash-n (oder einen anderen Platzhalter) konventionell kodieren. Viele Editoren und Versionskontrollsysteme behandeln Line-Listen sauber, da jede Änderung zeilenweise sichtbar ist.

• Vorteile: menschenlesbar, einfach zu sortieren und zu deduplizieren, kein Escaping für typische Werte.
• Nachteile: nur für einfeldrige Daten geeignet, keine Unterstützung für mehrzeilige Elemente ohne Konventionen.

[email protected]
[email protected]
[email protected]

Escaping und Zitieren in den drei Formaten

Jedes Format behandelt Sonderzeichen unterschiedlich. In JSON kann jede Zeichenfolge Backslash-escaped Sequenzen enthalten: \" für ein doppeltes Anführungszeichen, \\ für einen Backslash, \n für einen Zeilenumbruch, \t für einen Tabulator. Der Parser interpretiert diese Sequenzen immer, was JSON eindeutig, aber schwieriger von Hand zu schreiben macht.

CSV verlässt sich auf äußere doppelte Anführungszeichen, um Felder zu schützen, die Sonderzeichen enthalten. Wenn ein Feld ein doppeltes Anführungszeichen enthält, wird es verdoppelt ("" wird zu einem einfachen wörtlichen Anführungszeichen). Line-Listen haben keinen Escape-Mechanismus; wenn die Daten einen Zeilenumbruch enthalten, bricht die Struktur. Das Verständnis dieser Unterschiede ist entscheidend beim Konvertieren zwischen Formaten.

• JSON verwendet Backslash-Escaping innerhalb von Zeichenfolgen.
• CSV verwendet doppelte Anführungszeichen für Felder, die Kommas, Zeilenumbrüche oder Anführungszeichen enthalten.
• Line-Listen gehen davon aus, dass keine Zeilenumbrüche in den Daten vorkommen; eingebettete Zeilenumbrüche sind nicht darstellbar.

JSON: "He said \"hello\"\nand left."
CSV: "He said ""hello""
and left."

Tabellenkalkulationsintegration und Import/Export

CSV ist das einfachste Format für Tabellenkalkulationsbenutzer. Die meisten Tabellenkalkulationsanwendungen (Microsoft Excel, Google Sheets, LibreOffice Calc) können eine CSV-Datei direkt öffnen, obwohl sie möglicherweise das Trennzeichen oder die Kodierung falsch interpretieren. Für konsistente Ergebnisse speichern Sie CSV-Dateien in UTF-8 mit einem Byte-Order-Mark (BOM) und verwenden Sie Kommas (oder Semikolons je nach Region).

JSON-Arrays können mit integrierten Werkzeugen wie Power Query (Excel) oder durch ein kurzes Skript in Tabellenkalkulationen importiert werden. Line-Listen werden oft in eine einzelne Spalte eingefügt; Sie müssen möglicherweise die Funktion 'Text in Spalten' verwenden, wenn die Liste Trennzeichen enthält. Achten Sie bei jedem Format auf automatische Datenkonvertierung: führende Nullen in Zahlen, Datumszeichenfolgen oder große Zahlen, die an Genauigkeit verlieren können.

1. Öffnen Sie Excel und wählen Sie Datei > Öffnen.
2. Wählen Sie Ihre CSV-Datei aus. Wenn die Daten falsch angezeigt werden, verwenden Sie den Textimport-Assistenten, um Trennzeichen und Kodierung anzugeben.
3. Für JSON verwenden Sie Daten > Daten abrufen > Aus Datei > Aus JSON.
4. Fügen Sie für eine Line-Liste die Daten in eine Spalte ein, markieren Sie dann die Spalte und verwenden Sie Daten > Text in Spalten, wenn Sie die Daten weiter aufteilen müssen.

• CSV: Überprüfen Sie das Trennzeichen und die Zeichenkodierung; UTF-8 mit BOM kann die Kompatibilität mit einigen Excel-Versionen verbessern.
• JSON: Validieren Sie die Struktur vor dem Import, um Syntaxfehler frühzeitig zu erkennen.
• Line-Liste: Fügen Sie sie in eine als Text formatierte Spalte ein, wenn führende Nullen erhalten bleiben müssen.

Häufige Konvertierungsfallen und wie man sie vermeidet

Das Konvertieren zwischen diesen Formaten führt oft zu Datenverlust, wenn Sie nicht vorsichtig sind. Das Abflachen eines verschachtelten JSON-Arrays in CSV zwingt Sie dazu, auszuwählen, welche Eigenschaften behalten werden sollen, und verwirft andere. Beim Konvertieren einer Line-Liste in CSV wird jede Zeile zu einem einzelnen Feld, aber wenn die Zeile ein Komma oder doppeltes Anführungszeichen enthält, muss sie ordnungsgemäß zitiert werden, um eine einzelne Spalte zu bleiben.

Validierung ist entscheidend. JSON-Dateien sollten mit einem Linter validiert werden, um nachfolgende Kommas oder nicht in Anführungszeichen gesetzte Schlüssel zu finden. CSV-Dateien sollten auf konsistente Zeilenlängen und korrekte Zitierung überprüft werden. Line-Listen sollten keine abschließenden Zeilenumbrüche oder leere Zeilen haben, es sei denn, sie sind beabsichtigt. Die Verwendung eines speziellen Konvertierungswerkzeugs kann helfen, diese Fallstricke zu vermeiden.

1. 1. Identifizieren Sie die Struktur des Quellformats (flach oder verschachtelt).
2. 2. Wenn Sie von JSON konvertieren, flachen Sie verschachtelte Objekte oder Arrays ab.
3. 3. Stellen Sie bei CSV sicher, dass Kopfzeilen vorhanden sind, falls benötigt, und dass Felder korrekt zitiert werden.
4. 4. Bestätigen Sie bei Line-Listen, dass die Elemente keine Zeilenumbrüche enthalten; wenn doch, kodieren Sie sie oder wechseln Sie das Format.
5. 5. Validieren Sie die Ausgabe mit einem einfachen Parsing-Test.

• Verschachtelte Objekte in JSON vor der Konvertierung in CSV abflachen.
• Felder in CSV immer zitieren, wenn sie Kommas oder Zeilenumbrüche enthalten könnten.
• JSON vor der Konvertierung mit einem Linter validieren.
• Auf leere Zeilen oder nachgestellte Leerzeichen in Line-Listen prüfen.

Source JSON: [{"name": "Alice", "tags": ["dev", "admin"]}]
Flattened CSV: name,tags
Alice,"[""dev"",""admin""]"

"Name"
"Smith, John"

Formatwahl: Entscheidungsleitfaden

Das beste Format für Ihre Daten hängt davon ab, wie sie erstellt, verbraucht und gewartet werden. Verwenden Sie JSON-Arrays, wenn Ihre Daten verschachtelte Strukturen haben oder wenn Sie Daten zwischen Anwendungen austauschen, die bereits JSON verwenden. Wählen Sie CSV, wenn Ihre Zielgruppe Tabellenkalkulationen verwendet, oder wenn Sie ein allgemein akzeptiertes Tabellenformat benötigen. Entscheiden Sie sich für eine Line-Liste für einfache, flache Sammlungen, die Menschen mit einem grundlegenden Texteditor bearbeiten.

• Für API-Daten → JSON.
• Für Tabellenkalkulationsimport → CSV.
• Für einfache Listen (E-Mails, Codes) → Line-Liste.
• Für maximale Interoperabilität → CSV (alle Tabellenkalkulations-Apps unterstützen es).
• Für versionsfreundliche Diffs → Line-Liste.