Jak przetłumaczyć plik CSV bez rozsuwania kolumn
EqualangW skrócie
Przetłumacz plik CSV na angielski lub inne języki bez ryzyka, że przecinki przesuną kolumny. Przekonwertuj plik na XLSX lub wyodrębnij kolumny tekstowe w skrypcie.
Słowa kluczowe: jak przetlumaczyc plik csv; tlumaczenie csv; tlumaczenie pliku csv na angielski; tlumaczenie csv online; przesuniete kolumny csv
Tłumaczenie surowego pliku CSV jako zwykłego tekstu niemal zawsze niszczy strukturę tabeli. Ponieważ plik CSV opiera się na przecinkach, znakach końca linii i cudzysłowach do wyznaczania początku i końca każdej komórki, pojedynczy przecinek dodany w przetłumaczonym zdaniu—lub liczba dziesiętna taka jak 12.50 zamieniona na 12,50—dzieli jedno pole na dwa i przesuwa wszystkie kolejne kolumny w prawo.
Aby przetłumaczyć plik CSV na język angielski lub inny język bez uszkadzania danych, należy oddzielić granice komórek od tekstu wewnątrz komórek przed rozpoczęciem tłumaczenia. Poniżej przedstawiono dwie sprawdzone metody: konwersję pliku CSV do skoroszytu .xlsx, dzięki czemu każde pole jest zablokowane w komórce arkusza, albo wyodrębnienie wyłącznie kolumn tekstowych według identyfikatorów wierszy za pomocą skryptu.
Dlaczego surowe pliki CSV psują się w translatorach tekstu
Zgodnie ze standardem formatu CSV (RFC 4180) plik CSV nie posiada ukrytych linii siatki—składa się wyłącznie ze zwykłych znaków:
- Pola są rozdzielane przecinkami (
,), a rekordy znakami końca linii (CRLFlubLF). - Każde pole zawierające przecinek, znak końca linii lub podwójny cudzysłów (
") musi być ujęte w podwójne cudzysłowy. - Znak podwójnego cudzysłowu wewnątrz ujętego w cudzysłowy pola musi być poprzedzony drugim cudzysłowem (
"").
Gdy wklejasz treść CSV do zwykłego translatora lub przesyłasz plik .csv ze zmienionym rozszerzeniem na .txt, silnik traktuje każdy wiersz jak zwykłe zdanie, a nie ustrukturyzowany rekord. Prowadzi to do trzech natychmiastowych problemów:
- Niezabezpieczone przecinki w tłumaczeniu: Wyrażenie źródłowe bez przecinka (
"Versandkostenfrei ab 50 EUR"lub pole bez cudzysłowuLivraison gratuite dès 50 EUR) zostaje przetłumaczone jako"Darmowa dostawa, zamówienia powyżej 50 EUR". Jeśli oryginalne pole nie było objęte cudzysłowem, nowy przecinek natychmiast tworzy dodatkową kolumnę w danym wierszu. - Lokalizacja liczb i separatorów dziesiętnych: W języku polskim, niemieckim czy hiszpańskim separatorem dziesiętnym jest przecinek, więc
12.50często zamienia się w12,50, a1,200w1.200. W kolumnie liczbowej bez cudzysłowów wartość12,50staje się dwoma kolumnami (12oraz50), przesuwając kody SKU, stan magazynowy i znaczniki czasu o jedną kolumnę w prawo. - Uszkodzone cudzysłowy i znaki typograficzne: Translatory nierzadko zamieniają proste cudzysłowy ASCII (
"") na cudzysłowy typograficzne („”lub« ») albo gubią cudzysłów zamykający wielowierszowy opis produktu. Uszkodzenie pary cudzysłowów sprawia, że parser CSV łączy setki kolejnych wierszy w jedną gigantyczną komórkę.
Oryginalny plik CSV (3 kolumny: sku, title, price_usd):
SKU-104,Wireless mouse with USB receiver,24.99
Uszkodzony wynik po bezpośrednim tłumaczeniu tekstu (4 kolumny zamiast 3):
SKU-104,Souris sans fil, avec récepteur USB,24,99
Metoda 1: Konwersja CSV do XLSX, tłumaczenie komórka po komórce i ponowny eksport do CSV
W przypadku katalogów produktów, wyników ankiet, tabel lokalizacyjnych i zestawień finansowych najwygodniejszym rozwiązaniem jest wcześniejsza konwersja pliku .csv do skoroszytu programu Excel (.xlsx), przetłumaczenie pliku .xlsx z zachowaniem izolacji komórek, a następnie zapisanie arkusza jako plik CSV w formacie UTF-8.
Proces ten prezentujemy przy użyciu tłumaczenia dokumentów Equalang. Warto od razu zaznaczyć istotne ograniczenie: Equalang obsługuje formaty PDF, DOCX, PPTX, XLSX, EPUB, HTML oraz TXT—nie przyjmuje bezpośrednio plików .csv. Konwersja .csv na .xlsx jest zarówno wymogiem technicznym podczas przesyłania, jak i gwarancją, że znaki separatorów wewnątrz zdań nie naruszą struktury kolumn.
Krok 1: Zaimportuj plik CSV do arkusza kalkulacyjnego i zapisz jako .xlsx
Nie zmieniaj po prostu rozszerzenia z .csv na .xlsx w menedżerze plików. Otwórz lub zaimportuj plik CSV w programie takim jak Microsoft Excel, LibreOffice Calc lub Arkusze Google, aby parser poprawnie rozdzielił kolumny, a następnie zapisz plik jako skoroszyt .xlsx.
Jeśli plik CSV zawiera znaki spoza zestawu ASCII (np. polskie znaki diakrytyczne, chiński, arabski), skorzystaj w programie Excel z funkcji Dane > Z tekstu/CSV i przed załadowaniem upewnij się, że źródło pliku jest ustawione na 65001: Unicode (UTF-8) (zobacz instrukcję importowania i eksportowania plików tekstowych i CSV w Microsoft Excel). Bezpośrednie kliknięcie dwukrotne pliku CSV w starszych wersjach programu Excel może spowodować uszkodzenie znaków diakrytycznych jeszcze przed tłumaczeniem.
Krok 2: Przetłumacz plik .xlsx
Prześlij plik .xlsx w zakładce Equalang Dokumenty i wskaż język docelowy (narzędzie obsługuje m.in. język angielski, chiński, japoński, koreański, hiszpański i francuski z automatycznym wykrywaniem języka źródłowego). Szczegółowe zasady rozliczania tokenów znajdziesz na stronie z cennikiem.
Format .xlsx przechowuje każde pole jako odrębny obiekt komórki, a nie tekst rozdzielany przecinkami:
- Przecinki i podziały wierszy pozostają wewnątrz komórki: Nawet jeśli przetłumaczony opis produktu zyska dodatkowe przecinki lub akapity, cały tekst pozostaje zamknięty w komórce
B14. - Liczby i formuły nie ulegają zmianie: Komórki zawierające same liczby (ceny, stany magazynowe, numeryczne identyfikatory) oraz formuły są pomijane podczas tłumaczenia i zachowywane w oryginalnej postaci, dzięki czemu
24.99nie zmieni się w24,99. - Powtarzające się frazy są tłumaczone jednokrotnie: Jeśli nazwa kategorii, np.
Electronics, występuje w 2000 wierszy, tłumaczona jest raz, co zapewnia spójność terminologiczną w całym dokumencie.

