Konwerter CSV na JSON

Czym jest JSON i dlaczego konwertować z CSV?

// Input CSV (comma + LF, header on, infer types on)
id,name,active,score
1,Alice,true,98.5
2,Bob,false,87
3,Carol,true,

// Output JSON
[
  { "id": 1, "name": "Alice", "active": true, "score": 98.5 },
  { "id": 2, "name": "Bob", "active": false, "score": 87 },
  { "id": 3, "name": "Carol", "active": true, "score": null }
]

// Same input with Header off (no first-row keys)
1,Alice,true,98.5
2,Bob,false,87

// Becomes
[
  { "col1": 1, "col2": "Alice", "col3": true, "col4": 98.5 },
  { "col1": 2, "col2": "Bob", "col3": false, "col4": 87 }
]

Kluczowe funkcje

Przykłady

id,name,email,role
1,Alice,alice@example.com,admin
2,Bob,bob@example.com,editor
3,Carol,carol@example.com,viewer
4,Dan,dan@example.com,viewer

ts	event	user	duration
2026-05-09T10:00:00Z	signup	alice	142
2026-05-09T10:01:00Z	login	alice	87
2026-05-09T10:02:00Z	checkout	alice	312
2026-05-09T10:03:00Z	logout	alice	44

id;name;price
1;Alice;1234,56
2;Bob;9876,54
3;Carol;42,00

name,role,note
"Smith, Jr.",admin,"He said ""hi"""
"Doe, Jane",editor,"Two
lines"

id,event,user
9007199254740993,signup,alice
9007199254740994,login,bob
9007199254740995,checkout,carol

1,Alice,admin
2,Bob,editor
3,Carol,viewer
4,Dan,viewer

Jak używać

1. 1

   Wklej swój CSV

   Wprowadź lub wklej CSV do pola wejściowego powyżej. Narzędzie akceptuje dane rozdzielane przecinkiem, średnikiem, tabulacją i pionową kreską. Możesz też kliknąć «Wczytaj przykład», aby wypróbować próbkę, np. eksport z arkusza kalkulacyjnego, dziennik TSV lub CSV Excel-EU ze średnikami.

2. 2

   Wybierz separator (lub Tabulacja)

   Kliknij `,` (domyślny), `;` (Excel-EU średnik), `\t` (TSV) lub `|` (Pipe), aby przełączyć separator jednym kliknięciem. Otwórz panel Opcje dla precyzyjnej kontroli: Nagłówek wł./wył. i Wnioskuj typy wł./wył. Wyłączony Nagłówek nadaje kolumnom automatyczne nazwy col1, col2, col3.

3. 3

   Skopiuj lub pobierz JSON

   Kliknij Skopiuj, aby przenieść JSON do schowka, lub Pobierz, aby zapisać go jako plik .json gotowy do Twojego kodu, API lub potoku. Do konwersji w obie strony kliknij Zamień kierunek, aby przekonwertować JSON z powrotem na CSV w miejscu.

Typowe problemy przy konwersji

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

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

// Wrong delimiter (default comma) on Excel-EU file
id;name;price
1;Alice;1234,56
// Each row becomes one column: { col1: "1;Alice;1234,56" }

// Correct: pick `;` Delimiter chip
id;name;price
1;Alice;1234,56
// Output: { id: 1, name: "Alice", price: "1234,56" }

// Without big-int detection
{"id": 9007199254740993}
// JavaScript reads as 9007199254740992 (precision lost)

// With Infer types on, big integers stay as strings
{"id": "9007199254740993"}
// Use BigInt(value) in code to preserve precision

id, name, email
1, Alice, alice@example.com
// Output keys: "id", " name", " email" (with leading spaces)

id,name,email
1,Alice,alice@example.com
// Output keys: "id", "name", "email" (clean)

name,role,note
Alice,admin
Bob,editor,first day
// Row 1 is short by one cell

// Output (note empty/null cell in row 1)
[
  { "name": "Alice", "role": "admin", "note": null },
  { "name": "Bob", "role": "editor", "note": "first day" }
]

// Expecting a Date object in the output
ts,event
2026-05-09T10:00:00Z,signup
// Output ts is the string "2026-05-09T10:00:00Z", NOT a Date

// Correct: parse at the point of use in your code
const rows = JSON.parse(output);
const when = new Date(rows[0].ts);
// when is now a Date object

