JSON formatieren in VS Code, Notepad++ und IntelliJ

In VS Code und in IntelliJ-Editoren ist ein JSON-Formatierer schon eingebaut, du brauchst nur das richtige Tastenkürzel. Notepad++ kann JSON nicht von Haus aus formatieren, dafür installierst du ein Plugin. Dieser Ratgeber zeigt für alle drei den kürzesten Weg und sagt dir, wann du dir die Einrichtung sparen kannst.

Wenn du nur schnell ein einzelnes JSON lesbar machen willst, geht es ohne jede Einrichtung: Füge es in den JSON-Formatierer ein. Er rückt das JSON ein, meldet Fehler mit Zeile und Spalte auf Deutsch und verarbeitet alles lokal in deinem Browser, ohne etwas an einen Server zu senden.

VS Code: Format Document

VS Code bringt einen JSON-Formatierer mit. So gehst du vor:

1. Öffne die Datei oder füge den Text in einen neuen Editor ein.
2. Stelle unten rechts in der Statusleiste die Sprache auf JSON (bei einem neuen, unbenannten Editor steht dort „Nur-Text“ beziehungsweise „Plain Text“).
3. Führe Format Document aus:

Alternativ öffnest du die Befehlspalette (Ctrl+Shift+P, auf dem Mac Cmd+Shift+P) und tippst „Format Document“. Hast du nur einen Teil markiert, formatiert Format Selection (Ctrl+K Ctrl+F, auf dem Mac Cmd+K Cmd+F) nur die Auswahl.

Hinweis: Bei Dateien wie tsconfig.json oder settings.json erkennt VS Code den Modus „JSON mit Kommentaren“ (JSONC). Dort sind Kommentare erlaubt, in normalem JSON nicht – mehr dazu im Ratgeber Kommentare in JSON.

Automatisch beim Speichern formatieren

In der settings.json (Befehlspalette: „Preferences: Open User Settings (JSON)“) legst du fest, dass nur JSON-Dateien beim Speichern formatiert werden:

{
  "[json]": {
    "editor.defaultFormatter": "vscode.json-language-features",
    "editor.formatOnSave": true,
    "editor.tabSize": 2
  }
}

Die wichtigsten Einstellungen:

• editor.formatOnSave: formatiert beim Speichern (Standard: aus).
• editor.tabSize und editor.insertSpaces: Breite und Art der Einrückung.
• json.format.enable: schaltet den eingebauten JSON-Formatierer ein oder aus (Standard: ein).
• json.format.keepLines: behält vorhandene Zeilenumbrüche bei, statt sie neu zu setzen.

Kommt beim Formatieren die Meldung, es gebe keinen Formatierer, steht der Sprachmodus meist nicht auf JSON, oder json.format.enable ist ausgeschaltet.

Ein Formatierer repariert kein kaputtes JSON. Enthält der Text einen Syntaxfehler, markiert VS Code ihn mit einer roten Wellenlinie, und das Ergebnis des Formatierens ist nicht verlässlich. Behebe zuerst den Fehler; Typisches steht im Ratgeber JSON-Fehler finden und beheben.

Notepad++: Plugin installieren

Notepad++ hat keinen eingebauten JSON-Formatierer. Du brauchst ein Plugin, das du über die Plugin-Verwaltung installierst:

1. Öffne im Menü Plugins den Eintrag Plugins Admin….
2. Suche nach JSON Viewer oder JSTool und setze ein Häkchen.
3. Klicke auf Install. Notepad++ startet danach neu.

Beide Plugins legen anschließend einen eigenen Eintrag im Menü Plugins an, über den du das JSON formatierst. Die genauen Untermenüs und Tastenkürzel hängen von der Plugin-Version ab; schau deshalb nach der Installation direkt im jeweiligen Plugin-Menü nach. Wenn du Notepad++ nur für gelegentliche JSON-Dateien nutzt und keine Plugins installieren möchtest (oder darfst, etwa auf einem Firmenrechner), ist der Online-Formatierer der einfachere Weg.

IntelliJ IDEA und WebStorm: Reformat Code

In IntelliJ IDEA, WebStorm und den anderen JetBrains-IDEs formatierst du JSON-Dateien mit Reformat Code:

Du findest den Befehl auch im Menü Code → Reformat Code. Ist Text markiert, wird nur die Auswahl formatiert.

Einrückung, Zeilenumbrüche und Ähnliches stellst du unter Settings → Editor → Code Style → JSON ein. Unter Settings → Tools → Actions on Save kannst du „Reformat code“ aktivieren, damit die IDE beim Speichern automatisch formatiert.

Unter Linux kann Ctrl+Alt+L je nach Desktop-Umgebung mit dem Befehl zum Sperren des Bildschirms kollidieren. Dann belegst du das Kürzel in der IDE oder im System neu.

Eine Besonderheit: Formatieren ändert nur Leerraum

Ein guter Formatierer ändert nur Leerzeichen und Zeilenumbrüche, nicht den Inhalt. Das gilt für die drei Editoren in der Regel, wenn der Formatierer auf dem Text arbeitet. Anders ist es bei Werkzeugen, die das JSON erst in Objekte einlesen und wieder ausgeben: Dabei können große Zahlen ungenau werden, weil JavaScript Zahlen als 64-Bit-Fließkommazahlen speichert (siehe Große Zahlen in JSON). Der JSON-Formatierer arbeitet verlustfrei: Er behält Zahlen exakt so, wie sie im Text stehen, ebenso die Reihenfolge der Schlüssel und doppelte Schlüssel.

Wann der Online-Formatierer schneller ist

Der Editor lohnt sich, wenn du ohnehin Dateien bearbeitest und beim Speichern automatisch formatieren willst. In diesen Fällen ist der Online-Formatierer schneller:

• Kein Setup: Du hast Notepad++ ohne Plugin, einen fremden Rechner oder nur ein Handy zur Hand.
• Text statt Datei: Eine API-Antwort oder ein Log-Auszug liegt in der Zwischenablage, du willst keine Datei anlegen.
• Fehlersuche: Der Formatierer nennt Zeile und Spalte und erklärt den Fehler auf Deutsch, ein Klick auf die Meldung markiert die Stelle. Die Meldungen der Editoren sind knapper und meist englisch.
• Minifizieren: Mit einem Klick fasst du das JSON auf eine Zeile zusammen (mehr im Ratgeber JSON minifizieren). VS Code hat dafür keinen eingebauten Befehl.

Für Skripte und Pipelines ist die Kommandozeile die bessere Wahl: JSON formatieren in der Kommandozeile.

Kurz gesagt

• VS Code: Sprache auf JSON stellen, dann Shift+Alt+F (Windows), Shift+Option+F (Mac) oder Ctrl+Shift+I (Linux). Mit editor.formatOnSave geschieht das automatisch.
• Notepad++: kein eingebauter Formatierer; installiere JSON Viewer oder JSTool über Plugins → Plugins Admin….
• IntelliJ und WebStorm: Reformat Code mit Ctrl+Alt+L beziehungsweise Cmd+Option+L.
• Formatierer reparieren kein kaputtes JSON; erst den Syntaxfehler beheben.
• Für einzelne Texte ohne Einrichtung ist der JSON-Formatierer am schnellsten, und er arbeitet lokal im Browser.

Weiterlesen: JSON-Fehler finden und beheben, JSON minifizieren, JSON formatieren in der Kommandozeile, JSON-Datei öffnen.