Letzte Woche kam eine Nachricht von einem Kunden rein, die ich so ähnlich schon hundertmal gelesen habe: "Ich habe hier so eine komische Datei, die heißt irgendwas.json — kann ich die einfach aufmachen oder ist das gefährlich?"
Ich musste kurz schmunzeln, weil ich mich an genau dieselbe Frage erinnere. Vor ein paar Jahren saß ich vor dem Support-Ticket eines Shopsystems und starrte auf eine JSON-Datei, ohne zu ahnen, dass ich wenige Monate später fast täglich mit diesem Format arbeiten würde. Eine JSON-Datei ist am Ende nichts anderes als eine Textdatei, in der Daten in einer festen, von Menschen lesbaren Struktur gespeichert sind — quasi ein digitaler Aktenordner für Informationen, den sowohl Programme als auch Sie selbst öffnen und verstehen können.
Das Ding ist: Sobald man einmal begriffen hat, wie so eine Datei aufgebaut ist, verliert sie ihren Schrecken komplett. Kein Hexenwerk, keine Malware, kein Grund zur Panik. Ich zeige Ihnen, was drinsteckt, wie Sie sie öffnen, und wo die typischen Stolperfallen lauern.
Wichtige Erkenntnisse
- JSON steht für JavaScript Object Notation und ist ein reines Textformat zum Speichern und Austauschen von Daten.
- Der Aufbau basiert auf Schlüssel-Wert-Paaren in geschweiften Klammern — ähnlich einem beschrifteten Formular.
- Eine JSON-Datei ist kein Programm und führt nichts aus. Öffnen ist in der Regel ungefährlich.
- Erstellen und lesen können Sie JSON mit jedem einfachen Texteditor oder Online-Viewer.
- Kleine Syntaxfehler wie ein überzähliges Komma machen die ganze Datei ungültig.
Was eine JSON-Datei wirklich ist — einfach erklärt
Der Name ist ehrlich gesagt etwas irreführend. "JavaScript" lässt viele glauben, man müsse programmieren können, um das zu verstehen. Falsch. JSON wurde ursprünglich von Douglas Crockford im Jahr 2001 als schlanke Alternative zu XML ausgedacht, und der eigentliche Trick ist, dass es sich an eine uralte Idee anlehnt: Dinge mit einem Namen versehen und einen Wert dahinter schreiben.
Denken Sie an ein Adressetikett. Da steht "Name: Müller", "Stadt: Hamburg", "PLZ: 20095". Genau so funktioniert JSON. Der Name links, der Wert rechts, dazwischen ein Doppelpunkt. Fertig.
Der Aufbau einer JSON-Datei
Schauen wir uns ein echtes, kommentiertes Beispiel an. Nichts Wildes, nur ein Nutzerprofil:
{
"name": "Anna Schmidt",
"alter": 34,
"aktiv": true,
"hobbys": ["laufen", "fotografie"],
"adresse": {
"stadt": "München",
"plz": "80331"
}
}Was Sie hier sehen, sind die drei Bausteine, aus denen praktisch jede JSON-Datei besteht:
- Geschweifte Klammern
{ }umschließen ein Objekt — eine Sammlung von Schlüssel-Wert-Paaren. - Eckige Klammern
[ ]stehen für eine Liste, hier die Hobbys. Eine Liste darf mehrere Werte enthalten. - Schlüssel und Werte werden durch einen Doppelpunkt getrennt, die Schlüssel stehen immer in doppelten Anführungszeichen.
Auffällig: alter hat keine Anführungszeichen, weil es eine Zahl ist. aktiv steht ohne Anführungszeichen, weil es ein Wahrheitswert ist (true oder false). Nur Textwerte brauchen Anführungszeichen. Das ist eine der wichtigsten Regeln überhaupt.
Warum sich JSON überall durchgesetzt hat
Ich habe früher mit Schnittstellen gearbeitet, die XML zurückgaben, und ehrlich gesagt war das jedes Mal eine Zumutung. 200 Zeilen Klammer-Chaos für eine Handvoll Daten. Als ich das erste Mal eine API aufrief, die sauberes JSON lieferte, war das wie Fenster aufreißen nach einem stickigen Raum.
Der Grund für den Siegeszug ist schlicht: Kompaktheit. Eine JSON-Datei ist kürzer, schneller zu parsen und in fast jeder Programmiersprache in wenigen Zeilen einzulesen. Sie funktioniert unabhängig davon, ob Ihr System in Python, Java, PHP oder C# geschrieben ist. Deswegen liefert heute die überwiegende Mehrheit moderner Webschnittstellen ihre Daten als JSON aus, und auch Konfigurationsdateien vieler Tools setzen darauf.
JSON-Datei öffnen: welche Programme taugen
Die häufigste Frage überhaupt. Und die gute Nachricht: Sie brauchen dafür nichts Exotisches.
Eine JSON-Datei ist reiner Text. Wenn Sie sie mit dem Windows-Editor oder TextEdit auf dem Mac öffnen, sehen Sie genau den Inhalt, den ich oben gezeigt habe. Das reicht zum Nachschauen. Für alles darüber hinaus wird es aber schnell unübersichtlich, weil große Dateien ohne farbliche Hervorhebung ein einziger Buchstabensalat sind.
Lesbar anzeigen und formatieren
Meine Standardwahl ist Visual Studio Code. Kostenlos, läuft auf allen Plattformen und färbt Schlüssel, Werte und Klammern automatisch ein. Mit dem Tastenkürzel für "Format Document" räumt es sogar eine einzeilig hingeklatschte Datei in saubere, eingerückte Struktur um. Das hat mir schon oft den Abend gerettet.
Wenn Sie nichts installieren möchten, gibt es zwei bequeme Wege:
- Im Browser: Die meisten Browser zeigen JSON direkt an. Sie können die Datei einfach ins Fenster ziehen.
- Online-Viewer: Suchen Sie nach einem "JSON Viewer" und fügen Sie den Inhalt ein. Praktisch, aber bei sensiblen Daten würde ich davon abraten — die Daten gehen dabei an einen fremden Server.
Und was ist mit dem Smartphone? Auch auf Android öffnen Sie eine JSON-Datei mit einem beliebigen Texteditor aus dem Play Store oder mit einer Dateimanager-App, die eine Textvorschau bietet. Es braucht keine spezielle Software.
Ist eine JSON-Datei gefährlich?
Kurze Antwort: Nein, in sich selbst nicht. JSON ist ein reines Datenformat, vergleichbar mit einer Textdatei. Darin steckt kein ausführbarer Code. Öffnen allein kann nichts anrichten.
Ich will aber nicht in blinde Sorglosigkeit verfallen, denn die Gefahr liegt woanders. Die Gefahr liegt nicht im Format, sondern im Umgang damit:
- Die Herkunft: Eine .json-Datei aus einer unbekannten E-Mail-Anlage ist erst mal nur Datenmüll — aber vielleicht enthält sie Links oder Skript-Fragmente, die ein anderes Programm später verarbeitet. Vorsicht bei allem, was Sie nicht angefordert haben.
- Falsche Dateiendung: Ein Programm, das eigentlich ausführbar ist, aber .json heißt, sollten Sie misstrauisch beäugen.
- Ausführung durch Tools: Wenn eine Anwendung JSON automatisch verarbeitet, kann manipulierte Struktur dort Schaden anrichten — nicht aber beim bloßen Öffnen mit dem Editor.
Kurz: Texteditor auf, reinschauen, im Zweifel jemanden mit Ahnung fragen. Panik ist unbegründet.
JSON erstellen und umwandeln
Eine JSON-Datei selbst zu bauen ist keine Zauberei. Öffnen Sie einen Texteditor, tippen Sie die Struktur ein, speichern Sie die Datei mit der Endung .json — und achten Sie darauf, dass der Editor nicht heimlich .json.txt daraus macht. Diesen Fehler habe ich anfangs dreimal gemacht und mich gewundert, warum mein Programm die Datei nicht fand.
Die vier Klassiker, die jede JSON-Datei zerstören
JSON ist streng. Strenger, als die meisten erwarten. Diese Fehler sehe ich bei Kunden am häufigsten:
- Überzähliges Komma nach dem letzten Eintrag. In vielen Sprachen erlaubt, in JSON verboten.
- Einfache Anführungszeichen statt doppelter. JSON akzeptiert nur
". - Kommentare mit
//oder/ /. Die kennt JSON nicht — wer das versucht, bekommt eine Fehlermeldung. - Fehlende Anführungszeichen beim Schlüssel. Der Name links vom Doppelpunkt muss fast immer in Anführungszeichen stehen.
Validieren statt raten
Wenn eine Datei nicht geladen wird, liegt es fast immer an einem dieser vier Punkte. Statt mit den Augen zu suchen, kopieren Sie den Inhalt in einen JSON-Validator. Diese Tools sagen Ihnen exakt in welcher Zeile und an welcher Stelle der Fehler sitzt. Ich habe mir damit schon Stunden erspart.
Umwandeln und konvertieren
Irgendwann kommt fast jeder an den Punkt, an dem die Daten woanders hin sollen. Häufig gefragt: eine JSON-Datei in eine Tabelle oder ein PDF bringen. Technisch geht das, aber JSON ist dafür nicht der bequemste Weg.
| Zielformat | Wofür sinnvoll | Aufwand |
|---|---|---|
| CSV / Excel | Flache Listen, die Sie in Tabellen anschauen wollen | Gering, viele Tools konvertieren direkt |
| Weitergabe als lesbares Dokument | Umweg nötig: erst formatiert, dann gedruckt | |
| XML | Anbindung an ältere Systeme | Mittel, Konverter oder Skript |
| YAML | Lesbare Konfigurationsdateien | Gering für nicht verschachtelte Daten |
Für eine PDF-Ausgabe lade ich die Datei ehrlich gesagt am liebsten in einen Viewer, formatiere sie lesbar und lasse sie dann per Druckfunktion als PDF exportieren. Schneller, als sich mit Konvertern herumzuschlagen, die verschachtelte Strukturen ohnehin zerhacken.
Was von all dem hängen bleibt
Wenn ich auf die Eingangsfrage zurückkomme: Eine JSON-Datei ist ein Werkzeug, kein Werkzeugkasten mit Sprengsatz. Sie speichert Daten in einer Struktur, die Mensch und Maschine gleichermaßen verstehen. Sie zu öffnen ist so ungefährlich wie das Öffnen einer Notiz.
Das Einzige, was wirklich zählt, ist die Sorgfalt beim Erstellen und beim Prüfen der Herkunft. Und vielleicht diese kleine, hartnäckige Wahrheit: Der häufigste Grund, warum eine JSON-Datei "nicht funktioniert", ist nicht das Format. Es ist das überzählige Komma, das jemand nachts um zwei noch schnell eingetippt hat. Ich spreche aus Erfahrung.
Wenn Sie das nächste Mal auf eine .json-Datei stoßen: Klammern auf, Texteditor, reinschauen. Mehr braucht es nicht.
