SyntaxError: (unicode error) 'unicodeescape' codec can't decode bytes in position 2-3: truncated \UXXXXXXXX escape
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
cale = "C:\Users\ana\date.csv"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
folder = "D:\Proiecte\Nou\USB"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
cale = "C:\Users\ana" + "\raport.txt"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ă 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.
cale = "C:\Users\ana\Documente\raport.csv"
folder, fisier = cale.rsplit("\\", 1)
print("Fișier:", fisier)
print("Folder:", folder)Fișier: raport.csv Folder: C:\Users\ana\Documente
Indiciu
Pune litera r imediat înaintea ghilimelelor de deschidere.
Reparația
cale = r"C:\Users\ana\Documente\raport.csv"
folder, fisier = cale.rsplit("\\", 1)
print("Fișier:", fisier)
print("Folder:", folder)De ce merge
Într-un text obișnuit, \U cere 8 cifre hexazecimale după el, iar sers nu sunt cifre, așa că Python nu poate compila linia. Cu prefixul r, backslash-urile sunt păstrate ca atare. Separatorul din rsplit este scris "\\", adică un singur backslash, și împarte calea la ultimul \ în folder și numele fișierului.
Alte forme ale mesajului
SyntaxError: (unicode error) 'unicodeescape' codec can't decode bytes in position 2-3: malformed \N character escapeSyntaxError: (unicode error) 'unicodeescape' codec can't decode bytes in position 0-1: truncated \xXX escapeSyntaxError: (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
FileNotFoundError: [Errno 2] No such file or directory: 'date.txt' Python nu găsește fișierul pe care vrei să-l deschizi: numele e scris greșit sau calea e relativă la alt folder decât cel din care rulezi programul. Verifică numele exact (inclusiv extensia) și folderul curent cu `os.getcwd()`, sau construiește calea pornind de la locul scriptului. SyntaxError: unexpected character after line continuation character Ai un backslash `\` în cod, în afara unui text, urmat de alt caracter. În Python, `\` la final de rând înseamnă „continuă pe rândul următor” și nu poate fi urmat de nimic. De obicei ai vrut `/` (împărțire) sau ai uitat ghilimelele unui text. SyntaxError: unterminated string literal (detected at line 1) Un text început cu ghilimele nu e închis pe același rând: lipsește ghilimeaua de final sau ai amestecat `"` cu `'`. Închide textul cu același tip de ghilimele cu care l-ai deschis. Î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.
