Formatierer

JSON-Datei öffnen und lesen – unter Windows, Mac und im Browser

Zuletzt aktualisiert am

Eine .json-Datei ist eine reine Textdatei. Du kannst sie deshalb mit jedem Texteditor öffnen: unter Windows mit dem Editor (Notepad), auf dem Mac mit TextEdit, besser noch mit Visual Studio Code oder direkt im Browser. Schwierig wird es nur, wenn der gesamte Inhalt in einer einzigen Zeile steht. Dann hilft das Formatieren.

Für diesen Fall kopierst du den Text einfach in den JSON-Formatierer. Er rückt die Struktur ein und nennt bei Fehlern Zeile und Spalte, auf Deutsch. Die Verarbeitung läuft komplett lokal in deinem Browser, es wird nichts an einen Server gesendet.

Was eine .json-Datei ist

JSON („JavaScript Object Notation“) ist ein Textformat für strukturierte Daten. Programme, Webdienste und Apps nutzen es für Einstellungen, Exporte und Schnittstellen. Der Inhalt besteht aus Objekten ({ … }), Listen ([ … ]), Texten, Zahlen, true/false und null. Eine Einführung findest du im Ratgeber Was ist JSON?.

Die Dateiendung .json verrät nur, wie der Inhalt gemeint ist. Technisch steckt Text darin, meist in UTF-8. Ein Beispiel:

{
  "name": "Ada",
  "sprachen": ["de", "en"],
  "aktiv": true
}

Fehlt bei dir die Endung, ist sie womöglich ausgeblendet. Unter Windows schaltest du sie im Explorer im Menü „Ansicht“ ein (Option „Dateinamenerweiterungen“, je nach Windows-Version unter „Anzeigen“). Auf dem Mac geht das im Finder unter „Einstellungen“ → „Erweitert“ → „Alle Dateinamensuffixe einblenden“.

Mit Editor oder TextEdit öffnen

Der schnellste Weg ohne zusätzliche Software:

  • Windows: Rechtsklick auf die Datei → „Öffnen mit“ → „Editor“. Ein Doppelklick öffnet die Datei dagegen oft in einem anderen Programm, etwa im Browser.
  • Mac: Rechtsklick (oder Ctrl-Klick) auf die Datei → „Öffnen mit“ → „TextEdit“.

TextEdit kann Dokumente als Rich Text oder als reinen Text behandeln. Für JSON brauchst du reinen Text. Zeigt TextEdit eine Formatierungsleiste, wandle das Dokument mit „Format“ → „In reinen Text umwandeln“ (Umschalt-Cmd-T) um. Achte außerdem darauf, dass „Intelligente Anführungszeichen“ ausgeschaltet sind, wenn du in TextEdit änderst und speicherst. Typografische Anführungszeichen („ “) sind in JSON ungültig, es zählen nur gerade ".

Der Nachteil beider Programme: keine Einfärbung, kein Einklappen, kein Formatieren. Zum Lesen großer Dateien taugen sie wenig.

Mit Visual Studio Code öffnen

Visual Studio Code ist kostenlos und für Windows, Mac und Linux erhältlich. Es erkennt .json automatisch:

  1. Datei öffnen mit „Datei“ → „Datei öffnen …“ (Strg+O bzw. Cmd+O) oder per Drag-and-drop ins Fenster.
  2. Die Syntax wird eingefärbt, Klammern lassen sich am Rand ein- und ausklappen, und Fehler werden rot unterstrichen.
  3. Formatieren mit Umschalt+Alt+F (Windows) bzw. Umschalt+Option+F (Mac). Alternativ über die Befehlspalette (Strg+Umschalt+P bzw. Cmd+Umschalt+P) den Befehl „Dokument formatieren“ ausführen.

Mehr zu Editoren und ihren Formatier-Funktionen steht im Ratgeber JSON im Editor formatieren.

Im Browser öffnen: Firefox und Chrome

