JSON formatieren, einrücken und minifizieren: der schnelle Überblick

Was JSON formatieren überhaupt heißt

JSON ist für Maschinen gemacht, aber Menschen müssen es trotzdem oft lesen, in einer API-Antwort, einer Konfigurationsdatei oder einem Log. Ein JSON ist für den Parser völlig gleichgültig, ob es in einer einzigen langen Zeile steht oder schön eingerückt über viele Zeilen verteilt ist. Für das menschliche Auge macht das aber einen riesigen Unterschied.

Formatieren, oft auch Pretty-Print oder verschönern genannt, fügt Zeilenumbrüche und Einrückung ein. Jede Ebene der Verschachtelung rückt ein Stück weiter ein, sodass man die Struktur sofort erkennt. Minifizieren macht genau das Gegenteil: Es entfernt alle nicht zwingend nötigen Leerzeichen und Umbrüche, bis das JSON möglichst klein in einer Zeile steht.

Der entscheidende Punkt, den man sich merken sollte: Beide Operationen ändern nur die Darstellung, nie den Inhalt. Schlüssel, Werte, Zahlen, Wahrheitswerte und die Verschachtelung bleiben identisch. Ein formatiertes und ein minifiziertes JSON sind für jeden korrekten Parser dasselbe. Was JSON als Format überhaupt ausmacht, erklärt der Ratgeber Was ist JSON.

Pretty-Print gegen minifiziert im Vergleich

Am schnellsten versteht man den Unterschied an einem Beispiel. Hier dasselbe JSON einmal formatiert und einmal minifiziert. Zuerst die lesbare, eingerückte Variante:

{
  "app": {
    "name": "Demo",
    "version": "2.1",
    "debug": false
  },
  "limits": {
    "max": 100,
    "tags": ["a", "b", "c"]
  }
}

Und dieselben Daten minifiziert, in einer einzigen Zeile:

{"app":{"name":"Demo","version":"2.1","debug":false},"limits":{"max":100,"tags":["a","b","c"]}}

Die formatierte Version ist deutlich länger, lässt sich aber von oben nach unten lesen und in einem Editor bequem bearbeiten. Die minifizierte Version ist kompakt und spart bei großen Dateien spürbar Platz, ist aber für Menschen kaum zu erfassen. Diese Tabelle stellt die Eigenschaften gegenüber:

Einrückung: 2, 4 Leerzeichen oder Tab

Beim Pretty-Print stellt sich die Frage, wie tief eingerückt wird. Es gibt drei gängige Varianten, und keine ist objektiv falsch. Es ist letztlich eine Frage von Konvention und Geschmack.

• 2 Leerzeichen: die mit Abstand häufigste Wahl. Viele Werkzeuge, Bibliotheken und Konfigurationsdateien nutzen sie als Standard. Sie hält das JSON kompakt und trotzdem lesbar.
• 4 Leerzeichen: wirkt luftiger und betont die Verschachtelung stärker. Bei tief verschachtelten Strukturen wandert der Inhalt aber schnell weit nach rechts.
• Tab: ein einzelnes Tabulatorzeichen pro Ebene. Der Vorteil: Jeder kann im Editor selbst einstellen, wie breit ein Tab dargestellt wird. Der Nachteil: In manchen Umgebungen sieht es uneinheitlich aus.

Eine praktische Empfehlung: Wenn keine Vorgabe besteht, nimm 2 Leerzeichen. Damit bist du mit den meisten Werkzeugen und Projekten kompatibel. Wichtig ist vor allem, innerhalb eines Projekts einheitlich zu bleiben.

Wann kompaktes JSON sinnvoll ist

Minifiziertes JSON wirkt auf den ersten Blick unfreundlich, hat aber klare Anwendungsfälle. Überall dort, wo das JSON nicht von Menschen gelesen, sondern nur von Maschinen verarbeitet wird, ist die kompakte Form die bessere Wahl.

• API-Antworten: Ein Server, der viele Anfragen beantwortet, spart mit minifiziertem JSON Bandbreite. Bei großen Antworten summiert sich das.
• Speichern in Datenbanken: Wird JSON in einer Spalte abgelegt, braucht die kompakte Form weniger Platz.
• Übertragung und Caching: Kleinere Nutzlast bedeutet schnellere Übertragung. In Kombination mit Kompression ist der Effekt zwar geringer, aber spürbar.

Umgekehrt gilt: Sobald ein Mensch das JSON lesen oder bearbeiten soll, etwa eine Konfigurationsdatei, ein Beispiel in der Dokumentation oder ein in Versionsverwaltung abgelegter Stand, ist Pretty-Print besser. Gerade bei versionierten Dateien hat das einen handfesten Vorteil: Änderungen sind Zeile für Zeile nachvollziehbar, statt in einer einzigen riesigen Zeile zu verschwinden.

JSON im Browser formatieren: Schritt für Schritt

