Upiększacz JSON

Formatowanie JSON z konfigurowalnym wcięciem dla lepszej czytelności

Wypróbuj przykład

Wejście

Sformatowane wyjście

Działa lokalnie · Bezpieczne do wklejania sekretów
Sformatowany JSON pojawi się tutaj…

Co to jest JSON Pretty Print?

JSON pretty print przekształca kompaktowy, trudny do odczytania JSON w starannie wcięty, wieloliniowy format. O ile maszyny przetwarzają jednoliniowy JSON bez problemu, ludzie potrzebują struktury — hierarchii wizualnej, wyrównanych nawiasów i spójnych wcięć — by szybko rozumieć złożone dane.

Before · json
After · json
{"user":"alice","role":"admin","permissions":["read","write"],"active":true,"lastLogin":1717200000}
{
  "user": "alice",
  "role": "admin",
  "permissions": [
    "read",
    "write"
  ],
  "active": true,
  "lastLogin": 1717200000
}

Dlaczego warto formatować JSON?

Surowy JSON z API, baz danych i plików logów jest często minifikowany, by oszczędzać przepustowość. Pretty print przywraca czytelną strukturę potrzebną do debugowania, przeglądania i rozumienia danych bez wysiłku.

🔍
Szybsze debugowanie
Znajdź brakujące pola, błędne wartości i błędy struktury w sekundy, zamiast analizować ścianę tekstu znak po znaku.
👥
Czystsze przeglądy kodu
Przeglądanie zmian w plikach konfiguracyjnych JSON w pull requestach jest o wiele łatwiejsze z właściwymi wcięciami — recenzenci mogą skupić się na tym, co się zmieniło.
🔌
Inspekcja API
Eksplorując nowe API, sformatowane odpowiedzi pozwalają zrozumieć model danych i strukturę zagnieżdżenia na pierwszy rzut oka.
📝
Dokumentacja i udostępnianie
Sformatowany JSON jest gotowy do wklejenia w dokumenty, wiki, zgłoszenia i Slack bez konieczności ręcznej analizy przez kogokolwiek.

Wybór wcięcia

Zarówno 2, jak i 4 spacje są szeroko stosowane. Właściwy wybór zazwyczaj zależy od przewodnika stylu zespołu lub osobistych preferencji.

2 spacje
Najpopularniejszy wybór w społecznościach JavaScript i JSON. Pliki pozostają kompaktowe, a jednocześnie czytelne. Używany przez npm, ESLint i większość przewodników stylu JS.
4 spacje
Powszechny w projektach Python, Java i C#. Zapewnia więcej przestrzeni wizualnej i jest często preferowany przy głęboko zagnieżdżonych strukturach.

Typowe przypadki użycia

Debugowanie odpowiedzi API
Wklej surową odpowiedź API i natychmiast zobaczysz pełną strukturę danych, zagnieżdżone obiekty i zawartość tablic w czytelnym układzie.
Odczytywanie plików konfiguracyjnych
Konfiguracja przechowywana w zminifikowanym JSON staje się banalna do odczytu i edycji po sformatowaniu — koniec z szukaniem konkretnego klucza.
Analiza logów
Logi strukturyzowane często zawierają payloady JSON. Formatowanie pojedynczych wpisów znacznie przyspiesza analizę przyczyn problemów.
Dokumentacja dla deweloperów
Przejrzyste, wcięte przykłady JSON w dokumentacji API pozwalają deweloperom natychmiast zrozumieć strukturę żądań i odpowiedzi.
Eksploracja danych
Pracując z nieznanym zbiorem danych, pretty print ujawnia pełny schemat — pola, typy i zagnieżdżenie — bez konieczności czytania dokumentacji.
Testowanie i QA
Porównywanie oczekiwanego i rzeczywistego JSON w niepomyślnych testach jest o wiele łatwiejsze z spójnym wcięciem i strukturą linia po linii.

Pretty Print w terminalu

Nie zawsze potrzebne jest narzędzie przeglądarkowe. Te polecenia formatują JSON bezpośrednio w terminalu bez dodatkowych instalacji.

Python
echo '{"a":1}' | python3 -m json.tool
Node.js
node -e "console.log(JSON.stringify(JSON.parse(require('fs').readFileSync('/dev/stdin','utf8')),null,2))"
CLI (jq)
cat data.json | jq .
curl + jq
curl -s https://api.example.com/data | jq .

Najczęstsze pytania

What is JSON pretty printing?
JSON pretty printing (also called JSON formatting or JSON beautifying) converts compact, minified JSON into a human-readable layout with consistent indentation and line breaks. It makes nested structures, arrays, and key-value pairs easy to scan and debug.
Czy pretty print zmienia dane?
Nie. Dodawane są wyłącznie białe znaki — żadne dane, klucze, wartości ani kolejność nie są modyfikowane. Sformatowany plik JSON jest semantycznie identyczny z oryginałem.
Co jest lepsze: 2 czy 4 spacje?
Żadne nie jest obiektywnie lepsze. 2 spacje są bardziej kompaktowe i są domyślne w wielu narzędziach JavaScript. 4 spacje zapewniają więcej separacji wizualnej. Używaj tego, co wskazuje przewodnik stylu twojego zespołu.
Czy mogę sformatować nieprawidłowy JSON?
Nie — dane wejściowe muszą być prawidłowym JSON. Jeśli plik zawiera końcowe przecinki, apostrofy lub komentarze (JSONC/JSON5), najpierw przekonwertuj go do standardowego JSON.
Jak sformatować JSON w DevTools przeglądarki?
W Chrome/Firefox DevTools kliknij przycisk {} na dole panelu odpowiedzi sieciowej, by automatycznie sformatować. Możesz też uruchomić JSON.stringify(obj, null, 2) w konsoli, by sformatować dowolny obiekt JavaScript.