浅谈Python __init__.py的作用


Posted in Python onOctober 28, 2020

我们经常在python的模块目录中会看到 "__init__.py"  这个文件,那么它到底有什么作用呢?

1. 标识该目录是一个python的模块包(module package)

如果你是使用python的相关IDE来进行开发,那么如果目录中存在该文件,该目录就会被识别为 module package 。

2. 简化模块导入操作

假设我们的模块包的目录结构如下:

.
└── mypackage
  ├── subpackage_1
  │  ├── test11.py
  │  └── test12.py
  ├── subpackage_2
  │  ├── test21.py
  │  └── test22.py
  └── subpackage_3
    ├── test31.py
    └── test32.py

如果我们使用最直接的导入方式,将整个文件拷贝到工程目录下,然后直接导入:

from mypackage.subpackage_1 import test11
from mypackage.subpackage_1 import test12
from mypackage.subpackage_2 import test21
from mypackage.subpackage_2 import test22
from mypackage.subpackage_3 import test31
from mypackage.subpackage_3 import test32

当然这个例子里面文件比较少,如果模块比较大,目录比较深的话,可能自己都记不清该如何导入。(很有可能,哪怕只想导入一个模块都要在目录中找很久)

这种情况下,__init__.py 就很有作用了。我们先来看看该文件是如何工作的。

2.1 __init__.py 是怎么工作的?

实际上,如果目录中包含了 __init__.py 时,当用 import 导入该目录时,会执行 __init__.py 里面的代码。

我们在mypackage目录下增加一个 __init__.py 文件来做一个实验:

.
└── mypackage
  ├── __init__.py
  ├── subpackage_1
  │  ├── test11.py
  │  └── test12.py
  ├── subpackage_2
  │  ├── test21.py
  │  └── test22.py
  └── subpackage_3
    ├── test31.py
    └── test32.py

mypackage/__init__.py 里面加一个print,如果执行了该文件就会输出:

print("You have imported mypackage")

下面直接用交互模式进行 import

>>> import mypackage
You have imported mypackage

很显然,__init__.py 在包被导入时会被执行。

2.2  控制模块导入

我们再做一个实验,在 mypackage/__init__.py 添加以下语句:

from subpackage_1 import test11

我们导入 mypackage 试试:

>>> import mypackage
Traceback (most recent call last):
 File "<stdin>", line 1, in <module>
 File "/home/taopeng/Workspace/Test/mypackage/__init__.py", line 2, in <module>
  from subpackage_1 import test11
ImportError: No module named 'subpackage_1'

报错了。。。怎么回事?

原来,在我们执行import时,当前目录是不会变的(就算是执行子目录的文件),还是需要完整的包名。

from mypackage.subpackage_1 import test11

综上,我们可以在__init__.py 指定默认需要导入的模块

2.3  偷懒的导入方法

有时候我们在做导入时会偷懒,将包中的所有内容导入

from mypackage import *

这是怎么实现的呢? __all__ 变量就是干这个工作的。

__all__ 关联了一个模块列表,当执行 from xx import * 时,就会导入列表中的模块。我们将 __init__.py 修改为 。

__all__ = ['subpackage_1', 'subpackage_2']

这里没有包含 subpackage_3,是为了证明 __all__ 起作用了,而不是导入了所有子目录。

>>> from mypackage import *
>>> dir()
['__builtins__', '__doc__', '__loader__', '__name__', '__package__', '__spec__', 'subpackage_1', 'subpackage_2']
>>> 
>>> dir(subpackage_1)
['__doc__', '__loader__', '__name__', '__package__', '__path__', '__spec__']

子目录的中的模块没有导入!!!

该例子中的导入等价于

from mypackage import subpackage_1, subpackage_2

因此,导入操作会继续查找 subpackage_1 和 subpackage_2 中的 __init__.py 并执行。(但是此时不会执行 import *)

我们在 subpackage_1 下添加 __init__.py 文件:

__all__ = ['test11', 'test12']

# 默认只导入test11
from mypackage.subpackage_1 import test11

再来导入试试

>>> from mypackage import *
>>> dir()
['__builtins__', '__doc__', '__loader__', '__name__', '__package__', '__spec__', 'subpackage_1', 'subpackage_2']
>>> 
>>> dir(subpackage_1)
['__all__', '__builtins__', '__cached__', '__doc__', '__file__', '__loader__', '__name__', '__package__', '__path__', '__spec__', 'test11']

如果想要导入子包的所有模块,则需要更精确指定。

>>> from mypackage.subpackage_1 import *
>>> dir()
['__builtins__', '__doc__', '__loader__', '__name__', '__package__', '__spec__', 'test11', 'test12']

