Python项目不使用__init__.py文件是否属于不良实践？

核心疑问回应 #

你当前的项目场景下，不添加__init__.py不属于不良实践。
自Python 3.3版本引入隐式命名空间包特性后，普通项目文件夹无需额外添加__init__.py即可被解释器识别为可导入的Python包。你目前的项目没有跨文件夹导入需求，文件间交叉调用频率也很低，添加空的__init__.py反而属于冗余操作，现阶段完全可以不添加。

__init__.py的核心价值，你可以根据后续项目演进判断是否需要引入 #

• 兼容旧版本Python：如果你的项目需要支持Python 3.2及更早版本，必须添加__init__.py才能让解释器将文件夹识别为合法的可导入包
• 简化外部导入路径：你可以在__init__.py中提前导出内部模块的公开成员，降低使用者的导入成本。例如你的包结构为utils/date_tool.py，内部实现了parse_time函数，在utils/__init__.py中添加from .date_tool import parse_time后，外部使用者可以直接用from utils import parse_time导入，无需写完整的嵌套路径
• 明确公开API范围：你可以在__init__.py中定义__all__列表，指定执行from 包名 import *时会导入的成员，也能清晰区分模块的公开接口和内部实现细节，避免使用者依赖不稳定的内部逻辑
• 执行包初始化逻辑：如果包加载时需要执行预操作（比如读取全局配置、初始化连接池、校验运行环境依赖），可以将相关逻辑写在__init__.py中，包第一次被导入时会自动执行这些代码

内容的提问来源于stack exchange，提问作者Daniel Wyatt