init.py文件作用
__init__.py的三大核心功能
init.py三大核心功能
标记包python package
包被导入时,自动执行其中的初始化代码
通过__all__变量控制包的「公共接口」(封装性)
功能 1:标记包(最基础功能)
这是__init__.py的原始核心作用,即使文件内容为空,也能实现「标记目录为 Python 包」的效果。
如下所示,在pycharm中加入__init__.py后api变为python package标识

功能 2:包被导入时,自动执行其中的初始化代码
当通过import导入某个包时,Python 会自动执行该包下__init__.py文件中的所有代码,可用于完成包的初始化配置、定义全局变量、加载依赖等操作。
功能 3:通过__all__变量控制包的「公共接口」(封装性)
__init__.py中可以定义__all__列表,用于指定「当使用from 包名 import *时,能够被导入的成员(模块、类、函数、变量)」,从而隐藏包的内部细节,提升封装性,避免不必要的成员暴露。
示例(对应schemas/__init__.py):
python
# 定义__all__,指定from schemas import * 时可导入的成员
__all__ = ["UserCreateRequest", "UserResponse", "GoodsCreateRequest", "GoodsResponse"]
# 提前导入子模块的成员,简化外部调用
from schemas.user import UserCreateRequest, UserResponse
from schemas.goods import GoodsCreateRequest, GoodsResponse
此时外部执行from schemas import *,只会导入__all__中指定的 4 个模型,而不会暴露schemas包内的其他内部细节,同时也简化了外部导入(无需写from schemas.user import UserCreateRequest)。
若不定义__all__,from 包名 import *仅会导入该__init__.py中直接定义的成员,无法导入子模块的内容。