详解Python中的相对导入和绝对导入


Posted in Python onJanuary 06, 2017

前言

Python 相对导入与绝对导入,这两个概念是相对于包内导入而言的。包内导入即是包内的模块导入包内部的模块。

Python import 的搜索路径

  1. 在当前目录下搜索该模块
  2. 在环境变量 PYTHONPATH 中指定的路径列表中依次搜索
  3. 在 Python 安装路径的 lib 库中搜索

Python import 的步骤

python 所有加载的模块信息都存放在 sys.modules 结构中,当 import 一个模块时,会按如下步骤来进行

  1. 如果是 import A,检查 sys.modules 中是否已经有 A,如果有则不加载,如果没有则为 A 创建 module 对象,并加载 A
  2. 如果是 from A import B,先为 A 创建 module 对象,再解析A,从中寻找B并填充到 A 的 __dict__

相对导入与绝对导入

绝对导入的格式为 import A.Bfrom A import B,相对导入格式为 from . import Bfrom ..A import B,.代表当前模块,..代表上层模块,...代表上上层模块,依次类推。

相对导入可以避免硬编码带来的维护问题,例如我们改了某一顶层包的名,那么其子包所有的导入就都不能用了。但是 存在相对导入语句的模块,不能直接运行,否则会有异常:

ValueError: Attempted relative import in non-package

这是什么原因呢?我们需要先来了解下导入模块时的一些规则:

在没有明确指定包结构的情况下,Python 是根据 __name__ 来决定一个模块在包中的结构的,如果是 __main__ 则它本身是顶层模块,没有包结构,如果是A.B.C 结构,那么顶层模块是 A。基本上遵循这样的原则:

  1. 如果是绝对导入,一个模块只能导入自身的子模块或和它的顶层模块同级别的模块及其子模块
  2. 如果是相对导入,一个模块必须有包结构且只能导入它的顶层模块内部的模块

如果一个模块被直接运行,则它自己为顶层模块,不存在层次结构,所以找不到其他的相对路径。

Python2.x 缺省为相对路径导入,Python3.x 缺省为绝对路径导入。绝对导入可以避免导入子包覆盖掉标准库模块(由于名字相同,发生冲突)。如果在 Python2.x 中要默认使用绝对导入,可以在文件开头加入如下语句:

from __future__ import absolute_import

from __future__ import absolute_import

这句 import 并不是指将所有的导入视为绝对导入,而是指禁用 implicit relative import(隐式相对导入), 但并不会禁掉 explicit relative import(显示相对导入)。

那么到底什么是隐式相对导入,什么又是显示的相对导入呢?我们来看一个例子,假设有如下包结构:

thing
├── books
│ ├── adventure.py
│ ├── history.py
│ ├── horror.py
│ ├── __init__.py
│ └── lovestory.py
├── furniture
│ ├── armchair.py
│ ├── bench.py
│ ├── __init__.py
│ ├── screen.py
│ └── stool.py
└── __init__.py

那么如果在 stool 中引用 bench,则有如下几种方式:

import bench     # 此为 implicit relative import
from . import bench   # 此为 explicit relative import
from furniture import bench # 此为 absolute import

隐式相对就是没有告诉解释器相对于谁,但默认相对与当前模块;而显示相对则明确告诉解释器相对于谁来导入。以上导入方式的第三种,才是官方推荐的,第一种是官方强烈不推荐的,Python3 中已经被废弃,这种方式只能用于导入 path 中的模块。

相对与绝对仅针对包内导入而言

最后再次强调,相对导入与绝对导入仅针对于包内导入而言,要不然本文所讨论的内容就没有意义。所谓的包,就是包含 __init__.py 文件的目录,该文件在包导入时会被首先执行,该文件可以为空,也可以在其中加入任意合法的 Python 代码。

相对导入可以避免硬编码,对于包的维护是友好的。绝对导入可以避免与标准库命名的冲突,实际上也不推荐自定义模块与标准库命令相同。

前面提到含有相对导入的模块不能被直接运行,实际上含有绝对导入的模块也不能被直接运行,会出现 ImportError:

ImportError: No module named XXX

这与绝对导入时是一样的原因。要运行包中包含绝对导入和相对导入的模块,可以用 python -m A.B.C 告诉解释器模块的层次结构。

有人可能会问:假如有两个模块 a.py 和 b.py 放在同一个目录下,为什么能在 b.py 中 import a 呢?

