_csv.Error: iterator should return strings, not bytes (the file should be opened in text mode)
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
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)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
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)))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ă 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.
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))330
Indiciu
Decodează octeții în text și pune textul într-un io.StringIO, care se comportă ca un fișier text.
Reparația
import csv
import io
continut = "luna,total\nian,120\nfeb,210\n".encode("utf-8")
cititor = csv.DictReader(io.StringIO(continut.decode("utf-8")))
print(sum(int(rand["total"]) for rand in cititor))De ce merge
io.BytesIO se comportă ca un fișier binar și întoarce rânduri de octeți, iar modulul csv lucrează doar cu text. După decode("utf-8"), conținutul devine text, iar io.StringIO îl oferă rând cu rând ca un fișier text. DictReader citește apoi rândurile cu antetul luna,total, iar suma e 120 + 210 = 330.
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
ValueError: binary mode doesn't take an encoding argument Ai deschis un fișier în mod binar ("rb", "wb") și i-ai dat și encoding=. În modul binar citești octeți, fără decodare, deci encoding nu are sens. Fie scoți "b" din mod ca să lucrezi cu text, fie scoți encoding și decodezi tu cu .decode("utf-8"). TypeError: a bytes-like object is required, not 'str' Amesteci bytes (`b"..."`) cu texte (`str`): de exemplu faci `split(",")` pe date binare, cauți un text într-un bytes sau scrii text într-un fișier deschis cu `"wb"`. Decodează datele cu `.decode("utf-8")` sau lucrează doar cu bytes (`b","`). ValueError: dict contains fields not in fieldnames: 'email' csv.DictWriter a primit un dicționar cu o cheie care nu e în lista fieldnames, deci nu știe în ce coloană s-o scrie. Adaugă cheia în fieldnames, scoate-o din dicționar, sau folosește extrasaction="ignore" ca să fie ignorată. Î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.
