Konwerter JSON na CSV

Czym jest CSV i dlaczego konwertować z JSON?

// Input JSON
[
  { "id": 1, "name": "Alice", "role": "admin" },
  { "id": 2, "name": "Bob", "role": "editor" }
]

// Output CSV (RFC 4180 preset: comma + CRLF + no BOM)
id,name,role
1,Alice,admin
2,Bob,editor

// Same input with Stringify mode + nested data
[
  { "id": 1, "tags": ["a", "b"] }
]

// Becomes
id,tags
1,"[""a"",""b""]"

Kluczowe funkcje

Przykłady

[{"id":1,"name":"Alice Chen","email":"alice@example.com","role":"admin"},{"id":2,"name":"Bob Garcia","email":"bob@example.com","role":"editor"},{"id":3,"name":"Carol Singh","email":"carol@example.com","role":"viewer"},{"id":4,"name":"Dan Müller","email":"dan@example.com","role":"viewer"}]

[{"id":1001,"title":"Bug: login redirects to 404","state":"open","labels":["bug","priority:high"],"user":{"login":"alice"}},{"id":1002,"title":"Feature: dark mode toggle","state":"open","labels":["enhancement"],"user":{"login":"bob"}},{"id":1003,"title":"Docs: update README","state":"closed","labels":["docs","good-first-issue"],"user":{"login":"carol"}}]

[{"_id":{"$oid":"6634a1b2c3d4e5f600000001"},"email":"alice@example.com","metadata":{"signupDate":"2026-01-15T10:30:00Z","preferences":{"newsletter":true,"theme":"dark"}}},{"_id":{"$oid":"6634a1b2c3d4e5f600000002"},"email":"bob@example.com","metadata":{"signupDate":"2026-02-20T14:15:00Z","preferences":{"newsletter":false,"theme":"light"}}}]

{"event":"signup","user":"alice","ts":1715000000}
{"event":"login","user":"alice","ts":1715000060}
{"event":"checkout","user":"alice","ts":1715000300}

[{"id":"ord-001","customer":{"name":"Alice Chen","email":"alice@example.com","address":{"city":"Seattle","country":"US"}},"items":[{"sku":"SKU-100","qty":2},{"sku":"SKU-205","qty":1}]},{"id":"ord-002","customer":{"name":"Bob Garcia","email":"bob@example.com","address":{"city":"Madrid","country":"ES"}},"items":[{"sku":"SKU-100","qty":1}]}]

[{"name":"GET /users returns 200","status":"pass","duration":142},{"name":"POST /users creates record","status":"pass","duration":287},{"name":"GET /users/999 returns 404","status":"fail","duration":98,"error":"Expected 404, got 500"},{"name":"DELETE /users/1 returns 204","status":"pass","duration":156}]

Jak używać

1. 1

   Wklej dane JSON

   Wprowadź lub wklej dane JSON do pola wejściowego powyżej. Narzędzie akceptuje tablice obiektów, pojedyncze obiekty i NDJSON (JSON rozdzielany liniami) — wykrywane automatycznie. Możesz też kliknąć «Wczytaj przykład», aby wypróbować próbkę, np. odpowiedź REST API, eksport MongoDB lub dziennik zdarzeń NDJSON.

2. 2

   Wybierz preset (lub dostosuj Opcje)

   Kliknij RFC 4180 (domyślny), Excel (średnik EU + BOM), TSV (tabulacja) lub Pipe, aby ustawić format docelowy jednym kliknięciem. Otwórz panel Opcje dla precyzyjnej kontroli: Separator, Nagłówek, Cudzysłowy (Auto/Zawsze), Zakończenie linii (LF/CRLF), BOM i Zagnieżdżenia (Spłaszcz/Stringify).

3. 3

   Skopiuj lub pobierz CSV

   Kliknij Skopiuj, aby przenieść CSV do schowka, lub Pobierz, aby zapisać go jako plik .csv (.tsv przy presecie TSV) gotowy do Excela, Google Sheets, PostgreSQL COPY lub innego potoku danych. Do konwersji w obie strony kliknij Zamień kierunek, aby przekonwertować CSV z powrotem na JSON w miejscu.

Typowe problemy przy konwersji

42

[{"value": 42}]