Du kannst eine lokale Datei per Drag-and-drop in ein Browserfenster ziehen oder mit Strg+O bzw. Cmd+O auswählen. Die Browser gehen dabei unterschiedlich vor:

  • Firefox hat einen eingebauten JSON-Viewer. Er zeigt die Daten als Baum, den du auf- und zuklappen kannst, und bietet einen Filter für Suchbegriffe. Auf dem Reiter „Rohdaten“ siehst du den Originaltext und kannst ihn dort über die Schaltfläche zum Formatieren (englisch „Pretty Print“) einrücken lassen. Der Viewer erscheint für Dateien mit gültigem JSON. Ist der Inhalt kein gültiges JSON, fällt Firefox auf die normale Textanzeige zurück. Das ist ein brauchbarer Hinweis auf einen Fehler in der Datei.
  • Chrome zeigt JSON als Text an. Aktuelle Versionen bieten oben ein Kästchen, mit dem du den Text eingerückt anzeigen lässt, aber keine aufklappbare Baumansicht. Dafür brauchst du eine Erweiterung, oder du kopierst den Text in den JSON-Formatierer.

Der Browser liest die Datei nur von deiner Festplatte; ohne Erweiterungen gibt er sie nicht weiter. Wie du auch bei Online-Werkzeugen auf der sicheren Seite bleibst, erklärt der Ratgeber Ist ein Online-JSON-Formatierer sicher?.

Lesbar machen mit dem JSON-Formatierer

Viele Programme exportieren JSON „minifiziert“, also in einer Zeile:

{"name":"Ada","sprachen":["de","en"],"adresse":{"ort":"Berlin","plz":"10115"},"aktiv":true}

So gehst du vor:

  1. Öffne die Datei in einem beliebigen Editor, markiere alles (Strg+A bzw. Cmd+A) und kopiere es (Strg+C bzw. Cmd+C).
  2. Füge den Text im JSON-Formatierer ein.
  3. Formatiere ihn. Du bekommst eingerückten, lesbaren Text. Ist das JSON fehlerhaft, nennt der Formatierer Zeile und Spalte der Stelle.

Der Formatierer hat keinen Datei-Upload, du arbeitest über Kopieren und Einfügen. Das Formatieren verändert nur die Leerzeichen: Zahlen wie 1.0 oder 12345678901234567890, die Reihenfolge der Schlüssel und doppelte Schlüssel bleiben erhalten.

In Excel importieren

Enthält die JSON-Datei eine Liste gleichartiger Einträge, etwa Kunden oder Messwerte, kannst du sie in Excel als Tabelle laden. In neueren Versionen (Microsoft 365, Excel 2019 und neuer) funktioniert das so:

  1. „Daten“ → „Daten abrufen“ → „Aus Datei“ → „Aus JSON“.
  2. Datei auswählen. Der Power-Query-Editor öffnet sich.
  3. Bei einer Liste erscheint oben „In Tabelle“. Klicke darauf und bestätige.
  4. In der Spaltenüberschrift öffnet das Symbol mit den zwei Pfeilen die Felder der Einträge (Records). Wähle die gewünschten Spalten aus.
  5. „Schließen und laden“ schreibt das Ergebnis ins Tabellenblatt.

Verschachtelte Daten musst du Ebene für Ebene aufklappen. Die Menüführung kann sich je nach Version leicht unterscheiden.

Datei lässt sich nicht lesen?

  • Alles in einer Zeile oder unleserlich: Das ist normal bei minifiziertem JSON. Formatiere den Text wie oben beschrieben.
  • Merkwürdige Zeichen vor der ersten Klammer: Die Datei hat womöglich ein unsichtbares BOM. Siehe BOM in JSON-Dateien.
  • Fehlermeldung beim Öffnen in einem Programm: Meist steckt ein Syntaxfehler in der Datei. Die häufigsten Ursachen stehen im Ratgeber JSON-Fehler finden und beheben.
  • Umlaute sehen falsch aus: Der Editor liest die Datei nicht als UTF-8. Stelle die Kodierung im Editor um. In VS Code geht das über die Statusleiste unten rechts.

Kurz gesagt

  • Eine .json-Datei ist reiner Text, du kannst sie mit jedem Editor öffnen.
  • Am bequemsten liest du sie in VS Code oder in Firefox mit seinem JSON-Viewer. Chrome rückt JSON zwar ein, bietet aber keine Baumansicht.
  • Steht alles in einer Zeile, kopiere den Inhalt in den JSON-Formatierer, der ihn lokal im Browser einrückt.
  • Für Tabellendaten hilft in Excel „Daten“ → „Daten abrufen“ → „Aus Datei“ → „Aus JSON“.
  • Bei Fehlern lohnt ein Blick in JSON-Fehler finden und beheben.

Weiterlesen: Was ist JSON?, JSON im Editor formatieren und Ist ein Online-JSON-Formatierer sicher?.