Python模块和包中的入口文件

发表于： 2025-03-27

__init__.py 是 Python 中一个特殊的文件命名规则，它的存在和作用与 Python 的模块和包（module and package）系统密切相关。以下是关于 __init__.py 命名规则及其作用的详细说明：

title: “Python模块和包中的入口文件” description: keywords: “Python模块和包中的入口文件” date: 2025-03-27T00:11:23+08:00 lastmod: 2025-03-27T00:11:23+08:00 categories:

电脑技术

2. 作用

（1）标识包

在 Python 3.3 之前，如果一个目录中没有 __init__.py 文件，Python 不会将其识别为一个包。换句话说，__init__.py 是一个包的“入口标志”。

例如：

my_package/
    init.py
    module1.py
    module2.py

在上述结构中，my_package 被视为一个包，可以通过 import my_package 或 from my_package import module1 来使用。

（2）初始化代码

__init__.py 文件可以包含代码，这些代码会在包被导入时自动执行。通常用于：

初始化包的状态。
设置包级别的变量。
控制包的导出内容（通过 __all__ 变量）。

示例：

# my_package/__init__.py
print("Initializing my_package...")

# 导入子模块
from .module1 import MyClass
from .module2 import my_function

# 定义包级别的变量
version = "1.0"

# 定义默认导出内容
__all__ = ["MyClass", "my_function"]

当导入 my_package 时，__init__.py 中的代码会被执行：

1
2

import my_package
# 输出: Initializing my_package...

（3）控制导入行为

__init__.py 文件可以通过定义 __all__ 列表来控制 from package import * 行为。__all__ 指定了哪些模块或对象可以被 * 导入。

示例：

# my_package/__init__.py
__all__ = ["module1", "my_function"]

from my_package import *
# 只会导入 module1 和 my_function

3. Python 3.3+ 的变化

从 Python 3.3 开始，引入了隐式命名空间包（Implicit Namespace Packages），即使目录中没有 __init__.py 文件，Python 也可以将其识别为包。这种特性主要用于支持跨多个项目的大型命名空间包。

例如：

namespace_package/
    subpackage1/
    module1.py
    subpackage2/
    module2.py

在这种情况下，即使没有 __init__.py，namespace_package.subpackage1 和 namespace_package.subpackage2 仍然可以被正确导入。

然而，为了兼容性和明确性，许多开发者仍然选择显式地添加 __init__.py 文件。

4. 最佳实践

显式优于隐式：尽管 Python 3.3+ 支持隐式命名空间包，但显式地添加 __init__.py 文件可以让代码更具可读性和兼容性。
保持简洁：__init__.py 文件应尽量简单，避免包含复杂的逻辑。
定义导出内容：通过 __all__ 明确指定包的公共接口。