Der schnellste Weg, JSON zu formatieren oder zu minifizieren, führt über ein Browser-Tool, das lokal arbeitet. So gehst du vor:

1. Füge dein JSON in das Eingabefeld ein, oder erzeuge es aus einer INI-Datei über den Richtungs-Umschalter.
2. Wähle die gewünschte Einrückung: 2 Leerzeichen, 4 Leerzeichen oder Tab für lesbares JSON, oder kompakt für minifiziertes JSON.
3. Sieh dir das Ergebnis in der Vorschau an. Ist das JSON syntaktisch fehlerhaft, bekommst du einen Hinweis statt eines leeren Ergebnisses.
4. Kopiere das formatierte JSON mit einem Klick oder lade es als Datei herunter.

Der wichtige Unterschied zu vielen Online-Formatierern: Bei einem client-side Tool verlässt dein JSON den Browser nicht. Es gibt keinen Upload auf einen fremden Server, was besonders dann zählt, wenn das JSON sensible Daten enthält. Warum dieser Punkt so wichtig ist, behandelt der Ratgeber INI und JSON sicher umwandeln.

JSON formatieren im Code

Wer JSON programmatisch formatieren will, braucht meist keine Bibliothek, die Standardfunktionen reichen. In JavaScript steuert das dritte Argument von JSON.stringify die Einrückung:

const daten = JSON.parse(eingabe);

// Pretty-Print mit 2 Leerzeichen
const lesbar = JSON.stringify(daten, null, 2);

// mit Tab einrücken
const mitTab = JSON.stringify(daten, null, "\t");

// minifiziert (drittes Argument weglassen)
const kompakt = JSON.stringify(daten);

In PHP übernimmt das Flag JSON_PRETTY_PRINT die Einrückung, das Weglassen erzeugt kompaktes JSON:

<?php
// lesbar einrücken, mit echten Umlauten
echo json_encode($daten, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);

// minifiziert
echo json_encode($daten);

In Python regelt der Parameter indent die Einrückung, und separators sorgt für maximal kompakte Ausgabe:

import json

# Pretty-Print mit 2 Leerzeichen, Umlaute behalten
print(json.dumps(daten, indent=2, ensure_ascii=False))

# minifiziert (keine überflüssigen Leerzeichen)
print(json.dumps(daten, separators=(",", ":")))

Ein kleiner, aber wichtiger Hinweis zu Umlauten: Sowohl PHP als auch Python maskieren standardmäßig Nicht-ASCII-Zeichen. Mit JSON_UNESCAPED_UNICODE beziehungsweise ensure_ascii=False erscheinen ä, ö, ü direkt im JSON statt als kryptische Escape-Sequenzen. Beides ist gültiges JSON, die lesbare Variante ist aber meist angenehmer.

JSON aus INI sauber formatieren

Wenn dein JSON aus einer INI-Datei stammt, brauchst du gar keinen separaten Formatier-Schritt. Beim Umwandeln von INI nach JSON wählst du die Einrückung direkt mit. Der INI-zu-JSON-Konverter bietet dafür dieselben Optionen, 2 Leerzeichen, 4 Leerzeichen, Tab oder kompakt, und gibt das Ergebnis sofort im gewünschten Format aus.

Das spart einen Umweg: Statt erst umzuwandeln und dann durch ein zweites Tool zu schicken, erledigst du beides in einem Schritt. Wie die Umwandlung im Detail abläuft und welche Optionen es sonst noch gibt, etwa die Typ-Heuristik und verschachtelte Sektionen, zeigt der Ratgeber INI in JSON umwandeln.

Häufige Fehler und Missverständnisse

Beim Formatieren von JSON tauchen einige Irrtümer immer wieder auf. Diese drei sind die häufigsten.

Formatieren repariert kein kaputtes JSON

Ein Formatierer kann nur gültiges JSON einrücken. Fehlt ein Komma oder eine schließende Klammer, scheitert das Parsen, und das Tool kann nichts verschönern. Die Lösung ist nicht, härter zu formatieren, sondern den Syntaxfehler zu finden. Ein gutes Tool zeigt dir dazu einen Hinweis auf die fehlerhafte Stelle.

Kommentare gehören nicht in JSON

Reines JSON kennt keine Kommentare. Wer aus einer kommentierten Quelle wie INI nach JSON wandelt, verliert die Kommentare zwangsläufig. Manche Editoren erlauben einen erweiterten JSON-Dialekt mit Kommentaren, das ist aber kein Standard-JSON und wird von vielen Parsern abgelehnt.

Die Reihenfolge der Schlüssel kann sich ändern

Je nach Werkzeug bleibt die Schlüsselreihenfolge erhalten oder wird sortiert. Für die Bedeutung des JSON spielt die Reihenfolge keine Rolle, ein Objekt ist eine ungeordnete Menge von Paaren. Wer aber zwei Dateien vergleicht, sollte wissen, ob das Tool sortiert, sonst entstehen scheinbare Unterschiede.

Häufige Fragen