[
  {"name": "GET /users", "status": "pass"},
  {"name": "GET /users/999", "status": "fail", "error": "500"}
]

// Output CSV (note empty cell in row 1)
name,status,error
GET /users,pass,
GET /users/999,fail,500

{"id": 9007199254740993}
// JavaScript reads as 9007199254740992 (precision lost)

{"id": "9007199254740993"}
// CSV preserves the string; Excel displays exactly

name,role
Smith, Jr.,admin
// Parser reads 3 columns: "Smith", " Jr.", "admin"

name,role
"Smith, Jr.",admin
// Parser reads 2 columns: "Smith, Jr.", "admin"

id,name,price
1,Alice,1,234.56
// Excel-EU mis-parses 1,234.56 as two columns

// Excel preset output: ; + CRLF + BOM
id;name;price
1;Alice;1234,56
// Excel-EU reads cleanly with comma decimal

[
  {"event": "signup"},
  {"event": "login"}
]
// Detected as a regular JSON array (works, but not NDJSON path)

{"event": "signup"}
{"event": "login"}
// Each line is one JSON value — auto-detected as NDJSON

Typowe zastosowania

Odpowiedź API do arkusza kalkulacyjnego

Wklej odpowiedź REST API (tablicę obiektów użytkowników/zamówień/zdarzeń) i otrzymaj przejrzysty tabelaryczny CSV gotowy do Excela, Google Sheets lub Numbers. Najczęstszy przypadek użycia — analitycy i PM-owie potrzebują danych w kształcie arkusza, inżynierowie wysyłają JSON z backendu.

Eksport MongoDB do hurtowni danych

Konwersja wyjścia JSON mongoexport (z opakowaniami $oid i zagnieżdżonymi dokumentami metadata) do CSV w celu wczytania do BigQuery, Snowflake lub Redshift. Tryb Stringify bezstratnie zachowuje zagnieżdżony kształt, gdy narzędzia w dalszej części potoku obsługują JSON-w-komórce.

Triage zgłoszeń GitHub

Pobierz zgłoszenia z /repos/{owner}/{repo}/issues, wklej JSON i otrzymaj płaski CSV z id, title, state, labels i user.login jako kolumnami. Wrzuć do Sheets, aby filtrować, sortować i przypisywać podczas planowania sprintu.

Przegląd dziennika zdarzeń NDJSON

Strumieniowe dzienniki z Cloud Logging, Datadog, Vector lub własnego potoku często docierają jako NDJSON (.ndjson, .jsonl). Wklej zawartość pliku bezpośrednio — wykrywaną automatycznie — i otrzymaj CSV do analizy ad hoc bez stawiania prawdziwego potoku ETL.

Ekstrakcja zamówień e-commerce

Konwersja zagnieżdżonego JSON zamówień (customer.address.city, tablica items) do płaskiego CSV dla finansów, realizacji lub przeglądu pod kątem oszustw. Tryb Spłaszcz produkuje jedną kolumnę na pole liścia, gotową do wczytania do Excela na potrzeby raportowania ad hoc.

Raport testów Postman/Newman

Eksporty testów Postman zawierają wiersze o mieszanym kształcie (niektóre z opcjonalnymi polami error). Wklej JSON, otrzymaj CSV ze wszystkimi kluczami zsumowanymi mnogościowo i wypełnionymi brakującymi komórkami — idealne do udostępniania raportów nieudanych testów osobom nietechnicznym w Sheets.

Szczegóły techniczne

Parser RFC 4180 oparty na maszynie stanów

Oba kierunki używają właściwego parsera opartego na skończonej maszynie stanów zgodnej z RFC 4180. Stany obejmują UnquotedField, QuotedField, AfterQuote, RowEnd i EndOfInput. Parser poprawnie obsługuje pola w cudzysłowach zawierające separator, osadzone CR/LF wewnątrz pól w cudzysłowach, ekranowane podwójne cudzysłowy (podwojone, jak "") i końcowe znaki nowej linii. Daje to wyjście, które bezstratnie przechodzi konwersję w obie strony przez moduł csv w Pythonie, PostgreSQL COPY, AWS S3 SELECT i każdy zgodny parser.

Algorytm wykrywania dużych liczb całkowitych

