Python 相对导入笔记（from . import * ,from .. import *）

最新推荐文章于 2025-10-28 00:19:19 发布

原创最新推荐文章于 2025-10-28 00:19:19 发布 · 895 阅读

1 ·

CC 4.0 BY-SA版权

文章标签：

#python

Python 专栏收录该内容

11 篇文章

订阅专栏

测试环境：python3.6 ，win10

测试Python的相对导入，目录结构如下：

最顶层的文件夹是pythonpackagetest ，包含包A和B，其中包A中进一步含包A_A

在pythonpackagetest文件夹下运行python app.py 运行成功

注意：我在pythonpackagetest执行python app.py 代表文件夹内的A的完整包名是 A，文件夹B的完整包名是B ，文件夹A_A的完整包名是A.A_A，无论你是否在pythonpackagetest下创建__init__.py都不影响

>>import sys

>>sys.path[0] 可以获得当前的工作目录，执行python app.py 那么当前的工作目录是pythonpackagetest，如果你在pythonpackagetest下执行python .\A\test.py 那么那么当前的工作目录是pythonpackagetest\A

import module_name or package Python会几个地方寻找这个模块，第一是sys.path。第二就是运行文件所在的目录（工作目录）

使用python xx.py 执行是使用绝对路径，表示从当前工作目录作为顶层目录执行，所以xx.py中能导入的包是在顶层目录下能看到的，而from . import * ,from .. import * 这样的包导入方式一定是用在包中，存在这种方式的文件不能用python xx.py的方式来执行，如果需要调试执行一个包使用python -m XX.YY 的方式运行，例子见下面执行a3.py

（1）文件app.py的内容如下：

import A.a as Aa
import B.b as Bb
import A.A_A.a3
import sys
print(sys.path)
print(__package__)

文件a3.py如下：

from .. import a2

print("A_A_a3")

注意：此处from .. import a2 可以导入成功的原因是a3.py的包完整表达是A.A_A 所以 .. 号代表当前A.A_A包的上一层及A ，表示从包A导入模块a2

a3.py 中from .. import a2的相对导入，这种文件一定属于包，所以在est.文件夹下运行python .\A\A_A\a3.py是不会成功的，报错：ValueError: attempted relative import beyond top-level package，

调试包要是使用下面的命令:

python -m A.A_A.a3 其中A.A_A.a3是a3.py的完整模块名，这也说明a3.py的所属的完整包名是A.A_A

那么如果在文件夹pythonpackagetest\A下执行python -m A_A.a3 会不会成功呢，答案是不会成功，报错：

ValueError: attempted relative import beyond top-level package

原因是在pythonpackagetest\A下执行python -m A_A.a3 代表文件a3的完整包名变成了A_A 而A_A的上层是没有包的，因为工作路径就是pythonpackagetest\A这变成了顶层目录

文件a.py内容如下：

from .   import a2
print(__package__)
# from ..B import b
class  A1():
    def show(self):
        print("A_A1_show")

注意：此处from . import a2 可以导入成功的原因是a.py的包是A 所以 . 号代表当前包A ，表示从当前包A导入模块a2

而注释中的# from ..B import b 导入b是不会成功的因为包A的 .. 上一层没有包，所以会报顶层包之类的错误

ValueError: attempted relative import beyond top-level package

其他文件内容为空

注意：发现如果没有特殊需要包内的__init__.py是否定义对测试没有任何影响，因为测试的__init__.py内容都是空

结束