Was ist eine JSON Datei? Einfach erklärt für Einsteiger

Ich hab mal drei Stunden damit verbracht, einen Bug zu jagen, der sich am Ende als fehlendes Komma entpuppte. Eine einzige Zeile. Drei Stunden. So ist das mit JSON-Dateien – die Dinger sind so simpel, dass man denkt, man kann sie nicht falsch machen, und dann machen sie dich fertig. Wenn du gerade vor einer Datei mit der Endung .json sitzt und dich fragst, was eine JSON-Datei eigentlich ist und warum plötzlich überall davon die Rede ist, dann bist du hier richtig. Ich erkläre dir das so, wie ich es damals meinem Vater erklärt hätte – ohne Fachchinesisch, aber ehrlich.

Wichtige Erkenntnisse

JSON steht für JavaScript Object Notation und ist ein reines Textformat zum Speichern und Austauschen von Daten.
Die Struktur besteht aus Schlüssel-Wert-Paaren, geschweiften Klammern und eckigen Klammern.
Es ist unabhängig von Programmiersprachen – fast jede Sprache kann JSON lesen und schreiben.
Erfunden wurde das Format 2001 von Douglas Crockford, standardisiert ist es heute über RFC 8259 und ECMA-404.
Öffnen kannst du eine JSON-Datei mit jedem simplen Texteditor – kein Spezialprogramm nötig.
Der größte Stolperstein sind kleine Syntaxfehler: verbotene Kommas, einfache Anführungszeichen, fehlende Klammern.

Was ist eine JSON-Datei? Die Antwort in einem Satz – plus der Rest

Eine JSON-Datei ist eine Textdatei, in der Daten nach einem festen Muster aufgebaut sind, sodass sowohl Menschen als auch Programme sie lesen können. Das war's im Kern. Keine Binärdaten, kein kompilierter Kram, kein proprietäres Format eines einzelnen Herstellers. Nur Text.

Der Name ist etwas irreführend. „JavaScript" steckt drin, aber mit JavaScript hat das Format heute nur noch historisch zu tun. Crockford arbeitete damals bei Yahoo und brauchte ein Format, das schlanker war als das, was es gab.

Und dann? Wurde es zum Standard. Wenn du heute eine App auf dem Handy öffnest und sie Wetterdaten, Nachrichten oder deine Bestellhistorie lädt, ist die Chance groß, dass dazwischen eine JSON-Datei im Spiel ist. Ich würde schätzen, dass 90 Prozent aller modernen Web-Schnittstellen damit arbeiten. Eine feste Zahl habe ich nicht, aber wenn ich in meine letzten fünf Projekte schaue: alle fünf.

Woher der Name kommt

„Object Notation" beschreibt genau, was du in der Datei siehst: die Notation, also die Schreibweise, von Objekten. Ein Objekt ist eine Sammlung von Eigenschaften. In JSON sieht das so aus:

{
  "name": "Anna",
  "alter": 34,
  "verheiratet": false,
  "hobbys": ["lesen", "wandern"],
  "adresse": {
    "stadt": "Leipzig",
    "plz": "04109"
  }
}

Das ist valides JSON. Geschweifte Klammern umschließen das Objekt, eckige Klammern eine Liste, und jedes Feld hat einen Namen in doppelten Anführungszeichen, gefolgt von einem Doppelpunkt und dem Wert. Fertig ist die Grundgrammatik.

Die erlaubten Datentypen

JSON kennt nur eine Handvoll Typen, und das ist Absicht:

String – Text in doppelten Anführungszeichen
Zahl – ganz oder mit Nachkommastelle, kein Komma als Trennzeichen
Boolean – true oder false
null – der ausdrückliche Wert „nichts vorhanden"
ein Objekt in geschweiften Klammern
ein Array in eckigen Klammern, das beliebig viele Werte enthalten darf

Fällt dir was auf? Keine Funktionen, keine Kommentare, kein Datumsformat. Genau das macht JSON so robust. Was nicht drin steht, kann auch nicht zu Interpretationsproblemen führen.

