解析Python3中的Import


Posted in Python onOctober 13, 2019

Python import的搜索路径

import的搜索路径为:

  • 搜索「内置模块」(built-in module)
  • 搜索 sys.path 中的路径
  • 而sys.path在初始化时,又会按照顺序添加以下路径:

foo.py 所在目录(如果是软链接,那么是真正的 foo.py 所在目录)或当前目录;

环境变量 PYTHONPATH中列出的目录(类似环境变量 PATH,由用户定义,默认为空);
site 模块被 import 时添加的路径1(site 会在运行时被自动 import)。

import site 所添加的路径一般是 XXX/site-packages。如果懒得记 sys.path 的初始化过程,可以简单的认为 import 的查找顺序是:

内置模块

.py 文件所在目录
pip 或 easy_install 安装的包

绝对导入和相对导入

绝对导入和相对导入的关系可以类比绝对路径和相对路径。

绝对导入的格式为:

import A.B
或
from A import B

相对导入格式为:

from . import B
或
from ..A import B

其中,点号.代表当前模块,..代表上层模块,…代表上上层模块,依次类推。

模块的执行方式

模块的执行可以有两种方式:直接执行和以模块执行,即:

python example/foo.py
或
python -m example.foo

注意,以模块执行时,一定要有包的概念,即example一定是个包,而foo是这个包下的模块,这样才能顺利执行。

包和模块

模块: 一个 .py 文件就是一个模块(module)

包: init .py 文件所在目录就是包(package)

各种情形测试

模块直接导入

即模块所在的目录都不是一个包结构,各个模块都是独立的,比如以下的目录结构:

D:\LEARN\IMPORT_TEST\TEST1
├─pack1
│  modu1.py
└─pack2
  modu2.py

modu1.py中的内容为:

import sys
sys.path.append("D:\\learn\\import_test\\TEST1\\pack2")
from modu2 import hello2
hello2()

modu2.py中的内容为:

def hello2():
 print("hello, I am module 2")

注意在modu1中一定加上sys.path.append那部分内容,即根据上面的描述,一定要让modu1能找到modu2才行,否则就会出现如下错误:

ModuleNotFoundError: No module named 'modu2'

此时进入pack1目录下,以直接执行或模块执行的方式都可以顺利输出。

包外导入

将上面两个模块所在的目录都变为包结构,即:

D:\LEARN\IMPORT_TEST\TEST2
├─pack1
│  modu1.py
│  __init__.py
└─pack2
  modu2.py
  __init__.py

此时也能顺利执行,同时比上面非包结构的多出来一条执行方式,即:

python -m pack1.modu1

即以包名+模块名的方式执行。

上面两种情形,即模块与模块、包与包都是相互独立的关系,也就没有相对导入的意义。

如果是在一个包内的不同模块的导入,那么最自然的就是使用相对导入。

包内相对导入

D:\LEARN\IMPORT_TEST\Test3
│ __init__.py
│
├─pack1
│  modu1.py
│  __init__.py
│
└─pack2
  modu2.py
  __init__.py

此时modu1.py中的内容为:

from ..pack2.modu2 import hello2
hello2()

即将sys.path.append去掉,因为是在一个包内相互引用,此时这样写没有意义。

此时正确运行的方式是进入Test3上一层的文件夹,然后:

python -m Test3.pack1.modu1

即明确地告诉解释器模块的层次结构。

而如果采用直接运行的方式,比如:

python Test3\pack1\modu1.py

就会报如下错误:

ValueError: attempted relative import beyond top-level package

