...
Eroare Python · Date: JSON, text și date calendaristice

_csv.Error: iterator should return strings, not bytes (the file should be opened in text mode)

Pe scurt

Ai dat modulului csv un fișier deschis binar ("rb") sau octeți primiți din rețea. csv lucrează cu text. Deschide fișierul în mod text: open(cale, newline="", encoding="utf-8"), iar pentru octeți folosește io.StringIO(date.decode("utf-8")).

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

csv.reader și csv.DictReader citesc rând cu rând dintr-un obiect care întoarce texte (str). Un fișier deschis cu "rb" întoarce octeți (bytes), iar modulul csv îți spune exact asta: iterator should return strings, not bytes, cu sfatul din paranteză: deschide fișierul în mod text.

Situația apare mai ales în două feluri. Primul: cod vechi din Python 2, unde fișierele CSV se deschideau cu "rb". Al doilea: conținut CSV primit ca octeți, de exemplu dintr-un răspuns HTTP (response.content), dintr-un upload sau dintr-o arhivă ZIP (zipfile.ZipFile.open întoarce un fișier binar).

Pentru fișiere, deschide-le cu newline="" și encoding="utf-8". Pentru octeți în memorie, decodează-i și pune-i într-un io.StringIO, sau învelește fișierul binar în io.TextIOWrapper.

De ce apare: cauzele frecvente

1Fișier deschis cu rb

Greșit
PYTHON
import csv
open("clienti.csv", "w", encoding="utf-8").write("nume,oras\nAna,Cluj\n")
with open("clienti.csv", "rb") as f:
    for rand in csv.reader(f):
        print(rand)
Corect
PYTHON
import csv
open("clienti.csv", "w", encoding="utf-8").write("nume,oras\nAna,Cluj\n")
with open("clienti.csv", newline="", encoding="utf-8") as f:
    for rand in csv.reader(f):
        print(rand)

În mod text, fișierul întoarce texte, exact ce așteaptă csv.

2CSV din arhivă ZIP

Greșit
PYTHON
import csv, zipfile
with zipfile.ZipFile("a.zip", "w") as z:
    z.writestr("d.csv", "a,b\n1,2\n")
with zipfile.ZipFile("a.zip") as z, z.open("d.csv") as f:
    print(list(csv.reader(f)))
Corect
PYTHON
import csv, io, zipfile
with zipfile.ZipFile("a.zip", "w") as z:
    z.writestr("d.csv", "a,b\n1,2\n")
with zipfile.ZipFile("a.zip") as z, z.open("d.csv") as f:
    print(list(csv.reader(io.TextIOWrapper(f, encoding="utf-8"))))

z.open dă un fișier binar; io.TextIOWrapper îl transformă într-unul text.

Repară tu

Repară eroarea, direct în pagină

Programul primește conținutul unui raport CSV ca octeți (de exemplu dintr-un răspuns HTTP) și vrea să adune coloana total, dar csv.DictReader dă _csv.Error: iterator should return strings, not bytes. Repară citirea ca programul să afișeze 330.

Codul care dă eroarea
PYTHON
import csv
import io

continut = "luna,total\nian,120\nfeb,210\n".encode("utf-8")

cititor = csv.DictReader(io.BytesIO(continut))
print(sum(int(rand["total"]) for rand in cititor))
După reparație, programul afișează
330
Indiciu

Decodează octeții în text și pune textul într-un io.StringIO, care se comportă ca un fișier text.

Alte forme ale mesajului

  • _csv.Error: iterator should return strings, not bytes (did you open the file in text mode?)
  • csv.Error: iterator should return strings, not bytes
  • _csv.Error: iterator should return strings, not int (the file should be opened in text mode)

Cum o eviți pe viitor

  • Deschide fișierele CSV mereu așa: open(cale, newline="", encoding="utf-8") (la scriere, cu "w").
  • Când primești CSV ca octeți (HTTP, upload, ZIP), decodează-l o dată, la margine, și lucrează apoi doar cu text.
  • Când copiezi cod din tutoriale vechi, înlocuiește "rb"/"wb" la CSV cu modul text.
  • Pentru fișiere CSV exportate din Excel, încearcă encoding="utf-8-sig", care elimină marcajul BOM de la început.

Întrebări frecvente

De ce newline=""?

Ca modulul csv să gestioneze singur capetele de rând. Fără el, pe Windows poți obține rânduri goale între rânduri la scriere sau probleme cu câmpurile care conțin enter.

Am un șir de octeți din requests. Cum îl citesc ca CSV?

csv.reader(io.StringIO(response.content.decode("utf-8"))) sau, mai simplu, csv.reader(response.text.splitlines()), dacă requests a ghicit corect codarea.

Erori înrudite

← Toate erorile Python

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Python de la zero, cu exerciții la fiecare lecție

Curs Python: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.