...
Eroare Python · Module și fișiere

ImportError: attempted relative import with no known parent package

Pe scurt

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

Greșit
PYTHON
# main.py, rulat cu: python main.py
from .utile import pret_cu_tva
Corect
PYTHON
# main.py, rulat cu: python main.py
from utile import pret_cu_tva

Fiș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

Greșit
PYTHON
# proiect/rapoarte/export.py
from .formatare import tabel
# rulat cu: python proiect/rapoarte/export.py
Corect
PYTHON
# proiect/rapoarte/export.py
from .formatare import tabel
# rulat din folderul părinte cu:
# python -m proiect.rapoarte.export

Cu -m, Python încarcă fișierul ca modul al pachetului, deci știe cine e „părintele”.

3Teste puse lângă cod

Greșit
PYTHON
# teste/test_calcul.py
from ..calcul import total
Corect
PYTHON
# teste/test_calcul.py
from proiect.calcul import total
# rulat cu: python -m pytest

Testele importă codul cu nume absolute. pytest rulat din rădăcină configurează căile.

Repară tu

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.

Codul care dă eroarea
PYTHON
from .utile import pret_cu_tva

print(f"Preț cu TVA: {pret_cu_tva(100)} lei")
După reparație, programul afișează
Preț cu TVA: 119.0 lei
Indiciu

Scriptul rulat direct nu face parte dintr-un pachet; scoate punctul din import.

Alte forme ale mesajului

  • ImportError: attempted relative import beyond top-level package
  • ImportError: 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.modul din 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

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