绝对导入从根目录开始,明确清晰,推荐使用;相对导入基于当前位置,适用于包内模块。例如,在views.py中可用from utils.helpers import my_function(绝对)或from ..utils.helpers import my_function(相对)。建议优先用绝对导入,避免混用,确保根目录在Python路径中或用-m运行。

在Python中,导入模块是组织和复用代码的重要方式。根据导入路径的写法不同,可以分为绝对导入和相对导入。理解它们的区别和使用场景,有助于更好地管理项目结构。
绝对导入
绝对导入是指从项目的根目录开始,按照完整的包路径来导入模块。它明确、清晰,推荐在大多数情况下使用。
假设你的项目结构如下:
myproject/__init__.py
main.py
utils/
__init__.py
helpers.py
app/
__init__.py
views.py
如果你想在 views.py 中导入 helpers.py,使用绝对导入的方式是:
立即学习“Python免费学习笔记(深入)”;
from utils.helpers import my_function这种方式要求Python能从根目录(myproject)开始找到对应的模块,通常需要将根目录加入Python路径,或通过运行模块方式执行(如 python -m myproject.main)。
相对导入
相对导入是基于当前模块所在的包位置进行导入,使用点号(.)表示层级关系。它适用于包内部模块之间的调用。
仍在上面的例子中,如果在 views.py 中想导入同级的其他模块或上级包中的模块,可以这样写:
- from . import views —— 导入当前包内的模块
- from .views import my_view —— 导入当前包下的某个函数或类
- from ..utils.helpers import my_function —— 导入上一级包中的模块
- from ...core import config —— 导入上两级的模块(较少见)
注意:相对导入只能在包内部使用,不能用于顶层脚本直接运行。如果你尝试直接运行一个包含相对导入的文件(如 python app/views.py),会报错 Attempted relative import with no known parent package。
使用建议
虽然两种导入方式都能实现功能,但有几点值得注意:
- 优先使用绝对导入,因为它更清晰,便于理解和维护
- 当模块之间关系紧密且属于同一包时,相对导入可减少重复前缀,提高灵活性
- 避免混合使用两种导入方式,以免造成混乱
- 确保项目根目录在Python的模块搜索路径中,或使用 -m 参数运行模块
基本上就这些。掌握好绝对和相对导入,能让Python项目结构更清晰,模块协作更顺畅。