Typowe zastosowania

Eksport z arkusza kalkulacyjnego do importu API

Wklej CSV wyeksportowany z Excela, Google Sheets lub Numbers i otrzymaj tablicę obiektów JSON gotową do POST do REST API, mutacji GraphQL lub punktu końcowego importu masowego. Najczęstszy przypadek użycia — analitycy produkują dane z arkusza, inżynierowie potrzebują typowanego JSON, by zasilić backend.

Eksport z Excela do narzędzi

Konwersja eksportów CSV z Excela (w tym plików Excel-EU rozdzielanych średnikiem z chipem `;`) na JSON do przetwarzania narzędziami JavaScript, skryptami jq lub dowolnym systemem czytającym JSON. Parser poprawnie obsługuje usuwanie BOM i zakończenia linii CRLF, dzięki czemu eksporty z Excela nie psują się w pierwszym wierszu.

Dziennik TSV do analityki

Dzienniki rozdzielane tabulacją z eksportów BigQuery, wyładunków Snowflake, potoków Vector lub narzędzi uniksowych (cut, awk) często docierają jako .tsv. Wybierz chip Separator Tabulacja i otrzymaj typowaną tablicę JSON gotową do analizy ad hoc, wczytania do dashboardu lub transformacji w etapie potoku.

Zrzut CSV z bazy danych do ETL

Konwersja wyjścia PostgreSQL COPY TO CSV, MySQL SELECT INTO OUTFILE lub dowolnego zrzutu CSV z bazy danych na JSON do wczytania do magazynu NoSQL, zasilenia potoku ETL w JavaScript lub wysłania do BigQuery jako JSON rozdzielany liniami. Wykrywanie dużych liczb całkowitych zachowuje numeryczne ID przekraczające bezpieczny zakres JavaScript.

Konsumpcja wyników testów Postman/Newman z CSV

Uruchomienia testów Postman eksportują raporty CSV pass/fail dla każdego żądania. Konwersja na JSON do programowej konsumpcji — zasilenie dashboardu statusu, potoku alertów lub agregatora wyników testów. Wiersze o mieszanym kształcie (testy zakończone niepowodzeniem mają dodatkową kolumnę error) są obsługiwane wypełnieniami pusty/null.

Mały CSV do szybkiej konfiguracji JSON

Masz mały CSV stałych — kody walut, nazwy krajów, SKU produktów — i potrzebujesz tablicy JSON do pliku konfiguracyjnego lub stałej w JavaScript? Wklej, skopiuj, wklej. Z włączonym Wnioskuj typy liczby i wartości logiczne są typowane poprawnie; z włączonym Nagłówek otrzymujesz tablicę obiektów z nazwanymi polami gotową do wrzucenia do pliku .json.

Szczegóły techniczne

Wewnętrzne działanie parsera RFC 4180 opartego na maszynie stanów

Parser to właściwa implementacja skończonej maszyny stanów zgodna 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. Maszyna stanów jest świadoma separatora, więc przełączanie z `,` na `;` lub `\t` nie zmienia semantyki cytowania — tylko separator pól.

Algorytm wnioskowania typów

Z włączonym Wnioskuj typy każda komórka przechodzi przez uporządkowany potok wykrywania. Po pierwsze, pusta komórka staje się null w JSON. Po drugie, literały true i false stają się wartościami logicznymi JSON. Po trzecie, ciągi z wiodącym zerem (^0[0-9]+$) są zachowywane jako ciągi, aby zachować semantykę identyfikatora — konwersja na liczby cicho usunęłaby wiodące zera. Po czwarte, literały liczb całkowitych są testowane względem granicy bezpiecznej liczby całkowitej (-2^53+1 do 2^53-1); wartości spoza tego zakresu są zachowywane jako ciągi, aby uniknąć utraty precyzji IEEE 754. Po piąte, ciągi dat ISO 8601 są wykrywane wyrażeniem regularnym i celowo zachowywane jako ciągi — JSON nie ma natywnego typu daty. Wszystko, co przejdzie wszystkie pięć osłon, jest konwertowane przez Number() (numeryczne) lub zachowywane jako ciąg (wszystko inne).

Usuwanie BOM i obsługa kodowania

