ImportError: attempted relative import with no known parent package
Ai un import relativ (`from .utile import f`) într-un fișier pe care îl rulezi direct (`python main.py`). Importurile cu punct merg doar în interiorul unui pachet. Folosește import absolut (`from utile import f`) sau rulează programul ca modul: `python -m proiect.main`.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Punctul din from .utile import f înseamnă „din același pachet cu mine”. Ca să știe care e pachetul, Python se uită la numele modulului curent. Când rulezi un fișier direct, de exemplu python main.py, acel fișier devine modulul __main__ și nu aparține niciunui pachet, deci Python nu are față de ce să calculeze „același pachet”, iar importul relativ eșuează.
Eroarea apare des în proiecte organizate în foldere: scriptul funcționează când e importat de alt modul, dar nu când îl pornești singur, sau când rulezi un fișier din interiorul unui pachet cu butonul Run din editor. Soluțiile: importuri absolute, pornite de la rădăcina proiectului; rularea cu python -m pachet.modul din folderul părinte; sau un singur punct de intrare (main.py) la rădăcină.
De ce apare: cauzele frecvente
1Import relativ într-un script rulat direct
# main.py, rulat cu: python main.py
from .utile import pret_cu_tva# main.py, rulat cu: python main.py
from utile import pret_cu_tvaFișierul rulat direct nu e într-un pachet. Importul absolut găsește utile.py în folderul scriptului.
2Fișier dintr-un pachet rulat cu Run
# proiect/rapoarte/export.py
from .formatare import tabel
# rulat cu: python proiect/rapoarte/export.py# proiect/rapoarte/export.py
from .formatare import tabel
# rulat din folderul părinte cu:
# python -m proiect.rapoarte.exportCu -m, Python încarcă fișierul ca modul al pachetului, deci știe cine e „părintele”.
3Teste puse lângă cod
# teste/test_calcul.py
from ..calcul import total# teste/test_calcul.py
from proiect.calcul import total
# rulat cu: python -m pytestTestele importă codul cu nume absolute. pytest rulat din rădăcină configurează căile.
Repară eroarea, direct în pagină
În folderul de lucru există fișierul utile.py, iar programul de mai jos (rulat direct, ca script) dă ImportError: attempted relative import with no known parent package. Schimbă importul într-unul absolut, ca programul să afișeze Preț cu TVA: 119.0 lei.
from .utile import pret_cu_tva
print(f"Preț cu TVA: {pret_cu_tva(100)} lei")Preț cu TVA: 119.0 lei
Indiciu
Scriptul rulat direct nu face parte dintr-un pachet; scoate punctul din import.
Reparația
from utile import pret_cu_tva
print(f"Preț cu TVA: {pret_cu_tva(100)} lei")De ce merge
Punctul din from .utile cere un pachet părinte, dar un script rulat direct devine modulul __main__, fără pachet. Importul absolut from utile import ... caută utile.py în folderul scriptului, care se află pe calea de căutare a lui Python, așa că funcția e găsită și 100 × 1.19 = 119.0.
Alte forme ale mesajului
ImportError: attempted relative import beyond top-level packageImportError: cannot import name 'pret_cu_tva' from partially initialized module 'utile' (most likely due to a circular import)ModuleNotFoundError: No module named '__main__.utile'; '__main__' is not a package
Cum o eviți pe viitor
- Preferă importurile absolute, pornite de la rădăcina proiectului:
from proiect.utile import f. - Ține un singur punct de intrare la rădăcină (
main.py) și rulează-l pe el. - Când trebuie să rulezi un modul dintr-un pachet, folosește
python -m pachet.moduldin folderul părinte. - Pentru proiecte mai mari, instalează proiectul în mediul virtual cu
pip install -e ..
Întrebări frecvente
De ce același fișier merge când e importat, dar nu când îl rulez?
Când e importat, numele lui e de forma proiect.main, deci Python știe pachetul. Rulat direct, numele devine __main__, fără pachet, iar . nu mai are la ce să se refere.
Am nevoie de __init__.py în fiecare folder?
De la Python 3.3, folderele fără __init__.py pot fi pachete („namespace packages”). Totuși, un __init__.py, chiar gol, face clar că folderul e pachet și evită surprize la unelte ca pytest sau mypy.
Erori înrudite
ModuleNotFoundError: No module named 'requests' Python nu găsește modulul importat: fie numele e scris greșit (`maths`, `Math`), fie pachetul nu e instalat în mediul în care rulezi. Corectează numele sau instalează pachetul cu `python -m pip install requests`, folosind exact interpretorul care rulează programul. AttributeError: module 'math' has no attribute 'sqroot'. Did you mean: 'sqrt'? Modulul importat nu conține funcția sau atributul cerut: numele e scris greșit (citește sugestia `Did you mean`), funcția e în alt submodul sau ai un fișier propriu cu numele modulului care îl ascunde pe cel real. Corectează numele sau redenumește fișierul. TypeError: 'module' object is not callable. Did you mean: 'datetime.datetime(...)'? Ai apelat un modul ca pe o funcție, de exemplu `import datetime` urmat de `datetime(...)`. Modulul și clasa din el au același nume. Scrie `datetime.datetime(...)` sau importă direct clasa: `from datetime import datetime`. Î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.