JSON-Datei öffnen – einfacher, als du denkst

Die häufigste Frage, die ich bekomme, wenn jemand zum ersten Mal eine JSON-Datei auf dem Rechner hat: „Womit öffne ich das?" Die kurze Antwort: mit allem, was Text anzeigen kann.

Welche Programme sich eignen

Meine Standard-Werkzeuge, sortiert nach Einsatzzweck:

Kurzer Blick → Doppelklick, der Browser zeigt den Inhalt direkt an. Funktioniert immer, ist aber unübersichtlich.
VS Code – mein Favorit. Der formatierte die Datei auf Wunsch mit einem Tastendruck und markiert Fehler sofort rot.
Online-Formatierer wie jsonformatter.org, wenn ich gerade keinen Editor zur Hand habe. Vorsicht bei sensiblen Daten, die gehen an einen fremden Server.
jq – Kommandozeilen-Tool für Leute, die öfter mit großen Dateien hantieren. Lernkurve vorhanden, zahlt sich aus.

Für Android nehmen viele einen Dateimanager plus einen Texteditor aus dem Play Store. Ehrlich gesagt: das ist fummelig. Wenn ich unterwegs schnell was prüfen muss, öffne ich die Datei lieber im Browser über eine Cloud-Ablage. Da kann ich wenigstens zoomen.

Ist eine JSON-Datei gefährlich?

Diese Frage taucht überraschend oft auf, und die ehrliche Antwort lautet: Eine JSON-Datei selbst kann nichts ausführen. Sie ist reiner Text. Sie kann deinen Rechner nicht hacken, sich nicht selbst starten und keine Programme installieren.

Die Gefahr liegt woanders. Wenn eine Anwendung die Daten aus einer JSON-Datei einliest und blind vertraut, kann ein Angreifer dort manipulierte Werte unterbringen. Das ist dann aber ein Fehler der Software, nicht des Formats. Ich hab das einmal in einem kleinen Testprojekt nachgestellt und war selbst überrascht, wie leichtfertig manche Code-Beispiele aus dem Netz so eine Datei einfach durchwinken. Seitdem prüfe ich bei eigenen Anwendungen immer, ob die erwartete Struktur wirklich da ist, bevor ich weiterverarbeite.

JSON-Datei erstellen – die Regeln, die dich retten

Eine JSON-Datei zu schreiben dauert zwei Minuten. Eine fehlerfreie zu schreiben, dauert beim ersten Mal deutlich länger. Hier sind die Regeln, an denen ich mich am häufigsten geschnitten habe:

Anführungszeichen sind immer doppelt. Einfache werden abgelehnt.
Nach dem letzten Eintrag in einem Objekt oder Array darf kein Komma stehen – der klassische Drei-Stunden-Bug von oben.
Kommentare gibt es nicht. Punkt. Wer sie braucht, nimmt YAML.
Zahlen bekommen keinen Tausenderpunkt und kein Komma als Dezimaltrenner.
Speichere die Datei als UTF-8, sonst zerlegt es Umlaute.

Mein Tipp aus der Praxis: Bau die Datei nicht von Hand, wenn es mehr als zwanzig Zeilen werden. Schreib sie in einem Programm, das den Typ kennt, und lass es die Datei erzeugen. Der Rechner macht keine Tippfehler.

Wie du prüfst, ob deine Datei gültig ist

Es gibt zwei Wege, und ich nutze beide. Erstens: ein Validator im Netz, in den du den Inhalt reinkopierst, und der dir Zeile und Spalte des Fehlers verrät. Zweitens, wenn du im Terminal unterwegs bist, jq – das gibt bei kaputtem JSON eine Fehlermeldung aus und bei gültigem entweder nichts oder formatierten Output.

Häufige Fehlermeldungen und was sie bedeuten

„Unexpected token" heißt fast immer: irgendwo steht ein Zeichen, das da nicht hingehört – oft ein Komma zu viel oder ein einfaches Anführungszeichen. „Unexpected end of input" bedeutet meist, dass eine Klammer nicht geschlossen wurde. Und „Invalid character" deutet auf Sonderzeichen oder eine falsche Kodierung hin.

