Python 用相对名称来导入包中的子模块

文章目录

需求

我们将代码组织成了一个包,想从其中一个子模块中导入另一个子模块,但是又不希望在import语句中硬编码包的名称

方案

要在软件包的子模块中导入同一个包中其他的子模块,请使用相对名称来导入。例如,假设有一个名为mypackage的包,它在文件系统上组织成如下的形式:

python 复制代码
mypackage/ 
	__init__.py     
	A/ 
		__init__.py         
		spam.py 
		grok.py     
	B/ 
		__init__.py
	    bar.py
  1. 如果模块mypackage.A.spam希望导入位于同一个目录中的模块grok,那么它应该包含一条这样的import语句:# mypackage/A/spam.pyfrom . import grok
  2. 如果模块mypackage.A.spam希望导入位于不同目录中的模块B.bar,可以使用下面的import语句来完成:# mypackage/A/spam.pyfrom ...B import bar

讨论

在包的内部,要在其中一个子模块中导入同一个包中其他的子模块,既可以通过给出完整的绝对名称,也可以通过上面示例中采用的相对名称来完成导入。示例如下:

python 复制代码
 # mypackage/A/spam.py
from mypackage.A import grok    # OK
from . import grok              # OK
import     grok                 # Error (not found)

绝对路径缺点

使用绝对名称的缺点在于这么做会将最顶层的包名称硬编码到源代码中,这使得代码更加脆弱,如果想重新组织一下结构会比较困难。例如,如果修改了包的名称,将不得不搜索所有的源代码文件并修改硬编码的名称。类似地,硬编码名称使得其他人很难移动这部分代码。例如,也许有人想安装两个不同版本的包,只通过名字来区分它们。如果采用相对名称导入,那么不会有任何问题,但是采用绝对名称导入则会使程序崩溃。

import语句中的.和...语法可能看起来比较有趣,把它们想象成指定目录名即可。.意味着在当前目录中查找,而...B表示在.../B目录中查找。这种语法只能用在from xx import yy这样的导入语句中。示例如下:

python 复制代码
from . import grok     # OK
import .grok           # ERROR

注意事项

相对路径导入不能跳出定义包的目录

尽管看起来似乎可以利用相对导入来访问整个文件系统,但实际上是不允许跳出定义包的那个目录的。也就是说,利用句点的组合形式进入一个不是Python包的目录会使得导入出现错误

在 Python 中,位于脚本顶层目录的模块(即直接运行的脚本)不能使用相对导入。

这是因为相对导入是基于包结构工作的,而直接运行的脚本不被视为包的一部分。

解释:

  1. 相对导入是为了在包内部的模块之间进行导入设计的。
  2. 当你直接运行一个 Python 脚本时,Python 会将该脚本的 __name__ 设置为 '__main__'
  3. 相对导入需要知道当前模块在包结构中的位置,但直接运行的脚本没有这个上下文信息。

代码示例:

假设我们有以下目录结构:

project/
│
├── main.py
├── package/
│   ├── __init__.py
│   ├── module1.py
│   └── module2.py
  1. 错误示例(在 main.py 中使用相对导入):
python 复制代码
# main.py
from .package import module1  # 这将引发错误

def main():
    module1.some_function()

if __name__ == "__main__":
    main()

运行 python main.py 会得到类似这样的错误:

ValueError: attempted relative import beyond top-level package
  1. 正确示例(在 package/module2.py 中使用相对导入):
python 复制代码
# package/module2.py
from . import module1  # 这是正确的相对导入

def some_function():
    module1.some_other_function()
  1. 主脚本中的正确做法:
python 复制代码
# main.py
from package import module1  # 使用绝对导入

def main():
    module1.some_function()

if __name__ == "__main__":
    main()

解决方法:

  1. 在主脚本中使用绝对导入。
  2. 将你的代码组织成一个适当的包结构,并使用 -m 选项运行你的脚本,例如:python -m package.main
  3. 使用 sys.path 修改 Python 的模块搜索路径(不推荐,除非必要)。

总结:直接运行的脚本应该使用绝对导入,而相对导入应该保留给包内部的模块使用。这有助于保持代码的清晰性和可移植性。

相关推荐
Suyuoa1 分钟前
附录2-pytorch yolov5目标检测
python·深度学习·yolo
I_Am_Me_11 分钟前
【JavaEE进阶】 JavaScript
开发语言·javascript·ecmascript
重生之我是数学王子21 分钟前
QT基础 编码问题 定时器 事件 绘图事件 keyPressEvent QT5.12.3环境 C++实现
开发语言·c++·qt
Ai 编码助手23 分钟前
使用php和Xunsearch提升音乐网站的歌曲搜索效果
开发语言·php
学习前端的小z27 分钟前
【前端】深入理解 JavaScript 逻辑运算符的优先级与短路求值机制
开发语言·前端·javascript
神仙别闹34 分钟前
基于C#和Sql Server 2008实现的(WinForm)订单生成系统
开发语言·c#
XINGTECODE35 分钟前
海盗王集成网关和商城服务端功能golang版
开发语言·后端·golang
zwjapple1 小时前
typescript里面正则的使用
开发语言·javascript·正则表达式
小五Five1 小时前
TypeScript项目中Axios的封装
开发语言·前端·javascript
前端每日三省1 小时前
面试题-TS(八):什么是装饰器(decorators)?如何在 TypeScript 中使用它们?
开发语言·前端·javascript