SyntaxError: bytes can only contain ASCII literal characters
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""
date = b"Brașov"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
antet = b"Total: 20 €"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ă 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.
oras = b"Brașov"
print(len(oras))7
Indiciu
Pornește de la un text obișnuit și transformă-l cu encode.
Reparația
oras = "Brașov".encode("utf-8")
print(len(oras))De ce merge
În literalul b"..." sunt permise doar caractere ASCII, iar „ș” nu e. Pornind de la textul "Brașov" și apelând encode("utf-8"), obții octeții corecți: cinci litere ASCII câte un octet și „ș” pe doi octeți, adică 7 în total.
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")șidecode("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
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","`). UnicodeEncodeError: 'ascii' codec can't encode character '\u0219' in position 3: ordinal not in range(128) Încerci să transformi în bytes (să scrii, să afișezi sau să trimiți) un text cu diacritice folosind un encoding care nu le are, de obicei ASCII. Folosește UTF-8: `text.encode("utf-8")`, `open(..., encoding="utf-8")` sau setează `PYTHONIOENCODING=utf-8` pentru terminal. 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.
