...
Eroare Python · Date: JSON, text și date calendaristice

UnicodeEncodeError: 'ascii' codec can't encode character '\u0219' in position 3: ordinal not in range(128)

Pe scurt

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

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

Ce înseamnă

Encode înseamnă transformarea textului în octeți. ASCII are doar 128 de caractere (litere englezești, cifre, semne), deci nu are ș, ț, ă, î sau â. Când textul are un caracter în afara acestui set, encode("ascii") nu are cum să-l scrie și ridică UnicodeEncodeError. Mesajul arată caracterul în formă Unicode ('\u0219' este ș), poziția lui și motivul: codul caracterului nu e sub 128.

În practică, ASCII ajunge să fie folosit fără să-l ceri: un terminal sau un server configurat cu locale C/POSIX, un container Docker minimal, un program vechi care cere ASCII, sau Windows cu cp1252, care dă 'charmap' codec can't encode character. Apare la print, la scrierea în fișiere fără encoding explicit sau la trimiterea de antete HTTP și emailuri.

De ce apare: cauzele frecvente

1Encode explicit în ASCII

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

UTF-8 poate reprezenta orice caracter Unicode, inclusiv diacriticele românești.

2Fișier scris fără encoding pe un sistem configurat ASCII

Greșit
PYTHON
with open("raport.txt", "w") as f:
    f.write("Total încasări: 500")
Corect
PYTHON
with open("raport.txt", "w", encoding="utf-8") as f:
    f.write("Total încasări: 500")

Cu encoding explicit, rezultatul nu mai depinde de setările sistemului.

3Terminal sau container fără UTF-8

Greșit
PYTHON
# Dockerfile
FROM python:3.12-slim
CMD ["python", "app.py"]
Corect
PYTHON
# Dockerfile
FROM python:3.12-slim
ENV PYTHONIOENCODING=utf-8 LANG=C.UTF-8
CMD ["python", "app.py"]

Variabilele de mediu spun lui Python să folosească UTF-8 pentru intrare și ieșire.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos pregătește numele orașelor pentru trimitere ca bytes și dă UnicodeEncodeError: 'ascii' codec can't encode character '\u0219' .... Folosește UTF-8, ca programul să afișeze Brașov: 7 bytes, Cluj: 4 bytes și Timișoara: 10 bytes.

Codul care dă eroarea
PYTHON
orase = ["Brașov", "Cluj", "Timișoara"]
for oras in orase:
    date = oras.encode("ascii")
    print(f"{oras}: {len(date)} bytes")
După reparație, programul afișează
Brașov: 7 bytes
Cluj: 4 bytes
Timișoara: 10 bytes
Indiciu

Schimbă encoding-ul din encode într-unul care are diacriticele românești.

Alte forme ale mesajului

  • UnicodeEncodeError: 'charmap' codec can't encode character '\u0219' in position 3: character maps to <undefined>
  • UnicodeEncodeError: 'latin-1' codec can't encode character '\u021b' in position 10: ordinal not in range(256)
  • UnicodeEncodeError: 'ascii' codec can't encode characters in position 3-4: ordinal not in range(128)

Cum o eviți pe viitor

  • Folosește UTF-8 peste tot: encoding="utf-8" la fișiere, .encode("utf-8") la conversii.
  • În containere și pe servere, setează LANG=C.UTF-8 și PYTHONIOENCODING=utf-8.
  • Pe Windows, activează modul UTF-8 al lui Python cu PYTHONUTF8=1.
  • Dacă un sistem vechi acceptă doar ASCII, elimină diacriticele controlat (cu unicodedata.normalize), nu cu errors="ignore".

Întrebări frecvente

De ce print merge pe calculatorul meu, dar nu pe server?

Pentru că print encodează textul cu encoding-ul terminalului. Pe calculatorul tău acesta e UTF-8, iar pe server sau într-un container poate fi ASCII. Setează PYTHONIOENCODING=utf-8 sau LANG=C.UTF-8 în mediul serverului.

Pot pur și simplu să ignor caracterele problematice?

Poți, cu encode("ascii", errors="ignore"), dar Brașov devine Braov. Mai bine elimini diacriticele (ș → s) cu unicodedata, sau folosești UTF-8.

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.