FileExistsError: [Errno 17] File exists: 'rapoarte'
Ai încercat să creezi un director (cu `os.mkdir`) sau un fișier nou (cu modul `"x"`) care există deja. Pentru directoare folosește `os.makedirs("rapoarte", exist_ok=True)` sau `Path("rapoarte").mkdir(exist_ok=True)`, care nu dau eroare dacă directorul există.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
FileExistsError e o subclasă a lui OSError, cu codul de sistem 17 (EEXIST). Apare când ceri sistemului de operare să creeze ceva care e deja acolo: os.mkdir("rapoarte") când directorul există, open("raport.txt", "x") (modul „creează, dar doar dacă nu există”) când fișierul există, sau os.rename/os.symlink pe Windows când destinația e ocupată.
Cel mai des, scriptul a mers prima dată, iar a doua rulare pică, pentru că directorul creat atunci a rămas pe disc. Mesajul îți spune calea. Pe Windows, același lucru apare ca [WinError 183] Cannot create a file when that file already exists. Reparația depinde de intenție: dacă e în regulă ca directorul să existe, cere crearea „dacă lipsește”; dacă trebuie să nu suprascrii un fișier, prinde excepția și tratează cazul.
De ce apare: cauzele frecvente
1mkdir rulat a doua oară
import os
os.mkdir("rapoarte")
os.mkdir("rapoarte")import os
os.makedirs("rapoarte", exist_ok=True)
os.makedirs("rapoarte", exist_ok=True)exist_ok=True spune: creează directorul dacă lipsește, iar dacă există, nu e o eroare.
2Mod "x" pe un fișier existent
open("raport.txt", "w").close()
with open("raport.txt", "x") as f:
f.write("nou")open("raport.txt", "w").close()
try:
with open("raport.txt", "x") as f:
f.write("nou")
except FileExistsError:
print("Raportul există deja, nu-l suprascriu")Modul "x" e ales tocmai ca să nu suprascrii; tratează cazul în care fișierul există.
3Cu pathlib
from pathlib import Path
Path("export").mkdir()
Path("export").mkdir()from pathlib import Path
Path("export/2025").mkdir(parents=True, exist_ok=True)parents=True creează și directoarele intermediare, iar exist_ok=True acceptă directorul existent.
Repară eroarea, direct în pagină
Funcția de mai jos pregătește directorul pentru rapoarte și e apelată de două ori, iar al doilea apel dă FileExistsError: [Errno 17] File exists: 'rapoarte'. Repară funcția, ca ambele apeluri să meargă și programul să afișeze de două ori Director gata: rapoarte.
import os
def pregateste():
os.mkdir("rapoarte")
print("Director gata:", "rapoarte")
pregateste()
pregateste()Director gata: rapoarte Director gata: rapoarte
Indiciu
Există o funcție din os care acceptă exist_ok=True.
Reparația
import os
def pregateste():
os.makedirs("rapoarte", exist_ok=True)
print("Director gata:", "rapoarte")
pregateste()
pregateste()De ce merge
os.mkdir creează directorul și pică dacă acesta există deja, așa că al doilea apel se oprea. os.makedirs(..., exist_ok=True) creează directorul doar dacă lipsește și nu consideră o eroare faptul că există. Funcția poate fi apelată acum de oricâte ori. Același parametru există și la Path.mkdir.
Alte forme ale mesajului
FileExistsError: [Errno 17] File exists: 'raport.txt'FileExistsError: [WinError 183] Cannot create a file when that file already exists: 'rapoarte'
Cum o eviți pe viitor
- Pentru directoare, folosește din start
os.makedirs(cale, exist_ok=True)sauPath(cale).mkdir(parents=True, exist_ok=True). - Scrie scripturile astfel încât să poată fi rulate de mai multe ori la rând fără erori.
- Folosește modul
"x"doar când chiar vrei să eviți suprascrierea, și prindeFileExistsError.
Întrebări frecvente
Nu e mai simplu să verific cu os.path.exists înainte?
Merge, dar între verificare și creare un alt proces poate crea același director. exist_ok=True face totul într-un singur pas și e varianta recomandată.
Ce se întâmplă dacă există un fișier (nu un director) cu același nume?
os.makedirs(..., exist_ok=True) dă tot FileExistsError, pentru că pe acea cale e un fișier, nu un director. Redenumește sau șterge fișierul.
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. io.UnsupportedOperation: not readable Ai deschis fișierul doar pentru scriere (`"w"` sau `"a"`) și apoi ai încercat să citești din el. Închide-l și redeschide-l cu `"r"` pentru citire, sau folosește `"r+"` / `"w+"` dacă ai nevoie de ambele. Varianta `not writable` e cazul invers. ValueError: I/O operation on closed file. Ai citit sau ai scris într-un fișier după ce a fost închis, de obicei pentru că linia e în afara blocului `with open(...)`. Mută operația în interiorul blocului (indentată sub `with`) sau deschide fișierul din nou. Î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.