Wszystkie dane wejściowe są traktowane jako UTF-8. Opcjonalny BOM UTF-8 (0xEF 0xBB 0xBF) jest cicho usuwany z pierwszej komórki pierwszego wiersza, gdy jest obecny — zapobiega to dołączaniu bajtów BOM jako błąkającego się znaku na początku nazwy pierwszej kolumny (Excel na Windowsie powszechnie emituje BOM, łamiąc naiwne parsery). Inne kodowania (Windows-1252, ISO-8859-1) nie są wykrywane automatycznie; przeglądarkowe File API już zdekodowałoby bajty jako UTF-8, zanim tekst dotrze do tego narzędzia. Jeśli masz wejście inne niż UTF-8, najpierw przekonwertuj je za pomocą iconv lub opcji eksportu kodowania w swoim edytorze, zanim wkleisz.

Dobre praktyki

Wybierz separator jawnie dla danych nieprzecinkowych

Nie polegaj na automatycznym wykrywaniu. Jeśli Twój CSV używa średników (Excel-EU), tabulacji (TSV z BigQuery, Snowflake lub narzędzi uniksowych) lub pionowych kresek (pola z wieloma przecinkami), kliknij pasujący chip Separator przed wklejeniem. Parser jest świadomy separatora: przełączenie chipa natychmiast ponownie parsuje wejście. Pozwala to uniknąć najczęstszego trybu awarii konwersji CSV-na-JSON, gdzie każdy wiersz zwija się do jednej komórki, ponieważ parser użył złego separatora.

Pozostaw Wnioskuj typy włączone dla typowanego JSON

Z włączonym Wnioskuj typy (domyślnie) otrzymujesz typowany JSON: liczby jako liczby, wartości logiczne jako wartości logiczne, null tam, gdzie pojawiają się puste komórki. Tego chce większość odbiorców — API, frontendy, kod JavaScript. Wyłącz Wnioskuj typy tylko wtedy, gdy konkretnie potrzebujesz każdej komórki jako ciągu (odbiorcy o ścisłej kontroli typów w dalszej części potoku, potoki walidacji porównujące dokładne bajty źródłowe). Potok wykrywania ma osłony dla ciągów z wiodącym zerem, dużych liczb całkowitych i dat ISO, więc identyfikatory i daty pozostają bezpieczne nawet z włączonym wnioskowaniem.

Cytuj ID jako ciągi w źródłowym CSV

Jeśli Twój CSV jest generowany przez bazę danych lub potok, który kontrolujesz, emituj duże numeryczne ID (snowflake Twittera, ID Discorda, resourceVersion K8s) jako cytowane ciągi CSV ("9007199254740993"), aby przeszły przez Wnioskowanie typów czysto. Parser i tak zachowa je jako ciągi (wykrywanie big-int wyłapuje wartości powyżej 2^53 - 1), ale jawne cytowanie jest najbardziej solidnym kontraktem źródłowym i unika niejednoznaczności co do precyzji.

Wiersz nagłówka powinien być pierwszą linią

Włączony Nagłówek (domyślnie) automatycznie wykrywa pierwszy wiersz jako nazwy kolumn. Jeśli Twój CSV ma komentarze, puste linie lub metadane przed nagłówkiem, usuń je przed wklejeniem — parser nie pomija wiodących linii niedanych. Dla CSV bez nagłówka (surowe eksporty, zrzuty generowane maszynowo) wyłącz Nagłówek, a kolumny otrzymają automatyczne nazwy col1, col2, col3 w kolejności. Nie próbuj sfałszować nagłówka, dodając go na początku pliku bez nagłówka; albo wyłącz Nagłówek, albo popraw źródło.

Użyj trybu Stringify dla konwersji w obie strony CSV → JSON → CSV

Jeśli planujesz konwersję danych w obie strony (CSV → JSON → CSV), odwrotny kierunek (JSON → CSV) wymaga trybu Stringify, aby zagnieżdżone tablice lub obiekty przeżyły bezstratnie. Tryb Spłaszcz w odwrotnym kierunku emituje klucze z kropkami (customer.address.city), których nie da się idealnie odtworzyć przez parser CSV. Zobacz nasz Konwerter JSON na CSV jako pełne odniesienie odwrotnego kierunku i notatki dotyczące testowania konwersji w obie strony.

Najczęściej zadawane pytania