Przed przepuszczeniem JSON przez JSON.parse() (które cicho zaokrągliłoby duże liczby całkowite przez IEEE 754) narzędzie uruchamia skanowanie wyrażeniem regularnym po surowym tekście JSON, szukając literałów liczb całkowitych poza bezpiecznym zakresem (-2^53+1 do 2^53-1). Po wykryciu ścieżki dotkniętych pól są rejestrowane i pod wynikiem pojawia się baner ostrzegający o dużej liczbie całkowitej. Następnie zapisywacz CSV zachowuje te wartości jako ciągi znaków, zapewniając dokładną precyzję w Excelu, Google Sheets i każdym świadomym tekstu odbiorcy w dalszej części potoku.

BOM i kodowanie UTF-8 dla Excela

Całe wejście i wyjście jest w UTF-8. Opcjonalny BOM UTF-8 (0xEF 0xBB 0xBF) jest dodawany na początek wyjścia, gdy przełącznik BOM jest włączony lub gdy wybrano preset Excel. Excel na Windowsie używa BOM do wykrycia kodowania UTF-8 — bez niego Excel wraca do lokalnej konfiguracji systemu (Windows-1252 w USA, Windows-1251 w Rosji itd.) i kaleczy znaki spoza ASCII. Nowoczesne parsery (csv w Pythonie, Pandas, jq, PostgreSQL) zwykle nie potrzebują BOM i mogą uwzględnić go jako błąkający się znak na początku pierwszej komórki, więc pozostaw BOM wyłączony dla potoków innych niż Excel.

Dobre praktyki

Wybierz preset przed dostrajaniem opcji

Presety RFC 4180, Excel, TSV i Pipe ustawiają pięć opcji jednocześnie (separator, zakończenie linii, tryb cudzysłowów, BOM, nagłówek). Najpierw wybierz najbliższy preset, potem dostrajaj pojedyncze opcje tylko wtedy, gdy to konieczne — pozwala to uniknąć częstego błędu polegającego na zmianie jednej opcji i zapomnieniu o drugiej (np. przełączenie na średnik z pozostawieniem LF, co Excel-EU na Windowsie i tak źle parsuje).

Spłaszcz do analizy, Stringify do konwersji w obie strony

Używaj Spłaszcz, gdy celem jest Excel, Sheets lub jednorazowa analiza — klucze z kropkami dają najczystszy układ arkusza. Używaj Stringify, gdy potrzebujesz konwersji CSV → JSON → CSV bez utraty danych — tablice i obiekty przeżywają jako JSON wewnątrz jednej komórki. Zmiana w trakcie eksportu i ponowne uruchomienie jest tanie; wybierz na podstawie odbiorcy.

Używaj BOM tylko do Excela

BOM UTF-8 jest wymagany dla Excela na Windowsie do prawidłowego wykrycia kodowania. Każdy inny parser (csv w Pythonie, Pandas, jq, PostgreSQL COPY, BigQuery) albo ignoruje BOM, albo uwzględnia go jako błąkający się znak na początku pierwszej komórki, łamiąc nazwy kolumn. Pozostaw BOM wyłączony dla potoków, a włącz (lub użyj presetu Excel) tylko wtedy, gdy celem jest Excel.

Zachowuj duże ID jako ciągi znaków w JSON

Identyfikatory snowflake Twittera, ID Discorda, pola Long w MongoDB i resourceVersion K8s to 64-bitowe liczby całkowite przekraczające bezpieczny zakres JavaScript (2^53 - 1). Przechowuj je jako ciągi znaków JSON ("id": "9007199254740993") przed konwersją — CSV zachowa cyfry dokładnie, podczas gdy literał liczbowy zostałby cicho zaokrąglony przez JSON.parse().

Zwaliduj kształt wierszy przed wczytaniem

Wiersze o mieszanym kształcie (jedne obiekty z kluczami, których inne nie mają) są scalane z pustymi komórkami w wyniku, a narzędzie pokazuje ostrzeżenie Notatki o schemacie. Dla odbiorców o ścisłym schemacie (BigQuery, Redshift COPY) zwaliduj, czy wszystkie wiersze mają te same klucze przed eksportem — albo obsłuż brakujące wartości jawnie w potoku. Użyj naszego formatowania JSON, aby najpierw sprawdzić kształt wejścia.

Najczęściej zadawane pytania