这是因为,相对导入使用模块的 name (这里的name和下面的main都是有两个下划线的,但是网页显示不出来。。)属性来决定模块在包结构中的位置。当 name 属性不包含包信息(i.e. 没有用'.'表示的层次结构,比如' main ‘),则相对导入将模块解析为顶层模块,而不管模块在文件系统中的实际位置。这里模块被直接运行,则它自己为顶层模块,不存在层次结构,所以找不到其他的相对路径。

因此,直接运行带有相对导入的模块是不行的,需要通过模块运行的方式,将包结构明确告诉它才行。

这个原理也适用于下面这种错误,比如将modu2移动到pack1中,即与modu1在同一个目录下,然后将modu1的内容改为这样的相对引用:

from .modu2 import hello2
hello2()

此时使用模块执行的方式没有问题,如果还是想尝试直接运行,那么就会出现:

ModuleNotFoundError: No module named '__main__.modu2'; '__main__' is not a package

原因就是此时没有包结构, main 也不是个包。

那么解决方法就是或者使用模块运行的方式运行,或者将它改成下面的绝对导入的方式就可以直接运行。

包内绝对导入

那么,如果将modu1.py中的内容改为绝对导入,即:

from Test3.pack2.modu2 import hello2
hello2()

此时正确运行方式也是进入Test3上一层文件夹,然后使用模块执行的方式运行:

python -m Test3.pack1.modu1

如果此时采用直接运行的方式:

python Test3\pack1\modu1.py

那么就会报错:

ModuleNotFoundError: No module named 'Test3'

这主要是因为Test3没有被找到,即按照第一部分所说,Test3没有在import的搜索路径中。所以,只要将它加入进去即可,比如:

set PYTHONPATH=D:\learn\import_test\

此时再直接运行就没有问题了。

总结

以上所述是小编给大家介绍的Python3中的Import理解,希望对大家有所帮助!

Python 相关文章推荐
使用Python编写基于DHT协议的BT资源爬虫
Mar 19 Python
PyQt5打开文件对话框QFileDialog实例代码
Feb 07 Python
Python入门Anaconda和Pycharm的安装和配置详解
Jul 16 Python
python判断一个对象是否可迭代的例子
Jul 22 Python
django 实现将本地图片存入数据库,并能显示在web上的示例
Aug 07 Python
使用virtualenv创建Python环境及PyQT5环境配置的方法
Sep 10 Python
PyCharm如何导入python项目的方法
Feb 06 Python
python调用HEG工具批量处理MODIS数据的方法及注意事项
Feb 18 Python
Python configparser模块配置文件过程解析
Mar 03 Python
浅谈Python中的继承
Jun 19 Python
python 实现的截屏工具
May 08 Python
Python的代理类实现,控制访问和修改属性的权限你都了解吗
Mar 21 Python
Python英文文章词频统计(14份剑桥真题词频统计)
Oct 13 #Python
Python 转换RGB颜色值的示例代码
Oct 13 #Python
Django中自定义查询对象的具体使用
Oct 13 #Python
PyCharm导入python项目并配置虚拟环境的教程详解
Oct 13 #Python
Python 用三行代码提取PDF表格数据
Oct 13 #Python
Python3离线安装Requests模块问题
Oct 13 #Python
详解使用Python下载文件的几种方法
Oct 13 #Python
You might like
一漂亮的PHP图片验证码实例
2014/03/21 PHP
PHP使用array_fill定义多维数组的方法
2015/03/18 PHP
WordPress中邮件的一些修改和自定义技巧
2015/12/15 PHP
php获取微信基础接口凭证Access_token
2018/08/23 PHP
PHP面向对象程序设计之接口的继承定义与用法详解
2018/12/20 PHP
thinkphp框架类库扩展操作示例
2019/11/26 PHP
PHP safe_mode开启对于PHP系统函数有什么影响
2020/11/10 PHP
js捕获鼠标滚轮事件代码
2013/12/16 Javascript
JavaScript获取各大浏览器信息图示
2015/11/20 Javascript
使用jQuery实现一个类似GridView的编辑,更新,取消和删除的功能
2017/03/15 Javascript
微信小程序 跳转方式总结
2017/04/20 Javascript
JavaScript事件冒泡与事件捕获实例分析
2018/08/01 Javascript
vue实现输入框的模糊查询的示例代码(节流函数的应用场景)
2019/09/01 Javascript
Weex开发之地图篇的具体使用
2019/10/16 Javascript
JS PHP字符串截取函数实现原理解析
2020/08/29 Javascript
[01:05:12]2014 DOTA2国际邀请赛中国区预选赛 TongFu VS CIS-GAME
2014/05/21 DOTA
Flask SQLAlchemy一对一,一对多的使用方法实践
2013/02/10 Python
Python常见数据结构详解
2014/07/24 Python
Python编程中装饰器的使用示例解析
2016/06/20 Python
Python sqlite3事务处理方法实例分析
2017/06/19 Python
详解Python做一个名片管理系统
2019/03/14 Python
Python创建或生成列表的操作方法
2019/06/19 Python
pytorch中的embedding词向量的使用方法
2019/08/18 Python
Python MongoDB 插入数据时已存在则不执行,不存在则插入的解决方法
2019/09/24 Python
关于numpy数组轴的使用详解
2019/12/05 Python
python 中的paramiko模块简介及安装过程
2020/02/29 Python
Django中和时区相关的安全问题详解
2020/10/12 Python
最畅销的视频游戏享受高达90%的折扣:CDKeys
2020/02/10 全球购物
职业教育毕业生求职信
2013/11/09 职场文书
电视节目策划方案
2014/05/16 职场文书
个人批评与自我批评发言稿
2014/09/28 职场文书
法定代表人授权委托书范本
2014/10/07 职场文书
铁人观后感
2015/06/16 职场文书
Python机器学习之KNN近邻算法
2021/05/14 Python
ztree+ajax实现文件树下载功能
2021/05/18 Javascript
python DataFrame中stack()方法、unstack()方法和pivot()方法浅析
2022/04/06 Python