init.py 文件不必写代码，空文件即可使目录成为包；但合理填充可简化导入路径、控制 from package import * 行为（需定义 all）、提升子模块接口至包顶层，并支持包级初始化逻辑。
__init__.py 文件到底要不要写内容？
它不是必须写代码的文件，空文件就足以让 Python 把所在目录识别为一个包。但空文件只解决“能不能导入”，不解决“怎么导入更干净”。如果 __init__.py 里什么也不写，外部就得用冗长路径导入，比如 from mypackage.submodule.utils import helper；而合理填充后，可以变成 from mypackage import helper。
如何用 __init__.py 控制 from package import * 的行为？
默认情况下 from mypackage import * 不会自动导入任何东西，除非你在 __init__.py 中显式定义 __all__。这个列表只影响星号导入，不影响点号导入。
-
__all__ = ["load_config", "validate_input"]—— 只有这两个名字会被import *拉进来 - 没定义
__all__时，import *实际上什么也不会导入（CPython 行为） - 即使没列在
__all__里，只要模块内已执行from .utils import something，那个something也会出现在包命名空间中，只是不会被*捕获
为什么有时 __init__.py 里要显式导入子模块？
这是为了“提升接口层级”：把深层模块里的类或函数，在包顶层重新暴露出来，避免用户记不住嵌套路径。本质是做符号重定向，不是加载优化（Python 导入机制本身已缓存）。
- 在
mypackage/__init__.py中写from .core.engine import Pipeline，用户就能直接from mypackage import Pipeline - 若子模块有副作用（如注册插件、初始化全局状态），那导入它就有实际意义；否则纯属 API 设计选择
- 注意循环导入风险：比如
core/__init__.py导入了utils，而utils/__init__.py又反过来导入core，就会报ImportError: cannot import name 'X' from partially initialized module
Python 3.3+ 的隐式命名空间包对 __init__.py 有什么影响？
从 Python 3.3 开始，PEP 420 允许没有 __init__.py 的目录也被视为包（叫 namespace package），但它不能包含任何模块级代码，也不能定义 __all__ 或控制导入逻辑。
- 如果你需要
__init__.py里的逻辑（比如设置包级变量、预加载配置、自定义__getattr__），就必须保留该文件 - 混合使用时要小心：同名的普通包和 namespace 包不能共存，否则导入会失败并报
ModuleNotFoundError - 工具链兼容性：某些旧版构建工具（如 setuptools 低版本）或 IDE 可能仍依赖
__init__.py判断包边界，建议新项目也保留空文件以保底
真正容易被忽略的是：哪怕你只想用 PEP 420 的 namespace 特性，只要在任意父路径下存在一个带 __init__.py 的同名目录，整个结构就退化回传统包——这个细节在多仓库合并或 monorepo 场景里经常引发静默错误。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
