Python多级包引用详解：相对导入与绝对导入的陷阱及解决方案

Python包与模块基础概念

首先必须厘清Python中包（Package）与模块（Module）的基本概念。

• 包的定义：若某个目录下包含__init__.py文件，则该目录被视为一个包。
• 模块的定义：任何一个独立的.py文件即构成一个模块。

引入方式：既可以通过from 包 import 模块的方式引入整个Python文件，也可以采用from 包.模块 import 具体函数或类的方式直接调用模块内的特定组件。

多级包的标准导入方式

具体案例如下。假设当前项目存在如下目录结构：

若需在main.py中调用package_a和package_b内的模块，可按照以下代码实现：

from package_a import tmp2
from package_b import tmp4

tmp2.test_aTmp2()
tmp4.test_bTmp4()

其中test_aTmp2()和test_bTmp4()分别对应tmp2.py和tmp4.py文件中定义的函数。

• 此处展示package_a包中tmp2模块下的test_aTmp2函数定义。
• 此处展示package_b包中tmp4模块下的test_bTmp4函数定义。

进一步假设，若需在main.py中调用a_utils包下的aUtils模块以及b_utils包下的bUtils模块，代码应编写为：

from package_a import tmp2
from package_b import tmp4
from package_b.b_utils.bUtils import test_bUtils
from package_a.a_utils import aUtils

tmp2.test_aTmp2()
tmp4.test_bTmp4()
aUtils.test_aUtils()
test_bUtils()

请注意这里涉及的两种不同导入用法：

• 第一种是直接通过from 包.子包.模块 import 函数语句进行导入。
• 第二种是先执行from 包.子包 import 模块，随后通过 模块.函数 的形式来调用相关功能。

运行结果将依次输出：package_a包中tmp2模块下的test_aTmp2函数内容、package_b包中tmp4模块下的test_bTmp4函数内容、package_a包中a_utils包中aUtils模块下的test_aUtils函数内容，以及package_b包中b_utils包中bUtils模块下的test_bUtils函数内容。

子模块间调用的常见错误

接下来，假设需要在tmp4.py内部调用同属一个包的tmp3.py中的函数，常规做法如下：

from tmp3 import test_bTmp3
test_bTmps3()

def test_bTmp4():
    print('这里是package_b包中tmp4模块下的test_bTmp4函数')

同时，我们在tmp4.py中继续调用b_utils包下的bUtils.py模块。

from tmp3 import test_bTmp3
from b_utils.bUtils import test_bUtils

def test_bTmp4():
    print('这里是package_b包中tmp4模块下的test_bTmp4函数')

# test_bUtils()
test_bTmp3()
test_bUtils()

此时tmp4.py的内容包含对package_b包中tmp3模块下test_bTmp3函数的调用，以及对package_b包中b_utils包下bUtils模块中test_bUtils函数的调用。若此时重新运行之前的main.py：

from package_a import tmp2
from package_b import tmp4
from package_b.b_utils.bUtils import test_bUtils
from package_a.a_utils import aUtils

tmp2.test_aTmp2()
tmp4.test_bTmp4()
aUtils.test_aUtils()
test_bUtils()

程序将抛出错误，具体报错信息如下：

Traceback (most recent call last): File "C:/Users/龚鸥波/Desktop/test_import/main.py", line 2, in <module> from package_b import tmp4 File "C:\Users\龚鸥波\Desktop\test_import\package_b\tmp4.py", line 8, in <module> from tmp3 import test_bTmp3 ModuleNotFoundError: No module named 'tmp3'

相对导入与直接运行的冲突解决

在main.py中导入tmp4后，tmp4内部尝试调用tmp3。直接运行tmp4.py时正常，但通过main.py运行时却报错。原因在于，相对于main.py所在的根目录，tmp3位于子包package_b内部，在tmp4中直接使用绝对路径导入无法识别。需将导入语句修改为相对导入形式：

from .tmp3 import test_bTmp3
from .b_utils.bUtils import test_bUtils

def test_bTmp4():
    print('这里是package_b包中tmp4模块下的test_bTmp4函数')

test_bTmp3()
test_bUtils()

修改后再次运行main.py，错误得以解决：

此时运行main.py的输出包括：package_b包中tmp3模块下的test_bTmp3函数内容、package_b包中b_utils包中bUtils模块下的test_bUtils函数内容、package_a包中tmp2模块下的test_aTmp2函数内容、package_b包中tmp4模块下的test_bTmp4函数内容、package_a包中a_utils包中aUtils模块下的test_aUtils函数内容，以及package_b包中b_utils包中bUtils模块下的test_bUtils函数内容。

然而，若此时直接重新运行tmp4.py文件，程序将再次报错：

Traceback (most recent call last): File "C:/Users/龚鸥波/Desktop/test_import/package_b/tmp4.py", line 8, in <module> from .tmp3 import test_bTmp3 ModuleNotFoundError: No module named '__main__.tmp3'; '__main__' is not a package

这里的点号（.）代表当前模块作为__main__运行，这通常发生在直接执行脚本时。虽然具体机制复杂，但可以通过以下代码结构进行兼容处理：

try:
    from tmp3 import test_bTmp3
    from b_utils.bUtils import test_bUtils
except Exception as e:
    from .tmp3 import test_bTmp3
    from .b_utils.bUtils import test_bUtils

def test_bTmp4():
    print('这里是package_b包中tmp4模块下的test_bTmp4函数')

test_bTmp3()
test_bUtils()

采用这种写法后，无论直接运行main.py还是单独运行tmp4.py，均不会报错。

以上总结自实际项目构建过程中遇到的典型问题。

至此，关于Python多级包引用问题的详解介绍完毕。如需了解更多Python多级包引用相关内容，请查阅本站过往文章或继续浏览后续教程，感谢大家的支持！