📋
← Zurück zu Anleitungen

JSON Pretty Print: So formatieren Sie JSON für optimale Lesbarkeit

· Tags: json, pretty-print, json-formatter, json-indentation, developer-tools

Was ist JSON Pretty Printing?

JSON Pretty Printing ist der Prozess, bei dem rohe, kompakte (minifizierte) JSON-Daten entgegengenommen und mit korrekter Einrückung, Zeilenumbrüchen und Abständen neu formatiert werden, um sie für Menschen lesbar zu machen. Ein hübsch formatiertes JSON-Dokument verwendet konsistente Einrückung und klare strukturelle Formatierung, die die Hierarchie verschachtelter Objekte und Arrays offenbart.

Vergleichen Sie diese beiden Darstellungen derselben Daten:

Minifiziert (schwer zu lesen):

{"users":[{"id":1,"name":"Alice","roles":["admin","editor"]},{"id":2,"name":"Bob","roles":["viewer"]}],"total":2}

Hübsch formatiert (leicht zu lesen):

{
  "users": [
    {
      "id": 1,
      "name": "Alice",
      "roles": ["admin", "editor"]
    },
    {
      "id": 2,
      "name": "Bob",
      "roles": ["viewer"]
    }
  ],
  "total": 2
}

Pretty Print vs. minifiziertes JSON

Die Wahl zwischen hübsch formatiertem und minifiziertem JSON hängt vom Anwendungsfall ab:

| Aspekt | Pretty Print | Minifiziert | |--------|-------------|----------| | Lesbarkeit | Hoch -- klare Struktur | Niedrig -- alle Daten in einer Zeile | | Dateigröße | Größer (mehr Leerraum) | Kleiner (kein Leerraum-Overhead) | | Netzwerkübertragung | Langsamer bei großen Payloads | Schneller, weniger Bandbreite | | Debugging | Ideal für die Entwicklung | Unpraktisch zur Inspektion | | Produktionseinsatz | Selten verwendet | Standard für API-Antworten |

Produktions-APIs liefern in der Regel minifiziertes JSON, um Bandbreite zu sparen, während Entwickler JSON während Entwicklung und Debugging hübsch formatieren.

Einrückungsstile

Die meisten Formatter unterstützen zwei gängige Einrückungsstile:

2-Leerzeichen-Einrückung (am häufigsten)

{
  "name": "Alice",
  "age": 30,
  "address": {
    "city": "New York"
  }
}

Empfohlen für: JavaScript-/TypeScript-Projekte, moderne Webentwicklung und die meisten allgemeinen Anwendungen.

4-Leerzeichen-Einrückung

{
    "name": "Alice",
    "age": 30,
    "address": {
        "city": "New York"
    }
}

Empfohlen für: Python-Projekte (PEP-8-Stil) und Teams, die aus Gründen der Klarheit breitere Einrückung bevorzugen.

Tab-Einrückung

Einige Entwickler bevorzugen tabbasierte Einrückung, insbesondere in barrierefreiheitsorientierten Workflows, bei denen Benutzer die Tab-Breite in ihrem Editor anpassen.

Die richtige Einrückung wählen

Die meisten Teams standardisieren auf 2 Leerzeichen, weil sie Lesbarkeit mit horizontaler Platzeffizienz in Einklang bringt. Das JavaScript-Ökosystem (Node.js, React, Vue) verwendet überwiegend 2-Leerzeichen-Einrückung. Wenn Sie in einer Python-lastigen Umgebung arbeiten, fühlt sich die 4-Leerzeichen-Einrückung möglicherweise natürlicher an. Entscheidend ist Konsistenz -- wählen Sie einen Stil und setzen Sie ihn in Ihrem gesamten Projekt mit einem Tool wie Prettier oder EditorConfig durch.

JSON Pretty Print in verschiedenen Programmiersprachen

JavaScript / Node.js

const formatted = JSON.stringify(data, null, 2);
console.log(formatted);

Python

import json
formatted = json.dumps(data, indent=2)
print(formatted)

Java

import com.fasterxml.jackson.databind.ObjectMapper;
ObjectMapper mapper = new ObjectMapper();
String formatted = mapper.writerWithDefaultPrettyPrinter()
    .writeValueAsString(data);

