Formatowanie i upiększanie JSONL

Czym jest formatowanie JSONL?

Formatowanie JSONL to proces czytelnego formatowania każdego obiektu JSON w pliku JSONL. Chociaż pliki JSONL zazwyczaj przechowują każdy obiekt w jednej kompaktowej linii, formatowanie rozwija je z odpowiednim wcięciem, dzięki czemu zagnieżdżone struktury są widoczne, a dane łatwiejsze do inspekcji.

Jest to szczególnie przydatne podczas debugowania odpowiedzi API, przeglądania plików logów lub przygotowywania danych do dokumentacji. Możesz wybrać między różnymi poziomami wcięcia (2 spacje, 4 spacje lub tabulacje) i opcjonalnie sortować klucze alfabetycznie dla spójnego porządku.

Format czytelny służy do przeglądania, a kompaktowy — do przechowywania

Jest jedna rzecz, o którą prędzej czy później potyka się każdy użytkownik formatera JSONL: rekord sformatowany z wcięciami zajmuje wiele linii, a rekordy wieloliniowe nie są już prawidłowym JSONL. Dlatego narzędzie traktuje formatowanie jako dwa jednokierunkowe widoki tych samych danych, a nie pojedynczy przełącznik:

# Jeden rekord, zapis kompaktowy (prawidłowy JSONL — dokładnie jedna linia):
{"event":"signup","user":{"id":831,"plan":"pro"},"ts":"2026-07-14T09:31:22Z"}

# Ten sam rekord, sformatowany z wcięciami (do czytania — NIE jest już prawidłowym JSONL):
{
  "event": "signup",
  "user": {
    "id": 831,
    "plan": "pro"
  },
  "ts": "2026-07-14T09:31:22Z"
}

Trybu czytelnego używaj do inspekcji i debugowania rekordów, a przed zapisaniem wróć do trybu kompaktowego (zminimalizowanego) — kompaktowe wyjście gwarantuje niezmiennik jednego rekordu na linię, od którego zależy każdy odbiorca JSONL.

Jak sformatować JSONL

Formatowanie JSONL pobiera każdą linię pliku JSONL, parsuje ją jako obiekt JSON i ponownie serializuje z wybranym stylem wcięcia. Dzięki temu dane są znacznie łatwiejsze do odczytania i debugowania.

Nasz formatter działa w całości w Twojej przeglądarce. Żadne dane nie są przesyłane na żaden serwer. Wystarczy wkleić tekst JSONL lub przeciągnąć i upuścić plik, wybrać opcje formatowania, a upiększone wyjście pojawi się natychmiast.

Nieprawidłowe linie są zachowywane w oryginalnej postaci i raportowane osobno, więc żadne dane nie są tracone. Możesz również użyć trybu kompaktowego do minifikacji każdej linii w celu zmniejszenia rozmiaru pliku.

Co faktycznie zmienia każda opcja

Wcięcia: 2 / 4 / tabulator

To wyłącznie preferencja sposobu wyświetlania, z jedną rzeczywistą konsekwencją: rozmiarem pliku. Dla typowego zagnieżdżonego rekordu wcięcie czterema spacjami daje około 10% więcej bajtów niż dwiema; tabulatory zajmują najmniej miejsca z tych trzech opcji. Żadna z nich nie wpływa na sparsowane dane.

Tryb kompaktowy (minimalizacja)

Usuwa wszystkie białe znaki między tokenami i ponownie składa każdy rekord w pojedynczą linię — jest odwrotnością formatowania z wcięciami i jedynym trybem, którego wynik ma zagwarantowaną poprawność jako JSONL. Typowa oszczędność po zminimalizowaniu wcześniej sformatowanych danych wynosi 20–40%.

Sortowanie kluczy

Porządkuje klucze obiektów alfabetycznie i rekurencyjnie. Semantyka JSON pozostaje bez zmian (kolejność kluczy nie ma znaczenia według RFC 8259), ale posortowane wyjście zapewnia stabilne porównania — dwa eksporty tych samych danych można porównać w git linia po linii.

Częste błędy i rozwiązania

Najczęściej zadawane pytania