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").
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
open are două feluri de a lucra: text (modul implicit, "r", "w") și binar (cu b: "rb", "wb"). În modul text, Python transformă octeții din fișier în caractere folosind codarea din encoding=. În modul binar, primești octeții exact cum sunt, ca bytes, fără nicio transformare.
De aceea, combinația open("f.csv", "rb", encoding="utf-8") se contrazice, iar Python o refuză: binary mode doesn't take an encoding argument. Aceeași regulă pentru errors= și newline=: binary mode doesn't take an errors argument, binary mode doesn't take a newline argument.
Decide ce vrei: text (CSV, JSON, TXT) înseamnă mod fără b și cu encoding; imagini, PDF-uri, arhive și hash-uri de fișiere înseamnă mod cu b și fără encoding.
De ce apare: cauzele frecvente
1Fișier text deschis binar
open("clienti.csv", "w", encoding="utf-8").write("Ana,Iași\n")
with open("clienti.csv", "rb", encoding="utf-8") as f:
print(f.read())open("clienti.csv", "w", encoding="utf-8").write("Ana,Iași\n")
with open("clienti.csv", "r", encoding="utf-8") as f:
print(f.read())Pentru text, modul fără b aplică decodarea UTF-8 și întoarce str.
2Ai nevoie chiar de octeți
open("poza.bin", "wb").write(bytes([137, 80, 78, 71]))
with open("poza.bin", "rb", encoding="latin-1") as f:
antet = f.read(4)open("poza.bin", "wb").write(bytes([137, 80, 78, 71]))
with open("poza.bin", "rb") as f:
antet = f.read(4)
print(antet)În modul binar nu dai codare; dacă vrei text din octeți, folosești după aceea antet.decode(...).
Repară eroarea, direct în pagină
Programul citește un fișier CSV cu orașe care conțin diacritice și afișează a doua coloană din primul rând, dar deschiderea fișierului dă ValueError: binary mode doesn't take an encoding argument. Repar-o ca programul să afișeze Iași.
with open("clienti.csv", "w", encoding="utf-8") as f:
f.write("Ana,Iași\nDan,Brașov\n")
with open("clienti.csv", "rb", encoding="utf-8") as f:
primul = f.readline().strip().split(",")
print(primul[1])Iași
Indiciu
CSV-ul e un fișier text, iar textul se citește în modul fără b.
Reparația
with open("clienti.csv", "w", encoding="utf-8") as f:
f.write("Ana,Iași\nDan,Brașov\n")
with open("clienti.csv", "r", encoding="utf-8") as f:
primul = f.readline().strip().split(",")
print(primul[1])De ce merge
Modul "rb" citește octeți brut, fără decodare, așa că un encoding nu are ce face acolo. Un CSV e text, deci se deschide în modul "r", unde encoding="utf-8" transformă octeții în caractere, inclusiv „ș”. readline întoarce primul rând ca text, pe care îl împărțim la virgulă.
Alte forme ale mesajului
ValueError: binary mode doesn't take an errors argumentValueError: binary mode doesn't take a newline argument
Cum o eviți pe viitor
- Hotărăște de la început dacă fișierul e text sau binar.
- Pentru text, folosește mereu
open(cale, "r", encoding="utf-8"); pentru binar,open(cale, "rb"). - Cu
pathlib,Path(cale).read_text(encoding="utf-8")șiPath(cale).read_bytes()fac alegerea explicită. - Dacă o bibliotecă îți cere un fișier binar (de exemplu
hashlib,zipfile,pickle), nu-i daencoding.
Întrebări frecvente
Cum transform octeții citiți binar în text?
Cu octeti.decode("utf-8"). E echivalent cu a deschide fișierul în mod text cu encoding="utf-8", doar că decodarea o faci tu, când vrei.
Ce codare folosește modul text dacă nu dau encoding?
Codarea implicită a sistemului, care pe Windows poate fi alta decât UTF-8. De aceea e bine să scrii encoding="utf-8" explicit, ca programul să se comporte la fel peste tot.
Erori înrudite
ValueError: must have exactly one of create/read/write/append mode Modul dat lui open() combină două acțiuni principale, de exemplu "rw". Alege una: "r" (citire), "w" (scriere, golește fișierul), "a" (adăugare la final) sau "x" (creare); pentru citire și scriere în același fișier folosește "r+". 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","`). UnicodeDecodeError: 'utf-8' codec can't decode byte 0xe9 in position 15: invalid continuation byte Fișierul (sau datele) nu e salvat în UTF-8, ci în alt encoding, de obicei unul vechi de Windows (`cp1250`, `latin-1`) sau e un Excel salvat ca CSV. Deschide-l cu encoding-ul corect: `open("fisier.csv", encoding="cp1250")`, sau resalvează-l ca UTF-8. Î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.
