Jak przetłumaczyć plik CSV bez rozsuwania kolumn

Equalang

W 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 (CRLF lub LF).
  • 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:

  1. Niezabezpieczone przecinki w tłumaczeniu: Wyrażenie źródłowe bez przecinka ("Versandkostenfrei ab 50 EUR" lub pole bez cudzysłowu Livraison 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.
  2. Lokalizacja liczb i separatorów dziesiętnych: W języku polskim, niemieckim czy hiszpańskim separatorem dziesiętnym jest przecinek, więc 12.50 często zamienia się w 12,50, a 1,200 w 1.200. W kolumnie liczbowej bez cudzysłowów wartość 12,50 staje się dwoma kolumnami (12 oraz 50), przesuwając kody SKU, stan magazynowy i znaczniki czasu o jedną kolumnę w prawo.
  3. 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.99 nie zmieni się w 24,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.
Przetłumaczony arkusz XLSX w języku angielskim z zachowaną strukturą kolumn, komórkami liczbowymi i sumami
Zrzut ekranu przedstawia arkusz kalkulacyjny w języku angielskim, w którym przetłumaczone pola tekstowe pozostają w oddzielnych komórkach, a liczby i formuły nie uległy zmianie

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:

  1. newline="" oraz csv.DictReader obsługują komórki wielowierszowe: Nawet jeśli opis produktu zajmuje pięć wierszy, zawiera przecinki i podwójne cudzysłowy "", csv.DictReader przekazuje go jako jeden spójny ciąg tekstowy.
  2. Pozostałe kolumny są w pełni chronione: Kolumny takie jak id, sku, price czy image_url w ogóle nie trafiają do modułu tłumaczącego, co wyklucza ryzyko uszkodzenia adresów URL czy zmiany kropek w przecinki.
  3. csv.DictWriter automatycznie dodaje cudzysłowy: Jeśli przetłumaczony tekst zawiera nowe przecinki lub cudzysłowy, parametr csv.QUOTE_MINIMAL automatycznie 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?

ScenariuszZalecane podejścieNa co zwrócić uwagę
Od 100 do 50 000 wierszy, kolumny tekstowe i liczbowe, powtarzające się etykietyKonwersja .csv → .xlsx, tłumaczenie w Equalang, ponowny eksport do UTF-8 CSVSkopiuj z powrotem kolumny SKU lub oznaczenia systemowe, jeśli oprogramowanie wymaga oryginalnych wartości
Poniżej 200 wierszy, szybkie tłumaczenie podręczneArkusze Google z formułą =GOOGLETRANSLATE() w kolumnie pomocniczej, eksport do CSVFormuły przeliczają się dynamicznie i zwalniają przy większej liczbie wierszy; wklej same wartości przed eksportem
Zautomatyzowany potok backendowy lub bardzo duże zbiory (ponad 100 tys. wierszy)Przetwarzanie przez Python csv.DictReader, tłumaczenie wybranych kolumn, zapis przez csv.DictWriterWarto buforować przetłumaczone powtarzające się frazy w słowniku, aby uniknąć ponownych zapytań o te same teksty

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.

Źródła