python的相对导入和绝对导入-小白教程（ModuleNotFoundError & attempted relative import beyond top-level package）

最新推荐文章于 2025-05-16 10:59:33 发布

原创

最新推荐文章于 2025-05-16 10:59:33 发布 · 1.2k 阅读

7 ·

CC 4.0 BY-SA版权

文章标签：

#python #相对导入 #绝对导入 #top-level package

本文通过实例讲解Python的相对导入和绝对导入，解析ModuleNotFoundError和attempted relative import beyond top-level package错误。通过创建Import项目，展示了不同场景下运行python文件时导入模块的方式，包括在项目根目录和子目录下运行，分析了相对导入与绝对导入的适用情况，提供了在不同项目结构中选择导入方式的建议。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

我的个人网站：https://www.gentlecp.com

前言

在运行python项目的时候，你是否遇到过这样的问题（ModuleNotFoundError）：
在这里插入图片描述
又或者是这样的问题（attempted relative import beyond top-level package）：

其实这些问题都涉及到了python的导入机制，关于第一类问题，可以阅读我的这篇博客-python的import机制当然我建议你看完import机制之后再回过头将本篇文章完整看完，相信我，你会有不一样的收获。

实际案例

为了能更直观地理解，我们创建一个Import的python项目，并在其中创建目录结构如下：

Import
	|--A
		|--D
			|--d.py
		|--E
			|--e.py
		|--a.py
	|--B
		|--b.py
	|--C
		|--c.py
	|--main.py  # 项目入口

其中A，B，C，D均为目录，a.py, b.py, c.py, d.py 都是一个简单python文件，每个文件中有一个对应的hello函数，用于打印对应的hello信息，例如a.py 中：
在这里插入图片描述
其他的就是将a换成对应字母。
我们从实际项目开发出发，一般项目开发中有多级目录，我们已经实现了，在项目本身根目录下会有一个入口文件(main.py)，他用于调用其他模块的文件达到执行整个项目的目的。

项目根目录下运行

我们在main.py中写入如下代码，并运行查看结果（为了体现ide的特殊之处，后面的运行结果如果不一样，我会展示ide和终端运行两种结果，原因你在看过python的import机制就会明白）：

"""
项目的入口，用于调用其他模块，运行整个项目
"""
from A import a
from B import b
from C import c

if __name__ == '__main__':
    a.hello_a()
    b.hello_b()
    c.hello_c<