Was eine JSON-Datei ist, womit man sie öffnet und wie man sie bearbeitet

Kurz gesagt: Vor dem Öffnen einer JSON-Datei Kodierung und BOM prüfen und dann bestätigen, dass die Struktur nur ein Objekt oder ein Array ist; nach dem Bearbeiten immer mit einem Parser validieren, statt Klammern und Kommas mit den Augen zu prüfen.

Es ist einfach eine Klartextdatei mit der Endung .json, die sogar Notepad öffnen kann. Der eigentliche Kummer ist nicht „sie öffnet sich nicht“, sondern dass man nach dem Öffnen nicht sieht, was man kaputt gemacht hat.

1. Was tatsächlich in einer JSON-Datei steckt

Eine gültige JSON-Datei kann nur eines von zwei Dingen enthalten: ein Objekt {...} oder ein Array [...]. Nichts anderes ist erlaubt – keine Variablendeklarationen, keine Kommentare, keine Funktionen.

复制{
  "name": "order service",
  "port": 8080,
  "debug": false,
  "upstream": ["10.0.0.11", "10.0.0.12"],
  "timeout": null
}

Strukturell genügt es, drei Dinge zu erkennen:

Die Dateiendung bestimmt den Inhalt nicht: package.json, tsconfig.json und composer.json sind alle derselbe Typ; verschiedene Werkzeuge haben sich nur darauf geeinigt, unterschiedliche Schlüssel daraus zu lesen.

2. Drei Wege, sie zu öffnen – je nach Szenario

Nur ein kurzer Blick: im Browser öffnen. Ziehen Sie die Datei in ein Chrome- oder Edge-Fenster, und der Browser zeigt sie unverändert an; ist eine JSON-Viewer-Erweiterung installiert, wird sie automatisch hübsch formatiert und aufklappbar.

Inhalt bearbeiten: einen Editor verwenden. VS Code, Sublime und Notepad++ bringen alle JSON-Syntaxhervorhebung und Klammerpaarung mit, und Shift + Alt + F formatiert in VS Code das Dokument. Beachten Sie, dass der Windows-Editor beim Speichern ein BOM hinzufügen kann, sodass Ihre Konfigurationsänderung womöglich nicht wirkt; besser meiden.

Nichts installieren, nur validieren: den Online-JSON-Formatter verwenden. Inhalt einfügen und sofort Zeilen- und Spaltennummern, Fehlerstellen und einen aufklappbaren Baum sehen; danach das Ergebnis herauskopieren. Die Daten werden lokal im Browser verarbeitet und nicht auf einen Server hochgeladen.

Große Dateien (zig MB oder mehr): nicht in einen Editor zwingen. Eine 100-MB-JSON-Datei in VS Code zu öffnen blockiert so lange, dass man an seinen Lebensentscheidungen zweifelt; prüfen Sie die Struktur zuerst über die Kommandozeile:

复制# Look at the first 20 lines to confirm whether it is an array
head -n 20 data.json

# Use jq to list top-level keys without loading the whole file
jq -r 'keys[]' data.json | head

# Count the array length
jq 'length' data.json

3. Was tun, wenn ein Doppelklick Kauderwelsch öffnet

Drei Ursachen, jede anders zu behandeln:

1. Es ist tatsächlich eine Binärdatei (etwa ein komprimiertes Archiv oder ein exportiertes Datenbankfile mit der Endung .json). Mit file data.json den echten Typ ansehen; nicht erzwingen, dass es als Text behandelt wird.
2. Die Kodierung ist nicht UTF-8. Als GBK kodierter chinesischer Text ist in einer UTF-8-Umgebung Kauderwelsch. Im Editor „mit Kodierung erneut öffnen“ verwenden und einmal GBK probieren; wenn es korrekt angezeigt wird, als UTF-8 speichern.
3. Die Datei wurde verschlüsselt oder komprimiert. Das Symptom ist PK (zip) oder ein Haufen Fragezeichen am Anfang; solche Dateien müssen zuerst entpackt oder entschlüsselt werden.

