- 更多详情,可参考:
- 1、alex大王第5周博客:https://www.cnblogs.com/alex3714/articles/5161349.html
- 2、官方文档:http://www.pythondoc.com/pythontutorial3/modules.html
- 3、【笔记】Python3导入包规则:https://www.cnblogs.com/benpao1314/p/10302899.html
- 4、Python3包中的__init__.py:https://blog.csdn.net/qq_40877371/article/details/100013002
- 5、Python 3.x | 史上最详解的 导入(import):https://blog.csdn.net/weixin_38256474/article/details/81228492?utm_medium=distribute.pc_relevant.none-task-blog-2%7Edefault%7EBlogCommendFromBaidu%7Edefault-7.control&depth_1-utm_source=distribute.pc_relevant.none-task-blog-2%7Edefault%7EBlogCommendFromBaidu%7Edefault-7.control
- 6、Python模块导入机制与规范:https://zhuanlan.zhihu.com/p/259271603
- 7、Python 相对导入与绝对导入:http://kuanghy.github.io/2016/07/21/python-import-relative-and-absolute
- 8、Python包的相对导入时出现错误的解决方法:https://www.cnblogs.com/ArsenalfanInECNU/p/5346751.html
一、定义
1、模块定义
- 用来从逻辑上组织python代码,定义变量、函数、类、逻辑,并实现特定功能,其本质就是以.py结尾的python文件
- 举例:
文件名为test.py,此时对应的模块名为test,import时只需要写模块名即可,不需要写模块名.py
2、包定义
- 用来从逻辑上组织模块的,本质就是一个目录(必须带有一个__init__.py文件)
二、模块/包导入方法
1、模块导入方法(导入模块和程序在同级目录下时)
- 导入模块的本质就是把python文件解释一遍
- import module_name
- import module_name1, module_name2
- from package_name import module_name
- from module_name import 方法名/变量
- from module_name import 方法名/变量 as 自定义名称
- from module_name import *(不推荐使用)
2、模块导入后,调用方法
1. 直接import模块名时,模块内"方法/变量"调用方法
模块导入方法:
- import module_name
- import module_name1, module_name2
- from package_name import module_name
模块内"方法/变量"_调用方法:
- module_name.方法名()
2. from 模块名 import 方法时,模块内"方法/变量"调用方法
模块导入方法:
- from module_name import 方法名/变量
- from module_name import 方法名/变量 as 自定义名称
- from module_name import *(不推荐使用)
模块内"方法/变量"_调用方法:
- 方法名()
3、包导入方法(导入包和程序在同级目录下时)
1. 包导入方法
- 导入一个包,本质上是执行对应包目录下的__init__.py文件
- import 包名
- from 包名 import 子包名
2. 包导入后,调用方法
1)直接使用绝对路径/相对路径导入包中模块时
包内模块的"方法/变量"_调用方法:
- 实际导入模块名.方法名()
2)在包中__init__.py文件中,import 模块名时
- import模块名方法有2种:
from . import 模块名
import 模块名(前提是要在__init__.py文件中,import模块名前,在sys.path中补充好所需导入包的父目录绝对路径)
包内模块的"方法/变量"_调用方法:
- 包名.模块名.方法名()
三、import导入优化(推荐使用如下方式)
- from 模块名 import 方法名,会省去反复检索模块的消耗
四、(重点)绝对路径导入和相对路径导入
1、绝对路径导入
- 绝对路径导入时,需要看当前sys.path中是否存在所需导入包的父目录,
- 如果有 >>> 则直接import即可
- 如果没有 >>> 需要在sys.path中添加所需导入包的父目录绝对路径
- 附:需要注意sys.path为列表,且路径搜索时,按照从下标0处开始搜索,如果必须保障新添加路径生效,需要sys.path.insert(0, “所需导入包的父目录绝对路径”)进行添加,而不是使用sys.path.append(“所需导入包的父目录绝对路径”)将路径添加到最后
- sys.path中默认包含执行程序父目录(绝对路径)+项目根目录(绝对路径)
- 可以直接import test_package目录下的package1/package2包
- 可以直接s14_python3目录下的string_learning.py/set_learning.py等模块
2、相对路径导入
- SystemError: Parent module ‘’ not loaded, cannot perform relative import
- ValueError: attempted relative import beyond top-level package
- 报错解析:
- 其实这两个错误的原因归根结底是一样的:
在涉及到相对导入时,package所对应的文件夹必须正确的被python解释器视作package,而不是普通文件夹。否则由于不被视作package,无法利用package之间的嵌套关系实现python中包的相对导入。 - 文件夹被python解释器视作package需要满足两个条件:
1、文件夹中必须有__init__.py文件,该文件可以为空,但必须存在该文件。
2、不能作为顶层模块来执行该文件夹中的py文件(即不能作为主函数的入口)。
3、补充:在"from YY import XX"这样的代码中,无论是XX还是YY,只要被python解释器视作package,就会首先调用该package的__init__.py文件。如果都是package,则调用顺序是YY,XX。
4、另外,练习中“from . import XXX”和“from … import XXX”中的’.‘和’…’,可以等同于linux里的shell中’.‘和’…'的作用,表示当前工作目录的package和上一级的package。
五、模块的分类
- 标准库
- 开源模块(第三方模块)
- 自定义模块