Python包的相对导入问题

当在Python中进行包的相对导入时,需要确保目录包含__init__.py文件并避免作为顶级模块执行。错误通常源于目录未被视为package。正确的导入依赖于包的结构,每个包及其子包都需要__init__.py。可以通过调整目录结构或使用`-m`参数来解决导入问题。

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

python脚本的package相对导入时,常见两种写法:
from . import XXX
from .. import XXX
但有时会出现这样的错误:
SystemError: Parent module '' not loaded, cannot perform relative import
ValueError: attempted relative import beyond top-level package
二者的问题是一样的,都是目录被视为package时的解释错误。

相对导入时,package所对应的文件夹必须正确的被python解释器视作package,而不是普通文件夹。否则由于不被视作package,无法利用package之间的嵌套关系实现python中包的相对导入。

文件夹被python解释器视作package需要满足两个条件:

  1. 该文件夹中必须有__init__.py文件,它可以为空,但必须存在
  2. 该文件夹不能作为顶层模块来执行文件夹中的py文件 (即不能作为主函数的入口)

附:在from YY import XX中,无论是XX还是YY,只要被python解释器视作package(文件夹or脚本文件都可成为package),就会首先调用该package的__init__.py文件。如果都是package,则调用顺序是YY,XX。

举例说明:
目录树

test/
 --__init__.py
 --main.py : from . import module
 --main1.py : from sub1 import sub11
 --main2.py : from sub1 import sub13
 --main3.py : from sub2 import sub21
 --module.py
 --sub1/
   --__init__.py : 
   --sub11.py : from . import sub12
   --sub13.py : from .. import sub21
   --sub12.py
 --sub2/
   --sub21.py

[sjy@clylab test]$python3 main.py 报错,违反条件2,test不能被视为package,module无法导入
[sjy@clylab test]$python3 main1.py 正确,sub1和sub11都是package
[sjy@clylab test]$python3 main2.py 报错,违反条件2,sub1和sub13是package,但因为test不是package,sub21无法导入
[sjy@clylab test]$python3 main3.py 报错,违反条件1,sub2不是package

[sjy@clylab sub1]$python3 sub11.py 报错,sub1不能被视为package,sub12无法导入
[sjy@clylab sub1]$python3 sub13.py 报错,sub1和test都不是package


一种方法是更改目录树:

parent/
	--main.py : from test import module
	--main2.py : from test.sub1 import sub13
	--main3.py : from test.sub2 import sub21
	--test/
		--__init__.py
	 	--main1.py : from sub1 import sub11
	 	--module.py
		--sub1/
	 		--__init__.py : 
	 		--sub11.py : from . import sub12
	 		--sub13.py : from .. import sub21
	 		--sub12.py
		--sub2/
			--__init__.py : 
	 		--sub21.py

在parent目录下前4条能运行,后2条在test目录下能运行。


另一种方法是利用python的-m参数:
[sjy@clylab test]$python3 -m main

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值