Konwerter CSV na JSON

Konwerter CSV na JSON

Konwerter CSV na JSON zamienia tekst z pliku .csv, Excela lub Arkuszy Google na JSON (ang. CSV to JSON): domyślnie na tablicę obiektów, w której każdy wiersz to osobny obiekt, a klucze pochodzą z nagłówka. Liczby, wartości true/false i puste pola dostają właściwe typy JSON, więc wynik nadaje się od razu do API, JavaScriptu albo bazy dokumentowej.

Obsługiwane opcje

Wynik można skopiować albo pobrać jako plik dane.json (dla JSON Lines: dane.jsonl). Pod wynikiem jest tabela kolumn z wykrytym typem, liczbą pustych pól i przykładową wartością, a kafelki pokazują liczbę wierszy, kolumn, wybrany separator i rozmiar CSV oraz JSON w bajtach. Limit wejścia to 2 MB i 20 000 wierszy, dane muszą być w UTF-8.

Przykład

id,name,active
1,Anna,true
2,Jan,false

Daje (przy wyłączonym formatowaniu):

[{"id":1,"name":"Anna","active":true},{"id":2,"name":"Jan","active":false}]

Te same dane w pięciu kształtach JSON

Jak działa konwerter CSV na JSON

Najpierw narzędzie ustala separator. W trybie „Wykryj automatycznie” sprawdza pierwszą linię i wybiera znak (przecinek, średnik, tabulator lub |), który dzieli ją na najwięcej kolumn; gdy żaden nie daje więcej niż jednej kolumny, zostaje przecinek. Znak BOM, który Excel dopisuje na początku pliku „CSV UTF-8”, jest usuwany, więc nie psuje nazwy pierwszej kolumny.

Potem tekst jest dzielony na rekordy zgodnie z RFC 4180: wartość w cudzysłowie może zawierać separator i znak nowej linii, a cudzysłów wewnątrz wartości zapisuje się podwójnie. Puste linie są pomijane. Jeśli któryś wiersz ma inną liczbę pól niż pierwszy, konwersja się zatrzymuje, a komunikat podaje numery linii (do pięciu) i liczbę pól w każdej z nich. Niezamknięty cudzysłów jest zgłaszany osobno, z numerem linii, w której zaczyna się wadliwy rekord.

Gdy nagłówek jest włączony, pierwszy wiersz nie trafia do danych, tylko daje nazwy kluczy. Pusta komórka nagłówka dostaje nazwę column_N, a powtórzona nazwa końcówkę _2, _3, więc żadna kolumna nie nadpisze innej. Polskie litery i ukośniki zostają w JSON w czytelnej postaci, bez sekwencji ucieczki.

Wykrywanie typów działa dla każdej komórki osobno. Liczba całkowita (do 15 cyfr, bez zera na początku) staje się liczbą JSON, ułamek z kropką albo przecinkiem, np. 39,90, liczbą z kropką (39.9), a true i false w dowolnej wielkości liter typem logicznym. Puste pole oraz zapisy null, nil i n/a dają null. Wszystko inne, w tym 007, 1 000, daty i słowa „tak” czy „nie”, zostaje tekstem.

Przykład krok po kroku

1. Wklejamy CSV z nagłówkiem id,name,active i dwoma wierszami danych: 1,Anna,true oraz 2,Jan,false.
2. Automatyczne wykrywanie sprawdza pierwszą linię: przecinek dzieli ją na 3 pola, a średnik, tabulator i pionowa kreska na 1, więc wybrany zostaje przecinek.
3. Podział daje 3 rekordy po 3 pola. Liczba pól jest wszędzie taka sama, więc nie pojawia się błąd niespójnych kolumn.
4. Nagłówek jest włączony, więc id, name i active stają się kluczami. Gdyby był wyłączony, klucze nazywałyby się column_1, column_2 i column_3, a wiersz id,name,active trafiłby do wyniku jako pierwszy obiekt z samymi tekstami.
5. Wykrywanie typów rozpoznaje 1 i 2 jako liczby całkowite, true i false jako wartości logiczne, a Anna i Jan jako tekst. Tabela kolumn pod wynikiem pokazuje: id – liczba całkowita, name – tekst, active – logiczny (true/false), bez pustych pól.
6. Wynikiem jest tablica z 2 obiektami, czyli tyle, ile wierszy danych. Pierwszy obiekt ma id równe 1, name równe Anna i active równe true, drugi id 2, name Jan i active false.

Tabela referencyjna zachowań

Praktyczne wskazówki użycia

• Sprawdź kafelek „Separator” po konwersji. Automatyczne wykrywanie patrzy tylko na pierwszą linię, więc jeśli nagłówek ma jedną kolumnę albo zawiera nietypowe znaki, wybierz separator ręcznie. Zły separator zwykle kończy się komunikatem o niespójnej liczbie kolumn.
• Nie mieszaj nagłówka z danymi. Włącz opcję nagłówka tylko wtedy, gdy pierwszy wiersz naprawdę zawiera nazwy kolumn. W razie wątpliwości porównaj liczbę wierszy wejściowych z liczbą wierszy danych w wyniku.
• Identyfikatory, numery telefonów i NIP-y bez zera na początku zostaną rozpoznane jako liczby. Jeśli mają zostać tekstem, odznacz „Wykrywaj typy” – wtedy każda wartość trafi do JSON w cudzysłowie, a puste pola jako pusty tekst.
• Puste komórki przy wykrywaniu typów stają się null. Jeśli puste pole ma znaczyć zero albo pusty tekst, uzupełnij je przed konwersją, bo null i "" to w JSON dwie różne wartości.
• Do importu dużych zbiorów do baz i kolejek wybierz JSON Lines: każdą linię można przetworzyć osobno, bez wczytywania całej tablicy do pamięci.

Ograniczenia i źródła błędów

• Brak walidacji schematu. Narzędzie nie wie, jakie typy powinny być w kolumnach, i wnioskuje je z zapisu. Numer 600123456 stanie się liczbą, a data 2026-10-20 zostanie tekstem (w tabeli kolumn oznaczonym jako data).
• Zależność od poprawnego CSV. Wiersz z nadmiarowym separatorem albo brakującym cudzysłowem zatrzymuje konwersję. Komunikat wskazuje linię, ale poprawić dane trzeba samodzielnie.
• Zagnieżdżenia tylko z kropek. Nagłówki typu user.name budują obiekty na dowolną głębokość, ale konwerter nie zrobi z kilku wierszy tablicy (relacji jeden do wielu). Taką strukturę trzeba złożyć już w kodzie.
• Utrata formatowania. JSON nie przechowuje szerokości kolumn, kolorów, formuł ani formatów komórek. Liczy się wartość, a nie wygląd, więc nie ma znaczenia, czy liczba była zapisana jako waluta, procent czy zwykła wartość.
• Kodowanie i rozmiar. Plik w Windows-1250 zostanie odrzucony: zapisz go jako „CSV UTF-8”. Powyżej 2 MB lub 20 000 wierszy podziel dane na części.