4. Wie man nach dem Bearbeiten bestätigt, dass nichts kaputt ist

JSON kennt keine Toleranz: ein fehlendes Komma, ein überzähliges Komma oder ein fehlendes Anführungszeichen und die ganze Datei ist tot, und die gemeldete Fehlerstelle zeigt oft auf die nächste Zeile. Also nach dem Bearbeiten validieren; nicht auf die Augen verlassen.

Die drei riskanten Bearbeitungsschritte, sortiert nach Häufigkeit der Probleme:

Die Validierung ist einfach: in den Online-Validator einfügen und nach rotem Text suchen, oder eine Zeile auf der Kommandozeile ausführen:

复制python3 -m json.tool config.json > /dev/null && echo OK

Wenn OK erscheint, ist die Datei gültig. Wenn Sie auch Feldtypen validieren wollen (etwa port muss eine Zahl sein und name darf nicht leer sein), ist ein JSON Schema weit verlässlicher als menschliche Augen.

5. Wie sich .json von seinen nahen Verwandten unterscheidet

Wundern Sie sich nicht über Kommentare in tsconfig.json; sie wird tatsächlich als .jsonc behandelt. Denselben Inhalt an JSON.parse zu geben, erzeugt einen Fehler. Wenn Sie zwischen ihnen konvertieren müssen, entfernen Sie mit JSON5 zu JSON Kommentare und nachfolgende Kommas mit einem Klick.

6. Wann es Zeit ist, das Speicherformat zu wechseln

JSON passt zu Szenarien, in denen „die Struktur nicht fest ist, Menschen sie lesen müssen und sie sprachübergreifend reist“. Überschreitet eine Datei zig MB, ist die Feldstruktur stabil und brauchen Sie bedingte Abfragen, macht es Ihnen nur Mühe, bei JSON zu bleiben – wechseln Sie zu SQLite, Parquet oder laden Sie sie in eine Datenbank; die Lese-/Schreibleistung unterscheidet sich um Größenordnungen. Zu den konkreten Abwägungen siehe Große JSON-Dateien parsen und streamen.

FAQ

Wie kann ich eine JSON-Datei prüfen, die zu groß zum Öffnen ist?

Nicht in einen Editor zwingen; eine 100-MB-JSON-Datei in VS Code zu öffnen blockiert so lange, dass man an seinen Lebensentscheidungen zweifelt. Prüfen Sie die Struktur zuerst über die Kommandozeile: head -n 20 bestätigt, ob es ein Array ist, jq -r 'keys[]' listet nur die Schlüssel der obersten Ebene, und jq 'length' zählt die Array-Länge. Keiner dieser Befehle lädt die ganze Datei.

Warum wirken meine Änderungen im Editor nicht, sodass die Konfiguration nicht greift?

Der Windows-Editor kann beim Speichern ein BOM hinzufügen, und eine Datei mit BOM scheitert beim Parsen der Konfiguration, sodass der bearbeitete Inhalt nie wirksam wird. Die Empfehlung des Artikels ist, Editoren wie VS Code, Sublime oder Notepad++ zu verwenden, die JSON-Syntaxhervorhebung und Klammerpaarung mitbringen. Wenn Sie bereits den Editor benutzt haben, speichern Sie erneut als „UTF-8 ohne BOM“ und versuchen es noch einmal.

Kann ich eine JSON-Datei als JSON5 behandeln und Kommentare hinzufügen?

Nein – ein Standardparser erlaubt keine Kommentare in einer .json-Datei, und JSON.parse wirft sofort einen Fehler. Kommentare gehören in .jsonc- oder .json5-Dateien, die vom passenden Parser gelesen werden. Dateien wie tsconfig.json werden tatsächlich als .jsonc behandelt; denselben Inhalt an JSON.parse zu geben, scheitert.