Go

import "encoding/json"
formatted, _ := json.MarshalIndent(data, "", "  ")
fmt.Println(string(formatted))

Ruby

require 'json'
puts JSON.pretty_generate(data)

So geben Sie JSON hübsch aus

Einen Online-JSON-Formatter verwenden

Die schnellste Methode ist die Verwendung eines kostenlosen Online-JSON-Formatters -- fügen Sie Ihr JSON ein und erhalten Sie sofort formatierte Ausgabe mit Syntaxhervorhebung und Fehlererkennung.

Befehlszeilen-Tools verwenden

Mit jq (am beliebtesten):

cat file.json | jq .

Mit Python:

python -m json.tool file.json

Mit Node.js:

node -e "const d = require('./file.json'); console.log(JSON.stringify(d, null, 2));"

Browser-Entwicklertools

Alle gängigen Browser formatieren JSON-Antworten automatisch in ihren Network-Tabs:

  • Chrome DevTools: Der Network-Tab formatiert JSON-Antworten automatisch hübsch
  • Firefox Developer Tools: JSON-Antworten werden mit aufklappbaren Baumansichten angezeigt
  • Safari Web Inspector: Die JSON-Vorschau enthält automatische Formatierung

IDE-Plugins für die JSON-Formatierung

VS Code

VS Code hat eine ausgezeichnete integrierte JSON-Unterstützung. Verwenden Sie Shift+Alt+F (Windows/Linux) oder Shift+Option+F (macOS), um jede JSON-Datei zu formatieren. Zusätzliche Erweiterungen verbessern die Erfahrung:

  • Prettier -- Formatiert JSON, JSONC und viele andere Sprachen konsistent
  • JSON Tools -- Sortieren, minifizieren und formatieren Sie JSON mit Tastenkombinationen
  • JavaScript Booster -- Erweiterte JSON-Manipulationsfunktionen

JetBrains-IDEs (IntelliJ, WebStorm, PyCharm)

  • Integrierter Formatter: Ctrl+Alt+L (Windows/Linux) oder Cmd+Option+L (macOS)
  • Automatische JSON-Validierung und -Formatierung beim Einfügen

Vim / Neovim

" Format JSON in place
:%!jq .

Erweiterte JSON-Formatierungsoptionen

Moderne JSON-Formatter bieten mehr als nur grundlegende Einrückung:

  • Schlüsselsortierung -- Objektschlüssel für konsistente Ausgabe alphabetisch sortieren
  • Syntaxhervorhebung -- Farbcodierte Schlüssel, Strings, Zahlen und Booleans
  • Aufklappbare Bäume -- Verschachtelte Strukturen für einfachere Navigation auf- und zuklappen
  • Zeilennummern -- Beziehen Sie sich während des Debuggens auf bestimmte Stellen
  • Fehlerhervorhebung -- Syntaxfehler visuell mit detaillierten Meldungen markieren

Best Practices für die Lesbarkeit von JSON

  1. Immer vor dem Formatieren validieren -- Ein Formatter kann ungültiges JSON nicht reparieren. Verwenden Sie zuerst einen JSON-Validator , um Syntaxfehler zu erkennen.
  2. Einen Teamstandard festlegen -- Einigen Sie sich auf die Einrückung (2 Leerzeichen ist der Industriestandard) und setzen Sie sie mit Prettier oder einem Linter durch.
  3. Verschachtelung flach halten -- Tief verschachteltes JSON (4+ Ebenen) ist unabhängig von der Formatierung schwer zu lesen. Erwägen Sie bei Bedarf eine Umstrukturierung.
  4. Aussagekräftige Schlüssel verwenden -- Beschreibende, prägnante Schlüsselnamen verbessern die Lesbarkeit mehr als jeder Formatter.
  5. Nachgestellte Zeilenumbrüche hinzufügen -- Beenden Sie JSON-Dateien mit einem Zeilenumbruch, um POSIX-Standards zu erfüllen und Diff-Rauschen zu vermeiden.

Probieren Sie unser kostenloses Online-JSON-Pretty-Print-Tool aus, um Ihre JSON-Daten sofort mit anpassbarer Einrückung und Syntaxhervorhebung zu formatieren und zu verschönern.