बिना किसी ज्ञात पेरेंट पैकेज के सापेक्ष आयात का प्रयास करने वाली आयात त्रुटि को कैसे ठीक करें

त्रुटिआयातत्रुटि: बिना किसी ज्ञात मूल पैकेज के सापेक्ष आयात का प्रयास किया गया पायथन में कई डेवलपर्स को भ्रमित किया जाता है। ऐसा तब होता है जब आप एक फ़ाइल चलाते हैं जो पैकेज के हिस्से के बजाय स्क्रिप्ट के रूप में सापेक्ष आयात का उपयोग करती है। यहां बताया गया है कि ऐसा क्यों होता है और इसे कैसे ठीक किया जाए।

ऐसा क्यों होता है

सापेक्ष आयात (from .module import x) केवल तभी काम करता है जब पायथन को पता हो कि फ़ाइल एक पैकेज का हिस्सा है। जब आप किसी फ़ाइल को सीधे (python myfile.py) चलाते हैं, तो पायथन इसे बिना किसी मूल पैकेज वाली शीर्ष-स्तरीय स्क्रिप्ट के रूप में मानता है – इसलिए सापेक्ष आयात विफल हो जाते हैं।. आयात के सापेक्ष कोई पैकेज नहीं है।

सेटअप जो इसे ट्रिगर करता है

# Project structure
myproject/
├── mypackage/
│   ├── __init__.py
│   ├── main.py
│   └── helper.py

# main.py uses a relative import
# from .helper import do_something

# 🐛 Running directly fails
python mypackage/main.py
# ImportError: attempted relative import with no known parent package

समाधान 1: -m

# Run from the PROJECT ROOT (parent of mypackage) using -m
cd myproject
python -m mypackage.main

# The -m flag runs it as a module within the package,
# so Python knows the parent package and relative imports work

के साथ एक मॉड्यूल के रूप में चलाएँ यह पैकेज कोड चलाने का सही तरीका है जो सापेक्ष आयात का उपयोग करता है। ध्यान दें कि आप प्रोजेक्ट रूट से चलते हैं और डॉट्स का उपयोग करते हैं, स्लैश का नहीं।

समाधान 2: पूर्ण आयात का उपयोग करें

# Instead of relative imports:
# from .helper import do_something          # relative

# Use absolute imports:
from mypackage.helper import do_something   # absolute

# Absolute imports work whether run as a script or module,
# as long as the package is on the Python path

समाधान 3: एक उचित प्रवेश बिंदु जोड़ें

# Create a run script at the project root (outside the package)
# myproject/run.py
from mypackage.main import main

if __name__ == '__main__':
    main()

# Run it from the root — absolute imports resolve correctly
python run.py

समाधान 4: इसे एक उचित इंस्टाल करने योग्य पैकेज बनाएं

# pyproject.toml
[project]
name = "mypackage"
version = "0.1.0"

[project.scripts]
mypackage = "mypackage.main:main"

# Install in editable mode
pip install -e .

# Now run via the entry point — imports work correctly
mypackage
# Or: python -m mypackage.main

सापेक्ष बनाम निरपेक्ष आयात को समझना

# Relative imports (need a parent package)
from . import sibling_module        # same package
from .helper import func            # module in same package
from ..other_package import thing   # parent package

# Absolute imports (need package on path)
from mypackage.helper import func
from mypackage.subpackage.mod import thing

# Rule of thumb: absolute imports are more explicit and robust.
# Use them unless you have a specific reason for relative imports.

__init__.py आवश्यकता

# For a directory to be a package (enabling relative imports),
# it typically needs an __init__.py file:

mypackage/
├── __init__.py       # makes mypackage a package (can be empty)
├── main.py
└── helper.py

# Without __init__.py, Python may treat it as a namespace package
# (works in modern Python but can cause confusion). For clarity,
# include __init__.py in packages that use relative imports.

त्वरित निर्णय मार्गदर्शिका

• विकास के लिए पैकेज फ़ाइल चला रहे हैं? Use python -m package.moduleका प्रयोग करें प्रोजेक्ट रूट से
• क्या आप ऐसे आयात चाहते हैं जो हमेशा काम करें? पूर्ण आयात का उपयोग करें (from mypackage.x import y)
• एक वास्तविक परियोजना का निर्माण?इसे एक प्रवेश बिंदु के साथ एक इंस्टॉल करने योग्य पैकेज बनाएं
• बस एक साधारण स्क्रिप्ट?सापेक्ष आयात का उपयोग न करें – पूर्ण का उपयोग करें या सब कुछ एक फ़ाइल में रखें

अक्सर पूछे जाने वाले प्रश्न

प्रश्न: सापेक्ष आयात कुछ फ़ाइलों में क्यों काम करते हैं लेकिन अन्य में नहीं?
ए: जब फ़ाइल को पैकेज के हिस्से के रूप में आयात किया जाता है, तो वे काम करते हैं, लेकिन स्क्रिप्ट के रूप में सीधे चलाने पर विफल हो जाते हैं। वही फ़ाइल आयात होने पर काम कर सकती है और विफल हो सकती है when run with python file.py — because direct execution has no parent package.

Q: Should I use relative or absolute imports?
A: Absolute imports are generally recommended — they’re explicit, work in more situations, and are clearer about where things come from. Use relative imports only within a package when it improves readability, and understand they require running as a module.

Q: What does the -m flag actually do?
A: It runs a module as part of its package, setting up the package context so relative imports resolve. python -m mypackage.main tells Python “run main as a module inside mypackage,” giving it the parent package it needs.

Q: Do I always need __init__.py?
A: In modern Python, namespace packages work without it, but including __init__.py makes your package explicit and avoids ambiguity, especially when using relative imports. It’s good practice to include it.

Q: My IDE runs it fine but the terminal fails. Why?
A: IDEs often set the working directory and Python path to the project root and may run files as modules. Replicate that in the terminal: run from the project root with python -m package.module, or configure your path/entry point to match.

Conclusion

“Attempted relative import with no known parent package” means you’re running a package file directly as a script, so relative imports have no parent package to resolve against. The fixes: run it as a module withpython -m mypackage.mainप्रोजेक्ट रूट से, पूर्ण आयात पर स्विच करें (from mypackage.helper import x), या प्रोजेक्ट रूट पर एक उचित प्रवेश बिंदु बनाएं। मजबूत परियोजनाओं के लिए, इसे एक प्रवेश बिंदु के साथ एक इंस्टॉल करने योग्य पैकेज बनाएं – वे स्पष्ट हैं और काम करते हैं चाहे आपका कोड स्क्रिप्ट या मॉड्यूल के रूप में चलता हो।