Python自定义包如何优雅简化导入语句 无需合并大体积代码文件

你目前通过各层级__init__.py导出对外符号的实现方式，是Python生态的标准、推荐实践，完全不存在“不优雅”的问题，也不需要把大体积的类、函数合并到单个文件中。

设计逻辑说明 #

Python包体系中，__init__.py本身就承担着「对外API门面」的核心作用，requests、numpy、pandas等绝大多数主流开源Python包都采用这种模式实现简洁导入，核心价值是实现内部实现和外部接口的解耦：

• 内部开发时，你完全可以按照维护需求拆分文件，不管单个体量多大的类、函数都可以单独存为文件，不用顾忌文件拆分导致的导入路径过长问题
• 包的使用者不需要感知你内部的文件存储结构，只需要按照文档给出的简洁路径导入即可
• 后续你如果重构内部目录结构，只要保持__init__.py中的导出规则不变，用户侧的代码不需要做任何修改，兼容性极强。

标准实现方式 #

你只需要在对应层级的__init__.py中显式导入需要对外暴露的符号即可：

• 顶层包文件pkg/pkg/__init__.py添加如下内容：

from .classA import classA
from .functionA import functionA

# 可选：明确指定from pkg import *时导出的符号，避免泄露内部未准备好的接口
__all__ = ["classA", "functionA"]

• 子模块文件pkg/pkg/module1/__init__.py添加如下内容：

from .classB import classB
from .functionB import functionB

__all__ = ["classB", "functionB"]

配置完成后即可直接使用你预期的简洁导入语法，IDE自动补全、静态代码检查都可以正常识别。

可选优化提示 #

如果后续包内导出的符号数量增多，手动维护__init__.py的导入语句觉得繁琐，可以写简单的自动化脚本遍历模块文件，在发布版本前自动生成__init__.py的导入内容即可。
不建议 为了省几行导入代码使用运行时动态导入的方案，这类方案会破坏IDE自动补全、静态类型检查能力，反而会给其他使用你包的开发者造成不必要的麻烦。

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