...
Eroare Python · Module și fișiere

ValueError: binary mode doesn't take an encoding argument

Pe scurt

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

Greșit
PYTHON
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())
Corect
PYTHON
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

Greșit
PYTHON
open("poza.bin", "wb").write(bytes([137, 80, 78, 71]))
with open("poza.bin", "rb", encoding="latin-1") as f:
    antet = f.read(4)
Corect
PYTHON
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ă tu

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.

Codul care dă eroarea
PYTHON
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])
După reparație, programul afișează
Iași
Indiciu

CSV-ul e un fișier text, iar textul se citește în modul fără b.

Alte forme ale mesajului

  • ValueError: binary mode doesn't take an errors argument
  • ValueError: 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") și Path(cale).read_bytes() fac alegerea explicită.
  • Dacă o bibliotecă îți cere un fișier binar (de exemplu hashlib, zipfile, pickle), nu-i da encoding.

Î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

← 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.