...
Eroare Python · Erori de sintaxă și indentare

SyntaxError: bytes can only contain ASCII literal characters

Pe scurt

Ai scris un caracter non-ASCII (ș, ț, ă, €) direct într-un literal de bytes b"...". În b"" intră doar caractere ASCII. Scrie textul normal și transformă-l în bytes cu "Brașov".encode("utf-8").

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

Ce înseamnă

Un literal cu prefixul b (b"abc") nu e text, ci o secvență de bytes (octeți, valori 0–255). Python acceptă în el doar caractere ASCII scrise direct, pentru că pentru restul nu știe ce codare vrei (UTF-8, Latin-2, Windows-1250 dau octeți diferiți pentru „ș”).

Când scrii b"Brașov", Python ajunge la ș și refuză tot fișierul: bytes can only contain ASCII literal characters. E o eroare de sintaxă, deci apare înainte de rulare.

Reparația e să pornești de la un text obișnuit (str) și să-l transformi explicit: "Brașov".encode("utf-8"). Dacă ai nevoie de octeți anume, îi scrii cu escape-uri: b"Bra\xc8\x99ov". Situația apare des când scrii date pentru fișiere binare, socket-uri, hash-uri (hashlib) sau base64.

De ce apare: cauzele frecvente

1Diacritice într-un literal b""

Greșit
PYTHON
date = b"Brașov"
Corect
PYTHON
date = "Brașov".encode("utf-8")
print(date)

encode spune clar ce codare folosești, iar Python produce octeții corespunzători.

2Simbolul monedei în date binare

Greșit
PYTHON
antet = b"Total: 20 €"
Corect
PYTHON
antet = "Total: 20 €".encode("utf-8")
print(len(antet))

€ nu e ASCII; în UTF-8 ocupă trei octeți, pe care îi obții din encode.

Repară tu

Repară eroarea, direct în pagină

Programul pregătește numele unui oraș ca bytes (de exemplu pentru un fișier binar) și afișează câți octeți are, dar Python dă SyntaxError: bytes can only contain ASCII literal characters. Repară linia ca să obții bytes în UTF-8 și programul să afișeze 7.

Codul care dă eroarea
PYTHON
oras = b"Brașov"
print(len(oras))
După reparație, programul afișează
7
Indiciu

Pornește de la un text obișnuit și transformă-l cu encode.

Cum o eviți pe viitor

  • Lucrează cu texte (str) în program și transformă-le în bytes doar la margine: la scriere în fișiere binare, rețea, hash-uri.
  • Folosește mereu encode("utf-8") și decode("utf-8") cu codarea scrisă explicit.
  • Păstrează literalele b"..." pentru date pur ASCII sau octeți scriși cu \x...

Întrebări frecvente

De ce text normal cu diacritice merge, dar bytes nu?

Un str ține caractere Unicode, deci orice literă. Un bytes ține octeți, iar o literă ca „ș” poate deveni octeți diferiți în funcție de codare. Python nu ghicește codarea, așa că îți cere să o alegi tu cu encode.

Cum aflu octeții unui caracter?

"ș".encode("utf-8") afișează b'\xc8\x99': în UTF-8, „ș” ocupă doi octeți.

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.