3. 配置模块的初始化操作

在了解了 __init__.py 的工作原理后,应该能理解该文件就是一个正常的python代码文件。

因此可以将初始化代码放入该文件中。

到此这篇关于浅谈Python __init__.py的作用的文章就介绍到这了,更多相关Python __init__.py内容请搜索三水点靠木以前的文章或继续浏览下面的相关文章希望大家以后多多支持三水点靠木!

Python 相关文章推荐
python搭建简易服务器分析与实现
Dec 15 Python
Python自动化构建工具scons使用入门笔记
Mar 10 Python
Python实现配置文件备份的方法
Jul 30 Python
Python更新数据库脚本两种方法及对比介绍
Jul 27 Python
Python开发虚拟环境使用virtualenvwrapper的搭建步骤教程图解
Sep 19 Python
Python实现PyPDF2处理PDF文件的方法示例
Sep 25 Python
利用Python的sympy包求解一元三次方程示例
Nov 22 Python
python3光学字符识别模块tesserocr与pytesseract的使用详解
Feb 26 Python
Python IDE环境之 新版Pycharm安装详细教程
Mar 05 Python
Python中猜拳游戏与猜筛子游戏的实现方法
Sep 04 Python
python如何获取网络数据
Apr 11 Python
浅谈Python numpy创建空数组的问题
May 25 Python
详解Selenium-webdriver绕开反爬虫机制的4种方法
Oct 28 #Python
详解Python流程控制语句
Oct 28 #Python
详解selenium + chromedriver 被反爬的解决方法
Oct 28 #Python
手把手教你从PyCharm安装到激活(最新激活码),亲测有效可激活至2089年
Nov 25 #Python
Python字典实现伪切片功能
Oct 28 #Python
python使用selenium爬虫知乎的方法示例
Oct 28 #Python
怎么解决pycharm license Acti的方法
Oct 28 #Python
You might like
一个用于网络的工具函数库
2006/10/09 PHP
php stream_get_meta_data返回值
2013/09/29 PHP
PHP安装memcached扩展笔记
2015/05/28 PHP
php四种定界符详解
2017/02/16 PHP
php实现的支付宝网页支付功能示例【基于TP5框架】
2019/09/16 PHP
用javascript获得地址栏参数的两种方法
2006/11/08 Javascript
来自chinaz的ajax获取评论代码
2008/05/03 Javascript
在JS中最常看到切最容易迷惑的语法(转)
2010/10/29 Javascript
JavaScript回调(callback)函数概念自我理解及示例
2013/07/04 Javascript
JQuery 给元素绑定click事件多次执行的解决方法
2014/09/09 Javascript
JavaScript中使用Object.prototype.toString判断是否为数组
2015/04/01 Javascript
jQuery实现的仿select功能代码
2015/08/19 Javascript
详解JavaScript中localStorage使用要点
2016/01/13 Javascript
Bootstrap + AngularJS 实现简单的数据过滤字符查找功能
2017/07/27 Javascript
在node环境下parse Smarty模板的使用示例代码
2019/11/15 Javascript
详解一些适用于Node.js的命名约定
2019/12/08 Javascript
Ajax获取node服务器数据的完整步骤
2020/09/20 Javascript
用python实现面向对像的ASP程序实例
2014/11/10 Python
Python进阶之尾递归的用法实例
2018/01/31 Python
Python简单实现查找一个字符串中最长不重复子串的方法
2018/03/26 Python
Django框架的中的setting.py文件说明详解
2018/10/15 Python
python实现自动登录后台管理系统
2018/10/18 Python
详解Python的数据库操作(pymysql)
2019/04/04 Python
python 使用多线程创建一个Buffer缓存器的实现思路
2020/07/02 Python
美国台面电器和厨具品牌:KitchenAid
2019/04/12 全球购物
澳洲网红粉泥面膜:Sand & Sky
2019/08/13 全球购物
匡威俄罗斯官网:Converse俄罗斯
2020/05/09 全球购物
公司清洁工岗位职责
2013/12/14 职场文书
2014年班主任自我评价范文
2014/04/23 职场文书
岗位职责说明书
2014/05/07 职场文书
服务理念口号
2014/06/11 职场文书
学生会辞职信
2015/03/02 职场文书
2015年办公室文秘工作总结
2015/04/30 职场文书
生产实习心得体会范文
2016/01/22 职场文书
大学生党员暑假实践(活动总结)
2019/08/21 职场文书
eclipse创建项目没有dynamic web的解决方法
2021/06/24 Java/Android