Zostań w temacie i uporządkuj dane dalej
Ten konwerter ma prostą rolę: zamienia listę na CSV lub CSV na listę i wykonuje podstawowe czyszczenie. Do bardziej wyspecjalizowanych operacji użyj osobnych narzędzi.
Co oznacza „lista na CSV”?
Lista w tym narzędziu to prosty tekst, w którym każda pozycja znajduje się w osobnym wierszu:
gruszka
śliwka
Po wybraniu układu „jedna linia CSV” te trzy pozycje mogą stać się:
Możesz również utworzyć CSV z jedną wartością w każdym wierszu. To przydaje się, gdy plik ma reprezentować jedną kolumnę danych.
Konwersja nie zmienia znaczenia wartości – zmienia sposób ich rozdzielenia i zapisania.
CSV na listę – jak działa odwrotna konwersja?
Parser rozdziela dane na wiersze i pola zgodnie z wybranym separatorem. Jeżeli CSV ma kilka kolumn, możesz:
- spłaszczyć wszystkie komórki do jednej listy,
- pobrać tylko pierwszą kolumnę,
- pominąć pierwszy wiersz, jeśli jest nagłówkiem.
Dzięki temu prosty eksport z arkusza można szybko przerobić np. na listę identyfikatorów, adresów e-mail, nazw produktów albo słów kluczowych.
Przecinek, średnik, TAB czy pionowa kreska – jaki separator wybrać?
| Separator | Przykład | Kiedy jest wygodny? |
|---|---|---|
| Przecinek `,` | a,b,c | Klasyczny zapis CSV i wiele systemów eksportu. |
| Średnik `;` | a;b;c | Praktyczny, gdy przecinek występuje w liczbach lub treści. |
| TAB | a ⇥ b ⇥ c | Dane tabelaryczne kopiowane między arkuszami i edytorami. |
| `|` | a|b|c | Niestandardowe eksporty i dane, w których przecinek/średnik często występują w polach. |
Nie zakładaj, że każdy program oczekuje tego samego separatora. Przy imporcie zawsze sprawdź ustawienia programu docelowego.
Cudzysłowy w CSV – kiedy są potrzebne?
Podwójne cudzysłowy chronią pole, gdy jego treść sama zawiera separator, znak końca linii albo cudzysłów. Przykład dla przecinka:
Pole `Warszawa, Polska` musi być potraktowane jako jedna wartość mimo przecinka w środku. Cudzysłów wewnątrz cytowanego pola zapisuje się jako dwa cudzysłowy.
Opcja Auto dodaje cudzysłowy tylko tam, gdzie są potrzebne. Opcja „Nigdy” może tworzyć niejednoznaczny tekst, jeśli dane zawierają separator lub nowe linie – kalkulator pokazuje wtedy ostrzeżenie.
Ciekawostka
Nazwa CSV oznacza „comma-separated values”, ale w praktyce pliki tabelaryczne często używają też średnika, tabulatora albo innych separatorów. Dlatego samo rozszerzenie `.csv` nie gwarantuje, że przecinek będzie separatorem w konkretnym pliku.
Najpewniejsza metoda to sprawdzenie pierwszych kilku wierszy pliku albo ustawień eksportu/importu.
Jedna linia CSV czy jedna kolumna?
Dla listy:
B
C
możesz otrzymać jeden rekord z trzema polami:
albo trzy rekordy z jednym polem:
B
C
Oba wyniki mogą być poprawnym tekstem tabelarycznym, ale mają inną strukturę. Dlatego kalkulator ma osobny wybór układu dla kierunku lista → CSV.
Usuwanie duplikatów – co dokładnie robi opcja w tym konwerterze?
Po zaznaczeniu „Usuń duplikaty” kalkulator zachowuje pierwsze wystąpienie danej pozycji i pomija kolejne. Domyślnie porównanie nie rozróżnia wielkości liter, więc `ABC` i `abc` są traktowane jako ten sam element.
Jeśli włączysz opcję rozróżniania wielkości liter, będą to dwie różne wartości. Do bardziej rozbudowanej deduplikacji użyj osobnego narzędzia do usuwania duplikatów.
To rozdzielenie zapobiega temu, aby konwerter CSV stał się drugim pełnym narzędziem do czyszczenia tekstu.
Trimowanie i puste wiersze – małe różnice, duże skutki
Dla człowieka `produkt` i `produkt ` mogą wyglądać identycznie, ale dla programu drugi tekst zawiera dodatkową spację. Opcja trimowania usuwa białe znaki z początku i końca każdego elementu.
Usuwanie pustych pozycji działa po trimowaniu. Oznacza to, że linia zawierająca wyłącznie kilka spacji może zostać uznana za pustą.
Jeżeli spacje na początku albo końcu są częścią danych i muszą zostać zachowane, wyłącz trimowanie i korzystaj z cudzysłowów przy tworzeniu CSV.
Przykład: lista adresów e-mail do jednej linii CSV
Masz dane:
jan@example.com
anna@example.com
Po włączeniu usuwania duplikatów i wybraniu przecinka otrzymasz:
Jeżeli program docelowy wymaga średników, wystarczy zmienić separator – same wartości nie muszą być wpisywane ponownie.
Przykład: CSV z nagłówkiem do pierwszej kolumny
Dane wejściowe:
101;Produkt A;19,99
102;Produkt B;29,99
Jeśli wybierzesz „Tylko pierwsza kolumna” i „Pomiń pierwszy wiersz CSV”, lista będzie wyglądać tak:
102
To wygodny sposób na wyciągnięcie identyfikatorów z prostego eksportu tabelarycznego.
Dla uczniów i studentów: rekord, pole, separator i znak końca linii
CSV można zrozumieć jak prostą tabelę zapisaną jako tekst. Każdy wiersz reprezentuje rekord, a pola rekordu są oddzielone separatorem.
Rekord
Jeden wiersz danych, np. informacje o jednym produkcie.
Pole
Jedna wartość w rekordzie, np. nazwa albo cena.
Separator
Znak rozdzielający pola, np. przecinek, średnik lub TAB.
Jeżeli pole zawiera separator, trzeba je odpowiednio zacytować. To dobry przykład, dlaczego parsowanie danych tekstowych jest czymś więcej niż zwykłe `split(',')`.
Dlaczego proste dzielenie tekstu po przecinku bywa błędne?
Weźmy rekord:
Proste rozdzielenie każdego przecinka utworzyłoby cztery fragmenty zamiast trzech pól. Poprawny parser musi wiedzieć, że przecinek wewnątrz `"Kowalski, Jan"` należy do treści pola.
Właśnie dlatego JS w tej wersji analizuje stan cudzysłowu i obsługuje również podwojone cudzysłowy oraz nowe linie wewnątrz cytowanego pola.
Najczęstsze błędy przy konwersji listy i CSV
- wybranie przecinka jako separatora, mimo że wartości zawierają przecinki i nie są cytowane,
- wyłączenie cudzysłowów przy wartościach zawierających separator lub znak końca linii,
- potraktowanie pierwszego wiersza z nagłówkami jak zwykłych danych,
- pomieszanie jednej linii CSV z jedną kolumną CSV,
- usunięcie znaczących spacji przez automatyczne trimowanie,
- nieuwzględnienie wielkości liter podczas usuwania duplikatów,
- otwarcie pliku w programie z innym ustawieniem separatora niż użyte przy eksporcie,
- próba obsługi złożonych danych hierarchicznych w CSV zamiast JSON lub YAML.
CSV, JSON czy YAML – kiedy lista przestaje wystarczać?
CSV dobrze sprawdza się przy prostych tabelach. Jeśli dane mają zagnieżdżone obiekty, listy wewnątrz rekordów albo skomplikowaną strukturę, format tabelaryczny staje się mniej wygodny.
W takich przypadkach przejdź do walidatora JSON albo konwertera YAML ↔ JSON.
Ten kalkulator nie próbuje zamieniać CSV w pełny model JSON, dzięki czemu zachowuje prostą i czytelną rolę.
Wskazówka od KalkulatorXXL
Zanim przerobisz dużą listę, sprawdź konwersję na 3–5 przykładowych rekordach zawierających najtrudniejsze przypadki: separator w treści, cudzysłów, pustą wartość i polskie znaki.
Jeżeli mały test przechodzi poprawnie, dopiero wtedy wklej cały zestaw. Przy danych przeznaczonych do Excela, Sheets lub innego systemu upewnij się też, jaki separator jest wybrany podczas importu.