详解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实现的爬取百度文库功能示例
Feb 16 Python
Python3多线程基础知识点
Feb 19 Python
python绘制漏斗图步骤详解
Mar 04 Python
python+opencv实现摄像头调用的方法
Jun 22 Python
Python列表对象实现原理详解
Jul 01 Python
python 画二维、三维点之间的线段实现方法
Jul 07 Python
Python读写文件模式和文件对象方法实例详解
Sep 17 Python
Python爬虫解析网页的4种方式实例及原理解析
Dec 30 Python
详解Pycharm出现out of memory的终极解决方法
Mar 03 Python
Python连接Hadoop数据中遇到的各种坑(汇总)
Apr 14 Python
python环境搭建和pycharm的安装配置及汉化详细教程(零基础小白版)
Aug 19 Python
基于Django集成CAS实现流程详解
Nov 28 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 采集程序原理分析篇
2010/03/05 PHP
PHP关联数组的10个操作技巧
2013/01/21 PHP
php GUID生成函数和类
2014/03/10 PHP
php+mysql结合Ajax实现点赞功能完整实例
2015/01/30 PHP
PHP SPL标准库中的常用函数介绍
2015/05/11 PHP
php fseek函数读取大文件两种方法
2016/10/12 PHP
ThinkPHP实现图片上传操作的方法详解
2017/05/08 PHP
无语,javascript居然支持中文(unicode)编程!
2007/04/12 Javascript
jQuery chili图片远处放大插件
2009/11/30 Javascript
JavaScript调用堆栈及setTimeout使用方法深入剖析
2013/02/16 Javascript
3分钟写出来的Jquery版checkbox全选反选功能
2013/10/23 Javascript
纯JavaScript基于notie.js插件实现消息提示特效
2016/01/18 Javascript
JS实现关闭当前页而不弹出提示框的方法
2016/06/22 Javascript
Angular JS 生成动态二维码的方法
2017/02/23 Javascript
微信小程序 新建登录页并实现tabBar隐藏
2017/06/13 Javascript
JS实现合并json对象的方法
2017/10/10 Javascript
jQuery中过滤器的基本用法示例
2017/10/11 jQuery
Vue框架之goods组件开发详解
2018/01/25 Javascript
理解 JavaScript EventEmitter
2018/03/29 Javascript
JavaScript创建表格的方法
2020/04/13 Javascript
django批量导入xml数据
2016/10/16 Python
Python实现自动发送邮件功能
2021/03/02 Python
python实现员工管理系统
2018/01/11 Python
Django中Model的使用方法教程
2018/03/07 Python
python实现三次样条插值
2018/12/17 Python
django框架使用orm实现批量更新数据的方法
2019/06/21 Python
一篇文章弄懂Python中所有数组数据类型
2019/06/23 Python
Django使用消息提示简单的弹出个对话框实例
2019/11/15 Python
python GUI库图形界面开发之PyQt5树形结构控件QTreeWidget详细使用方法与实例
2020/03/02 Python
党员大会主持词
2014/04/02 职场文书
《傅雷家书》教学反思
2014/04/20 职场文书
《认识年月日》教学反思
2016/02/19 职场文书
2016年社区文体活动总结
2016/04/06 职场文书
Ajax 的初步实现(使用vscode+node.js+express框架)
2021/06/18 Javascript
详解JS数组方法
2021/11/20 Javascript
Java Spring Boot请求方式与请求映射过程分析
2022/06/25 Java/Android