python小知识点4 --import和__init__的作用和使用方法

本文详细介绍了Python中的包结构及__init__.py文件的作用。解释了__init__.py作为包标识的重要性，以及如何通过定义__all__来实现模块的模糊导入。此外还介绍了不同场景下的模块导入方式。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

文章截取自：python包的导入——__init__.py - 优快云博客 https://blog.youkuaiyun.com/zyl1042635242/article/details/44196601

Python包中__init__.py作用 - 徐文 - 博客园 http://www.cnblogs.com/AlwinXu/p/5598543.html

重要知识点：

1、__init__.py的主要作用是：

1. Python中package的标识，不能删除

__init__.py的第一个作用就是package的标识，如果没有该文件，该目录就不会认为是package。

2. 定义__all__用来模糊导入

模糊导入中的*中的模块是由__all__来定义的，__init__.py的另外一个作用就是定义package中的__all__，用来模糊导入

2、package内部互相调用：import module_11

3、 package外部互相调用：

方法一、from 包名.模块 import 函数名（funcA)

函数名也可以换成 * 号导入模块（.py文件）中所有的函数，这条语句可以直接在包外使用。

这时可以直接调用 funcA()

方法二、from 包名 import 模块

这条语句可以直接在包外使用。再使用语句 模块.funcA() 来调用函数funcA

方法三、 __all__ = ["模块1","模块2",……]

只有这句话写在__init__.py中，包外才能使用语句 from 包名 import * 进行模糊导入，然后在导入处使用语句 模块.funcA() 调用函数。

也可以使用from 包名.模块 import * 此时__all__=["funcA","函数"……] 此时可以直接使用函数 funcA() ,但是不建议这样使用，因为如果有多个模块都包含funcA函数，就会出现导入混乱。（如果出现这种情况，注意此时 funcA 会执行最后一次import所导入的funcA函数）

Python中常见的文件导入模式：

其实，主要是用到Python的包的概念，而__init__.py在包里起着重要作用。要弄明白这个问题，首先要知道，Python在执行import语句时，到底进行了什么操作，按照python的文档，它执行了如下操作：
第1步，创建一个新的，空的module对象（它可能包含多个module）

    第2步，把这个module对象插入sys.module中
    第3步，装载module的代码（如果需要，首先必须编译）
    第4步，执行新的module中对应的代码。

    在执行第3步时，首先要找到module程序所在的位置。其原理为：如果需要导入的module的名字是m1，则解释器必须找到m1.py，它首先在当前目录查找，然后是在环境变量PYTHONPATH中查找。PYTHONPATH可以视为系统的PATH变量一类的东西，其中包含若干个目录。如果PYTHONPATH没有设定，或者找不到m1.py，则继续搜索与Python的安装设置相关的默认路径。正因为存在这样的顺序，如果当前路径或PYTHONPATH中存在与标准module同样的module，则会覆盖标准module。也就是说，如果当前目录下存在xml.py，那么执行import xml时，导入的是当前目录下的module，而不是系统标准的xml。

    了解了这些，我们就可以先构建一个package，以普通module的方式导入，就可以直接访问此package中的各个module了。Python中的package定义很简单，其层次结构与程序所在目录的层次结构相同，这一点与Java类似，唯一不同的地方在于，python中的package必须包含一个__init__.py的文件。
例如，我们可以这样组织一个package:

package1/
    __init__.py
    subPack1/
        __init__.py
        module_11.py
        module_12.py
        module_13.py
    subPack2/
        __init__.py
        module_21.py
        module_22.py
    ……
    __init__.py可以为空，只要它存在，就表明此目录应被作为一个package处理。当然，__init__.py中也可以设置相应的内容，下文详细介绍。好了，现在我们在module_11.py中定义一个函数：

def funA():
    print "funcA in module_11"
    return

    在顶层目录（也就是package1所在的目录，当然也参考上面的介绍，将package1放在解释器能够搜索到的地方）运行python:

>>>from package1.subPack1.module_11 import funcA
>>>funcA()
funcA in module_11

    这样，我们就按照package的层次关系，正确调用了module_11中的函数。

    细心的用户会发现，有时在import语句中会出现通配符*，导入某个module中的所有元素，这是怎么实现的呢？
答案就在__init__.py中。我们在subPack1的__init__.py文件中写

__all__ = ['module_13', 'module_12'] ,然后进入python

>>>from package1.subPack1 import *
>>>module_11.funcA()
Traceback (most recent call last):
File "<stdin>", line 1, in <module>
ImportError: No module named module_11

也就是说，以*导入时，package内的module是受__init__.py限制的。

    好了，最后来看看，如何在package内部互相调用。如果希望调用同一个package中的module，则直接import即可。也就是说，在module_12.py中，可以直接使用

import module_11

如果不在同一个package中，例如我们希望在module_21.py中调用module_11.py中的FuncA，则应该这样：