Python的__init__.py文件到底有什么用？

一般来说，在一些开源项目里面都会存在__init__.py文件，这里不多解释，到底有什么作用呢？

精简导入路径

目录结构如下图，现在有两个文件run.py与writer.py。run.py在Document文件夹下面；writer.py在DocParser/microsoft/docx/文件夹下面。writer.py文件中有一个函数write。其内容如下图，就是一个简单的打印函数：

现在我想在run.py文件调用这个函数，可以有3种写法：

from microsoft.word.docx.writer import write
write()
或者
from microsoft.word.docx import writer
writer.write()
或者
import microsoft.word.docx.writer
microsoft.word.docx.writer.write()

三种方式都可以运行，但是没有人会喜欢这样导入模块。这个时候，我们可以在microsoft文件夹下面创建一个__init__.py文件，并在里面填写如下内容：

现在，在 run.py，我们导入write函数，就像是从microsoft.py 文件中导入一样：

import microsoft
microsoft.write()

当一个文件夹里面有__init__.py以后，这个文件夹就会被 Python 作为一个包(package)来处理。此时，对于这个包里面层级比较深的函数、常量、类，我们可以先把它们导入到__init__.py中。这样以来，包外面再想导入这些内容时，就可以用from 包名 import 函数名来导入了。

无视工作区的相对引用

包：一些代码会在很多地方被使用时，我们可以把这些代码打包起来，作为一个公共的部分提供给其他模块调用，这就是包。

由于调用包的其他模块所在的绝对路径是千变万化的，所以在包的内部调用自身其他文件中的函数、常量、类，就应该使用相对路径，而不是绝对路径。

现在我在microsoft文件夹下面再创建一个parse.py文件，它需要导入microsoft/word/docx/writer.py中的write函数，那么代码可以写为：

from .word.docx.writer import write

def parse_doc():
    print('parse.py调用write函数')
    write()

代码中的from .word.docx.writer中的.表示当前包，所以.word.docx.writer表示当前包下面的word 文件夹下面的 docx 文件夹下面的 writer.py 文件。

然后修改__init__.py，把parse_doc函数导入进去：

from .word.docx.writer import write
from .parse import parse_doc

最后，在run.py中调用这个parse_doc函数：

from microsoft import parse_doc
parse_doc()

代码可以正常执行。包里面的一个文件调用这个包里面的另一个文件，只需要知道另一个文件的相对位置就可以了，不用关心这个包被放在哪里。

当一个文件夹里面包含__init__.py时，这个文件夹会被 Python 认为是一个包(package)，此时，包内部的文件之间互相导入可以使用相对导入，并且通过提前把函数、常量、类导入到__init__.py中再在其他文件中导入，可以精简代码。