JSON formatieren: Vollständige Anleitung mit Tools und Techniken

Python

Grundlegende Formatierung

import json

daten = {
    "name": "Max Mustermann",
    "alter": 30,
    "adresse": {
        "stadt": "Berlin",
        "plz": "10115"
    }
}

# Mit 2 Leerzeichen
formatiert = json.dumps(daten, indent=2, ensure_ascii=False)
print(formatiert)

# Mit 4 Leerzeichen
formatiert4 = json.dumps(daten, indent=4, ensure_ascii=False)

# Sortierte Schlüssel
sortiert = json.dumps(daten, indent=2, sort_keys=True, ensure_ascii=False)

Datei formatieren

import json

# JSON-Datei lesen und formatieren
with open('daten.json', 'r', encoding='utf-8') as f:
    daten = json.load(f)

# Formatiert zurückschreiben
with open('daten.json', 'w', encoding='utf-8') as f:
    json.dump(daten, f, indent=2, ensure_ascii=False)

print('Datei erfolgreich formatiert!')

Kompakte vs. Formatierte Ausgabe

import json

daten = {"name": "Max", "alter": 30, "stadt": "Berlin"}

# Kompakt (für API-Antworten)
kompakt = json.dumps(daten, separators=(',', ':'))
print(kompakt)  # {"name":"Max","alter":30,"stadt":"Berlin"}

# Formatiert (für Lesbarkeit)
formatiert = json.dumps(daten, indent=2)
print(formatiert)

Java

import com.google.gson.Gson;
import com.google.gson.GsonBuilder;
import com.google.gson.JsonParser;

public class JsonFormatter {
    public static void main(String[] args) {
        String unformatiert = "{"name":"Max","alter":30}";

        // Gson mit Pretty Printing
        Gson gson = new GsonBuilder()
            .setPrettyPrinting()
            .create();

        // JSON parsen und formatieren
        Object json = JsonParser.parseString(unformatiert);
        String formatiert = gson.toJson(json);

        System.out.println(formatiert);
    }
}

PHP

<?php

$daten = [
    "name" => "Max Mustermann",
    "alter" => 30,
    "adresse" => [
        "stadt" => "Berlin",
        "plz" => "10115"
    ]
];

// Mit Pretty Print (ab PHP 5.4)
$formatiert = json_encode($daten, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);
echo $formatiert;

// Datei formatieren
$unformatiert = file_get_contents('daten.json');
$daten = json_decode($unformatiert);
file_put_contents('daten.json', json_encode($daten, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE));
?>

C#

using System;
using System.Text.Json;

class Program
{
    static void Main()
    {
        var daten = new
        {
            Name = "Max Mustermann",
            Alter = 30,
            Adresse = new
            {
                Stadt = "Berlin",
                PLZ = "10115"
            }
        };

        // Mit Formatierung
        var optionen = new JsonSerializerOptions
        {
            WriteIndented = true,
            Encoder = System.Text.Encodings.Web.JavaScriptEncoder.UnsafeRelaxedJsonEscaping
        };

        string formatiert = JsonSerializer.Serialize(daten, optionen);
        Console.WriteLine(formatiert);
    }
}

Online-Tools zum Formatieren

1. Big JSON (Empfohlen!)

Unser eigenes Tool mit erweiterten Funktionen:

• Formatierung in Echtzeit
• Syntax-Highlighting
• Fehlerprüfung
• Pfad-Explorer

2. JSONLint

https://jsonlint.com/

Features:

• Validierung + Formatierung
• Fehlererkennug
• Einfache Benutzeroberfläche

3. JSON Formatter & Validator

https://jsonformatter.org/

Features:

• Mehrere Ansichtsmodi
• Baum-Ansicht
• Download-Optionen

CLI-Tools

jq (Empfohlen)

# Installation (Linux)
sudo apt-get install jq

# Installation (macOS)
brew install jq

# Installation (Windows mit Chocolatey)
choco install jq

# JSON-Datei formatieren
jq '.' unformatiert.json > formatiert.json

# Mit sortieren Schlüsseln
jq --sort-keys '.' input.json > output.json

# Kompakt ausgeben
jq -c '.' input.json

# Nur bestimmte Felder
jq '.name, .alter' daten.json

json_pp (Perl)

# Normalerweise vorinstalliert auf Unix-Systemen
cat unformatiert.json | json_pp > formatiert.json

# Direkt in Datei
json_pp < input.json > output.json

Python (Einzeiler)

# Formatieren
python -m json.tool unformatiert.json formatiert.json

# Mit sortieren Schlüsseln
python -m json.tool --sort-keys input.json output.json

# In Pipeline
cat daten.json | python -m json.tool

Node.js (Einzeiler)

# Formatieren
node -e "console.log(JSON.stringify(JSON.parse(require('fs').readFileSync('input.json')), null, 2))" > output.json

# Als npm-Script in package.json
{
  "scripts": {
    "format:json": "node -e "console.log(JSON.stringify(JSON.parse(require('fs').readFileSync('data.json')), null, 2))" > data.json"
  }
}

VS Code Integration

Eingebaute Formatierung

Einstellungen anpassen

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

Prettier Extension

// .prettierrc
{
  "tabWidth": 2,
  "useTabs": false,
  "printWidth": 100,
  "trailingComma": "none"
}

Formatierungsoptionen

Einrückung

// 2 Leerzeichen (Standard)
JSON.stringify(daten, null, 2)

// 4 Leerzeichen
JSON.stringify(daten, null, 4)

// Tabs
JSON.stringify(daten, null, '	')

Zeilen-Länge

// Prettier mit maximal 80 Zeichen pro Zeile
{
  "printWidth": 80
}

// Kompakter (längere Zeilen)
{
  "printWidth": 120
}

Schlüssel sortieren

import json

daten = {"z": 1, "a": 2, "m": 3}

# Sortierte Schlüssel
sortiert = json.dumps(daten, sort_keys=True, indent=2)
print(sortiert)

{
  "a": 2,
  "m": 3,
  "z": 1
}

Best Practices

1. Konsistente Einrückung

Verwenden Sie im gesamten Projekt die gleiche Einrückung:

// ✅ Gut - 2 Leerzeichen überall
{
  "projekt": {
    "name": "MeinProjekt",
    "version": "1.0.0"
  }
}

// ❌ Schlecht - Inkonsistent
{
    "projekt": {
      "name": "MeinProjekt",
        "version": "1.0.0"
    }
}

2. Automatische Formatierung

Richten Sie automatische Formatierung ein: