### Python `__init__.py` 文件的用途及用法 #### 1. 将文件夹转换为模块 `__init__.py` 文件的主要作用是将一个普通的文件夹标记为一个 Python 模块。这意味着该文件夹可以被导入并作为模块使用[^1]。 ```python import mypackage ``` 当执行上述语句时，Python 会查找名为 `mypackage` 的目录中的 `__init__.py` 文件，并运行其中的内容。 --- #### 2. 定义包内的初始化逻辑 除了标记文件夹为模块外，`__init__.py` 还可以在模块加载时执行特定的初始化操作。例如，在 `project/mypackage/__init__.py` 中编写以下代码： ```python print("Initializing the package...") ``` 每次导入此模块时都会打印消息[^3]。 --- #### 3. 控制模块导出内容 可以通过设置 `__all__` 变量来控制哪些子模块会被 `from ... import *` 导入。例如： ```python # mypackage/__init__.py __all__ = ['module1', 'module2'] ``` 这样，只有 `module1` 和 `module2` 被显式导入。 --- #### 4. 提供默认行为或接口 如果希望某个模块在直接调用时提供某种功能，则可在 `__init__.py` 或关联的 `__main__.py` 文件中定义这些行为。例如： ```python # my_package/__main__.py def main(): print("Welcome to my_package!") if __name__ == "__main__": main() ``` 此时，可以直接通过命令行运行整个包[^4]： ```bash python -m my_package ``` 这将触发 `my_package.__main__` 中的逻辑。 --- #### 5. 实现动态路径管理 对于复杂的项目结构，可能需要动态调整模块搜索路径。可以在 `__init__.py` 中修改 `sys.path` 来支持更灵活的依赖关系[^2]。 ```python import sys import os sys.path.append(os.path.dirname(__file__)) ``` --- #### 示例代码：完整的 `__init__.py` 使用场景 以下是基于引用的一个简单例子: 假设有一个如下目录结构： ``` project/ │ main.py └───mypackage/ __init__.py module1.py module2.py ``` - **`__init__.py`** ```python from .module1 import func1 from .module2 import func2 __all__ = ['func1', 'func2'] print("Package initialized.") ``` - **`module1.py`** ```python def func1(): print("Function from module1 called.") ``` - **`module2.py`** ```python def func2(): print("Function from module2 called.") ``` - **`main.py`** ```python import mypackage mypackage.func1() # 输出来自 module1 的函数 mypackage.func2() # 输出来自 module2 的函数 ``` --- ### 总结 `__init__.py` 是 Python 包的核心组件之一，其主要职责包括但不限于将文件夹声明为模块、定义初始化逻辑以及控制模块间的交互方式。合理设计和利用它可以显著提升项目的可维护性和扩展性^.