Python实现包级导出时如何避免导入循环依赖问题？

方案1：模块级__getattr__懒导出（最推荐，Python 3.7+支持） #

这种方案完全避免了包初始化阶段加载内部子模块，从根源上消除循环依赖的可能，且对外使用体验完全不变，该方案的导入属于包导出逻辑的懒加载实现，不属于业务函数内部导入，符合你的要求：
修改foo/__init__.py内容如下：

__all__ = ["UsefulClass", "AnotherClass"]

def __getattr__(name):
    if name == "UsefulClass":
        from .body import UsefulClass
        return UsefulClass
    elif name == "AnotherClass":
        from .another import AnotherClass
        return AnotherClass
    raise AttributeError(f"module '{__name__}' has no attribute '{name}'")

实现逻辑：

• 初始执行import foo时不会加载body.py、another.py，仅完成包的基础初始化
• 只有当用户首次访问foo.UsefulClass或者执行from foo import UsefulClass时，才会触发对应子模块的导入
• 完全隐藏内部目录结构，用户使用方式和你最初的设计完全一致

方案2：保留现有逻辑（无实际运行问题） #

你当前遇到的属于无害伪循环，实际运行不会产生任何问题：
当用户导入foo时，__init__.py首先被执行，此时foo包已经被注册到Python的模块缓存sys.modules中，后续body.py执行from . import util时不会重新触发__init__.py的全量运行，也不会出现循环导入的卡死问题。如果你只是心理上对逻辑循环感到不适，才需要考虑调整。

方案3：低版本Python兼容方案 #

如果使用Python 3.7以下版本，不支持模块级__getattr__，可以将内部依赖拆分到独立的无依赖模块中：
把util.py和其他不会依赖顶层导出的工具逻辑单独归档到子包中，body.py直接导入子包内的工具，顶层__init__.py再导入业务类，也可以规避循环依赖的感知。

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