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

SyntaxError: (unicode error) 'unicodeescape' codec can't decode bytes in position 2-3: truncated \UXXXXXXXX escape

Pe scurt

Ai scris o cale Windows cu backslash, de exemplu "C:\Users\ana", iar `\U` este interpretat ca început de cod Unicode. Pune `r` în fața textului (r"C:\Users\ana"), dublează backslash-urile sau folosește `/` în cale.

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

Ce înseamnă

În textele Python, backslash-ul \ începe o secvență escape: \n e rând nou, \t e tab, iar \U trebuie urmat de exact 8 cifre hexazecimale (\U0001F600). În "C:\Users", după \U vine sers, care nu sunt cifre hexazecimale, așa că Python nu poate decoda textul și oprește compilarea.

„position 2-3” înseamnă pozițiile din text unde a început secvența greșită (\ și U, numărând de la 0). „truncated \UXXXXXXXX escape” spune că secvența e incompletă. Aceeași problemă apare cu \N (dă malformed \N character escape) și, în tăcere, cu \n sau \t, care nu dau eroare, ci strică doar calea. Aproape mereu e vorba de o cale de fișier pe Windows, de exemplu C:\Users\....

De ce apare: cauzele frecvente

1Cale Windows într-un text obișnuit

Greșit
PYTHON
cale = "C:\Users\ana\date.csv"
Corect
PYTHON
cale = r"C:\Users\ana\date.csv"

Prefixul r (raw string) face ca backslash-ul să fie un caracter normal, deci \U nu mai e o secvență escape.

2Backslash simplu în loc de dublu

Greșit
PYTHON
folder = "D:\Proiecte\Nou\USB"
Corect
PYTHON
folder = "D:\\Proiecte\\Nou\\USB"

\\ înseamnă un singur backslash literal. Varianta e corectă, dar mai greu de citit decât r"...".

3Căi construite cu separatorul Windows

Greșit
PYTHON
cale = "C:\Users\ana" + "\raport.txt"
Corect
PYTHON
from pathlib import Path
cale = Path("C:/Users/ana") / "raport.txt"

Windows acceptă și / în căi, iar pathlib construiește calea corect pe orice sistem.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos dă SyntaxError: (unicode error) 'unicodeescape' codec can't decode bytes ... din cauza unei căi Windows. Transformă calea într-un raw string, ca programul să afișeze Fișier: raport.csv și Folder: C:\Users\ana\Documente.

Codul care dă eroarea
PYTHON
cale = "C:\Users\ana\Documente\raport.csv"
folder, fisier = cale.rsplit("\\", 1)
print("Fișier:", fisier)
print("Folder:", folder)
După reparație, programul afișează
Fișier: raport.csv
Folder: C:\Users\ana\Documente
Indiciu

Pune litera r imediat înaintea ghilimelelor de deschidere.

Alte forme ale mesajului

  • SyntaxError: (unicode error) 'unicodeescape' codec can't decode bytes in position 2-3: malformed \N character escape
  • SyntaxError: (unicode error) 'unicodeescape' codec can't decode bytes in position 0-1: truncated \xXX escape
  • SyntaxError: (unicode error) 'unicodeescape' codec can't decode bytes in position 2-3: truncated \uXXXX escape

Cum o eviți pe viitor

  • Scrie căile Windows ca raw string: r"C:\Users\ana".
  • Sau folosește /: "C:/Users/ana/date.csv" funcționează și pe Windows.
  • Construiește căile cu pathlib.Path și operatorul /, nu prin lipire de texte.
  • Ține fișierele de date lângă proiect și folosește căi relative, ca să nu ai căi absolute în cod.

Întrebări frecvente

De ce "C:\date\nou.txt" nu dă eroare, dar nu găsește fișierul?

Pentru că \n e o secvență escape validă (rând nou), deci textul se compilează, dar conține un rând nou în loc de \n. Python caută un fișier cu un nume ciudat și dă FileNotFoundError. Prefixul r rezolvă ambele probleme.

Pot pune un raw string care se termină cu backslash?

Nu: r"C:\folder\" dă eroare, pentru că ultimul \" protejează ghilimeaua. Scrie calea fără backslash la final sau folosește pathlib.

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.