JSON-Datei umwandeln – in Excel, PDF und zurück

JSON ist ein Zwischenformat. Irgendwann will jemand die Daten woanders sehen, und dann beginnt das Umwandeln. Ich hab das oft genug gemacht, um dir sagen zu können, wo die Fallstricke liegen.

JSON-Datei in Excel öffnen

Der direkte Weg über Excel ist seit einigen Versionen möglich: über den Datenimport kannst du eine JSON-Datei angeben und wählst dann die Felder aus, die zu Spalten werden sollen. Klingt gut, ist aber bei verschachtelten Strukturen schnell zäh.

Was bei mir zuverlässiger läuft: erst mit einem kleinen Skript in eine CSV umwandeln, dann in Excel öffnen. Bei einer Datei mit tiefen Ebenen – also Objekten in Objekten in Arrays – bleibt dir ohnehin nichts anderes übrig, als vorher zu entscheiden, welche Ebene du flach klopfen willst. Excel macht das nicht von allein.

JSON-Datei in PDF umwandeln

Hier muss ich kurz ehrlich sein: eine JSON-Datei eins zu eins als PDF auszugeben, ergibt selten Sinn. Ein PDF ist für Menschen gedacht, JSON für Maschinen. Wenn jemand danach fragt, meint er meistens einen Bericht oder eine Tabelle auf Basis der Daten.

Der Weg, den ich dafür gehe: JSON einlesen, in eine einfache Tabelle holen, und die dann als PDF exportieren. Manche Online-Konverter bieten das direkt an, aber bei größeren Dateien stoßen die schnell an Grenzen. Für den einmaligen Report reicht das, für Serienbriefe nicht.

JSON, YAML und XML im Vergleich

Alle drei tun im Grunde das Gleiche: strukturierte Daten als Text abbilden. Die Unterschiede zeigen sich erst im Alltag.

Format	Lesbarkeit für Menschen	Kommentare möglich	Typischer Einsatz
JSON	gut, aber streng	nein	APIs, Konfiguration, Datenaustausch
YAML	sehr gut	ja	Konfigurationsdateien, CI-Pipelines
XML	ausführlich bis langatmig	ja	ältere Systeme, Dokumentenformate

XML war lange der Platzhirsch, weil es strenger wirkt. Der Preis: deutlich mehr Zeichen für dieselbe Information. Ich hab vor Jahren ein Projekt von XML auf JSON umgestellt und die Dateigröße hat sich mehr als halbiert. Bei der Übertragung über langsame Verbindungen merkt man das.

YAML hat einen eigenen Charme, weil man weniger Klammern und Anführungszeichen braucht. Der Nachteil: die Einrückung muss stimmen, und ein falsch platzierter Tab kann alles kaputt machen. Da bin ich ehrlich gesagt zu oft drübergestolpert und bevorzuge in solchen Fällen JSON, einfach weil ich sehe, wo ich Klammern zu machen muss.

Warum du dich mit JSON-Dateien anfreunden solltest

Ich verstehe jeden, den die geschweiften Klammern am Anfang abschrecken. Ging mir nicht anders. Aber JSON ist eines der wenigen Formate, bei denen sich der Lernaufwand nach einer halben Stunde bereits bezahlt macht.

Es ist nicht die schönste Schreibweise für Menschen. Es ist nicht das mächtigste Format. Aber es ist überall, und das ist der Punkt. Wenn du weißt, wie eine JSON-Datei aufgebaut ist, öffnest du sie zur Not mit dem Editor und siehst sofort, was drinsteht. Du brauchst keine Software, keine Lizenz, keine Einarbeitung in ein weiteres Tool.

Die nächste Datei mit der Endung .json, die dir begegnet, wird dich nicht mehr erschrecken. Und falls doch – dann ist es wahrscheinlich nur ein fehlendes Komma. Frag nicht, woher ich das weiß.