这是因为这两个文件所在的目录不是一个包,那么每一个 python 文件都是一个独立的、可以直接被其他模块导入的模块,就像你导入标准库一样,它们不存在相对导入和绝对导入的问题。相对导入与绝对导入仅用于包内部。

总结

以上就是这篇文章的全部内容了,希望本文的内容对大家学习或者使用python能有一定的帮助,如果有疑问大家可以留言交流。

Python 相关文章推荐
Python中使用partial改变方法默认参数实例
Apr 28 Python
PYTHON 中使用 GLOBAL引发的一系列问题
Oct 12 Python
django中的setting最佳配置小结
Nov 21 Python
Tensorflow 实现修改张量特定元素的值方法
Jul 30 Python
django session完成状态保持的方法
Nov 27 Python
python 画二维、三维点之间的线段实现方法
Jul 07 Python
python issubclass 和 isinstance函数
Jul 25 Python
解决Numpy中sum函数求和结果维度的问题
Dec 06 Python
python圣诞树编写实例详解
Feb 13 Python
python3.6环境下安装freetype库和基本使用方法(推荐)
May 10 Python
python将unicode和str互相转化的实现
May 11 Python
python基于爬虫+django,打造个性化API接口
Jan 21 Python
Python中取整的几种方法小结
Jan 06 #Python
Python正则表达式实现截取成对括号的方法
Jan 06 #Python
关于Python元祖,列表,字典,集合的比较
Jan 06 #Python
Python线程指南详细介绍
Jan 05 #Python
Python爬虫代理IP池实现方法
Jan 05 #Python
在 Python 应用中使用 MongoDB的方法
Jan 05 #Python
深入理解python对json的操作总结
Jan 05 #Python
You might like
php批量缩放图片的代码[ini参数控制]
2011/02/11 PHP
使用PHP实现密保卡功能实现代码<打包下载直接运行>
2011/10/09 PHP
Yii调试查看执行SQL语句的方法
2016/07/15 PHP
thinkPHP5框架auth权限控制类与用法示例
2018/06/12 PHP
laravel框架实现去掉URL中index.php的方法
2019/10/12 PHP
javaScript 数值型和字符串型之间的转换
2009/07/25 Javascript
js几个验证函数代码
2010/03/25 Javascript
突发奇想的一个jquery插件
2010/11/19 Javascript
jquery实现非叠加式的搜索框提示效果
2014/01/07 Javascript
javascript中2个感叹号的用法实例详解
2014/09/04 Javascript
Javascript基础教程之if条件语句
2015/01/18 Javascript
深入探究使JavaScript动画流畅的一些方法
2015/06/30 Javascript
JS实现淡蓝色简洁竖向Tab点击切换效果
2015/10/06 Javascript
基于jquery实现弹幕效果
2016/09/29 Javascript
Node.js模块全局安装路径配置方法
2018/05/17 Javascript
vue实现在一个方法执行完后执行另一个方法的示例
2018/08/25 Javascript
Node.js的进程管理的深入理解
2019/01/09 Javascript
js面试题之异步问题的深入理解
2020/09/20 Javascript
[15:57]教你分分钟做大人:斧王
2014/10/30 DOTA
Python实现的检测网站挂马程序
2014/11/30 Python
Python字符串逐字符或逐词反转方法
2015/05/21 Python
Python unittest模块用法实例分析
2018/05/25 Python
使用NumPy和pandas对CSV文件进行写操作的实例
2018/06/14 Python
python多进程实现文件下载传输功能
2018/07/28 Python
centos+nginx+uwsgi+Django实现IP+port访问服务器
2019/11/15 Python
python 实现图片上传接口开发 并生成可以访问的图片url
2019/12/18 Python
Python使用xlrd实现读取合并单元格
2020/07/09 Python
魔声耳机官方网站:Monster是世界第一品牌的高性能耳机
2016/10/26 全球购物
什么是URL
2015/12/13 面试题
2014年学习雷锋活动总结
2014/03/01 职场文书
乳制品整治工作方案
2014/05/29 职场文书
运输企业安全生产责任书
2014/07/28 职场文书
合作协议书格式
2014/08/19 职场文书
表扬稿范文
2015/01/17 职场文书
教师节领导致辞
2015/07/29 职场文书
《爬天都峰》教学反思
2016/02/23 职场文书