摘要：在 Python 编程中，__init__.py 是包（Package）结构中一个非常重要的文件。它既是标识目录为包的标志，也是控制包初始化行为的入口点。
在 Python 编程中，__init__.py 是包（Package）结构中一个非常重要的文件。它既是标识目录为包的标志，也是控制包初始化行为的入口点。
理解 __init__.py 的用途，有助于我们更好地组织、导入和维护代码。
一、__init__.py 的基本作用
在 Python 3.2 及之前版本，包（Package）结构中必须包含一个 __init__.py 文件，否则该目录不会被识别为包，无法使用 import 导入。
在 Python 3.3+ 版本，引入了隐式命名空间包（Implicit Namespace Packages），允许在没有 __init__.py 的情况下将目录视为包。
但即便如此，显式添加 __init__.py 仍然是最佳实践。
二、__init__.py 的常见用途
1、将目录标识为包
目录结构示例：
my_package/├── __init__.py├── module_a.py└── module_b.py有了 __init__.py 文件，我们就可以：
import my_package.module_a2、执行包的初始化逻辑
文件示例：
# my_package/__init__.py print("Initializing my_package...")当导入 my_package 时，上面代码会自动运行。
import my_package如果只导入子模块（如 import my_package.module_a），__init__.py 也会先执行，因为包会先被导入。
常见的初始化逻辑包括：
（1）设置默认配置。
（2）初始化日志系统。
（3）检查运行环境。
（4）导入关键子模块。
示例：一个合理的 __init__.py
# my_package/__init__.py"""My Package - 提供数学计算和数据处理功能"""# 定义公共 API（相对导入）from .math_utils import add, subtractfrom .data_utils import load_data__all__ = ["add", "subtract", "load_data"]# 初始化逻辑（谨慎设置全局配置）import logginglogger = logging.getLogger(__name__)logger.info("my_package 已初始化")这样，既能在初始化时输出提示，又避免强行改动全局日志配置。
3、创建包级别的简化接口
有时我们希望用户通过更简短的路径来访问功能：
my_package/module_a.py 文件内容示例：
def add(x, y):return x + ymy_package/__init__.py 文件内容示例：
from .module_a import add提示：
在相对导入的语法中，一个点（.）表示当前目录，两个点（..）表示当前目录的父目录，等等。
这样用户就可以直接：
from my_package import add而不必：
from my_package.module_a import add4、定义 __all__ 控制导出内容
文件示例：
# my_package/__init__.py from .module_a import func_afrom .module_b import func_b__all__ = ["func_a", "func_b"]这样，当用户执行：
from my_package import *只会导入 func_a 和 func_b。
5、组合多个子包
目录结构示例：
my_package/├── __init__.py├── sub_package1/│ ├── __init__.py│ └── a.py└── sub_package2/├── __init__.py└── b.py顶层 __init__.py 可以将子包内容统一导出：
from .sub_package1.a import func_afrom .sub_package2.b import func_b三、__init__.py 与命名空间包
在 Python 3.3+，如果一个包目录没有 __init__.py，Python 会将它当作命名空间包（Namespace Package）。
1、允许同名包分布在多个目录中，并合并为一个逻辑包。
2、适合大型项目的模块化拆分。
3、命名空间包的 __path__ 属性可能包含多个目录路径，这也是其实现原理之一。
例如：
/path1/mypkg/module_a.py/path2/mypkg/module_b.py若两个 mypkg 目录都没有 __init__.py，Python 会将它们合并为一个逻辑包 mypkg。
缺点：
（1）无法在包导入时执行初始化代码。
（2）无法直接定义 __all__。
（3）某些依赖旧行为的工具可能无法正常工作。
四、补充说明
即便是 Python 3.3+ 版本，也建议显式创建，避免歧义。
2、保持内容简洁
只做必要的初始化，避免在 __init__.py 中编写复杂逻辑，防止导入时性能开销过大。
3、慎用通配导入
避免在 __init__.py 中使用 from .module import *，以免命名冲突和可读性降低。
4、用于公共 API 暴露
通过 __init__.py 整理包的对外接口，用户无需关心内部模块结构。
“点赞有美意，赞赏是鼓励”
来源：小风课堂