Po zakończeniu zadania możesz porównać arkusz źródłowy i przetłumaczony obok siebie w obszarze roboczym przed pobraniem pliku. Szersze omówienie zachowania skoroszytów znajdziesz w poradniku jak przetłumaczyć plik Excel.
Krok 3: Sprawdź kody alfanumeryczne i wyeksportuj do pliku UTF-8 CSV
Przed ponownym wyeksportowaniem do formatu .csv przejrzyj kolumny zawierające ciągi alfanumeryczne—takie jak kody SKU (BLK-SM-01), skróty jednostek (pcs), nazwy producentów czy oznaczenia statusów używane przez bazy danych. Choć same liczby są pomijane automatycznie, komórki tekstowe zawierające słowa mogą zostać przetłumaczone (np. pcs na odpowiednik słowa „sztuki”). Jeśli system docelowy wymaga dokładnych angielskich wartości w określonej kolumnie, skopiuj oryginalną kolumnę z pliku źródłowego.
Pamiętaj również, że nazwy zakładek arkusza nie są tłumaczone. Jeśli w pliku dodano formuły sprawdzające dosłowny tekst w cudzysłowach (np. =JEŻELI(F2="In Stock"; 1; 0)), warunek w formule pozostanie w języku źródłowym—przed eksportem dostosuj warunki do przetłumaczonych wartości.
Na koniec w programie Excel wybierz Plik > Zapisz jako i wskaż format CSV UTF-8 (rozdzielany przecinkami) (*.csv). Program automatycznie ujmie w cudzysłowy RFC 4180 wszystkie przetłumaczone pola zawierające przecinki, cudzysłowy lub znaki nowej linii.
Metoda 2: Wyodrębnienie kolumn tekstowych w skrypcie (dla programistów i potoków CLI)
Gdy plik CSV liczy setki tysięcy wierszy, stanowi część zautomatyzowanego potoku CI/CD lub posiada 40 kolumn, z których tylko 2 (product_name i description) wymagają przekładu, ręczna konwersja do .xlsx przestaje być opłacalna.
W zautomatyzowanym procesie nie należy wysyłać surowych linii CSV do interfejsu API ani modelu LLM. Zamiast tego skorzystaj ze standardowego parsera RFC 4180—takiego jak wbudowany w Python moduł csv—aby wczytać każdy wiersz, przetłumaczyć wyłącznie wybrane kolumny i zapisać wynik za pomocą csv.writer z właściwym formatowaniem.
Oto bezpieczny schemat w języku Python:
import csv
SOURCE_FILE = "catalog_source.csv"
OUTPUT_FILE = "catalog_pl.csv"
COLUMNS_TO_TRANSLATE = {"title", "description"}
def translate_text(text: str) -> str:
# Miejsce na wywołanie API tłumaczeniowego dla pojedynczej komórki
if not text.strip():
return text
return text # placeholder
with open(SOURCE_FILE, mode="r", encoding="utf-8-sig", newline="") as infile, \
open(OUTPUT_FILE, mode="w", encoding="utf-8", newline="") as outfile:
reader = csv.DictReader(infile)
writer = csv.DictWriter(
outfile,
fieldnames=reader.fieldnames,
quoting=csv.QUOTE_MINIMAL
)
writer.writeheader()
for row in reader:
for col in COLUMNS_TO_TRANSLATE:
if col in row and row[col]:
row[col] = translate_text(row[col])
writer.writerow(row)
Dlaczego to rozwiązanie działa:
newline=""orazcsv.DictReaderobsługują komórki wielowierszowe: Nawet jeśli opis produktu zajmuje pięć wierszy, zawiera przecinki i podwójne cudzysłowy"",csv.DictReaderprzekazuje go jako jeden spójny ciąg tekstowy.- Pozostałe kolumny są w pełni chronione: Kolumny takie jak
id,sku,priceczyimage_urlw ogóle nie trafiają do modułu tłumaczącego, co wyklucza ryzyko uszkodzenia adresów URL czy zmiany kropek w przecinki. csv.DictWriterautomatycznie dodaje cudzysłowy: Jeśli przetłumaczony tekst zawiera nowe przecinki lub cudzysłowy, parametrcsv.QUOTE_MINIMALautomatycznie obejmuje pole cudzysłowami"..."zgodnie z normą RFC 4180.
Dla niewielkich plików (do kilkuset wierszy) można również zaimportować CSV do Arkuszy Google i wstawić formułę =GOOGLETRANSLATE(B2; "auto"; "pl") w kolumnie pomocniczej, a następnie skopiować wartości i pobrać plik jako .csv. Warto jednak pamiętać, że formuły arkusza wykonują osobne zapytanie dla każdego wiersza i przy większych zbiorach danych ulegają zablokowaniu.
Porównanie: które rozwiązanie wybrać dla Twojego pliku CSV?
Często zadawane pytania
Czy mogę przesłać plik .csv bezpośrednio do Equalang?
Nie. Narzędzie do tłumaczenia dokumentów Equalang obsługuje formaty PDF, DOCX, PPTX, XLSX, EPUB, HTML oraz TXT i nie przyjmuje bezpośrednio plików z rozszerzeniem .csv. Otwórz plik CSV w programie Excel lub innym arkuszu kalkulacyjnym, zapisz go jako .xlsx, przetłumacz plik .xlsx, a następnie zapisz wynik jako plik UTF-8 CSV.
Jak zapobiec wyświetlaniu zniekształconych znaków (??? lub é) w programie Excel?
Zawsze zapisuj i otwieraj pliki CSV w formacie CSV UTF-8 (rozdzielany przecinkami). Jeśli po dwukrotnym kliknięciu w systemie Windows znaki są nieczytelne, otwórz pusty skoroszyt w programie Excel i wybierz opcję Dane > Z tekstu/CSV, ustawiając parametr Źródło pliku na 65001: Unicode (UTF-8).
Dlaczego po przetłumaczeniu pliku CSV kolumny liczbowe i ceny uległy przesunięciu?
Jeśli plik CSV został przetłumaczony jako zwykły tekst na język używający przecinka jako separatora dziesiętnego (taki jak polski, niemiecki czy hiszpański), wartość 19.99 mogła zostać zamieniona na 19,99 bez cudzysłowów. Konwersja do formatu .xlsx przed tłumaczeniem gwarantuje, że komórki z liczbami pozostają wartościami numerycznymi, przez co są pomijane przez translator i nie ulegają modyfikacji.