如何解决引用dataclasses与default_factory的循环导入问题

问题场景 #

我正在编写一个Python包，大量类、函数等单元相互引用，遇到了循环导入问题。具体场景如下：

a.py #

from dataclasses import dataclass, field

from .b import B
from .c import C

@dataclass
class A:
    b: B = field(default_factory=B)
    c: C = field(default_factory=C)

b.py #

from dataclasses import dataclass, field

from .a import A
from .c import C

@dataclass
class B:
    a: A = field(default_factory=A)
    c: C = field(default_factory=C)

c.py #

from dataclasses import dataclass, field

from .a import A
from .b import B

@dataclass
class C:
    a: A = field(default_factory=A)
    b: B = field(default_factory=B)

我知道可以将所有类合并到同一文件解决，但代码量很大，合并会导致文件过于庞大，更倾向于拆分文件提升开发体验，求最佳解决方案。

已尝试的无效方法 #

• 将类名放在单引号中，但对default_factory无效
• 尝试用import关键字实现相对导入，比如import .a无法正常工作

可行解决方案 #

方法1：延迟导入（实例化时才导入） #

把导入逻辑移到default_factory的调用过程中，避免模块加载阶段的循环引用。可以用lambda包裹导入，或者单独写导入函数：

修改a.py示例：

from dataclasses import dataclass, field

@dataclass
class A:
    # 类型提示用字符串标注（PEP 484前向引用）
    b: 'B' = field(default_factory=lambda: __import__('my_package.b').b.B)
    c: 'C' = field(default_factory=lambda: __import__('my_package.c').c.C)

或者更清晰的函数式写法：

from dataclasses import dataclass, field

def _get_b():
    from .b import B
    return B()

def _get_c():
    from .c import C
    return C()

@dataclass
class A:
    b: 'B' = field(default_factory=_get_b)
    c: 'C' = field(default_factory=_get_c)

同理修改b.py和c.py，模块加载时不会触发跨模块导入，只有创建实例时才会执行导入逻辑，规避循环依赖。

方法2：利用包的__init__.py统一导出 #

在包的__init__.py中提前导入所有类，让各个模块从__init__.py导入依赖，而非直接跨模块引用：

假设包结构为：

my_package/
    __init__.py
    a.py
    b.py
    c.py

在__init__.py中添加：

from .a import A
from .b import B
from .c import C

然后修改a.py：

from dataclasses import dataclass, field
from . import B, C

@dataclass
class A:
    b: B = field(default_factory=B)
    c: C = field(default_factory=C)

b.py和c.py做同样修改，从.导入对应的类。Python会缓存已导入的模块，__init__.py会先完成所有类的导入，避免循环问题。

方法3：重构依赖关系，移除循环引用 #

如果上述方法不够优雅，可以调整类的设计逻辑：

• 提取公共逻辑到独立模块，减少类之间的直接依赖
• 将默认实例的创建移到外部，而非在dataclass的default_factory中直接创建

比如修改a.py：

from dataclasses import dataclass, field

@dataclass
class A:
    b: 'B' = None
    c: 'C' = None

然后在业务代码中手动初始化实例：

from my_package.a import A
from my_package.b import B
from my_package.c import C

a = A(b=B(), c=C())
b = B(a=a, c=C())

这种方式彻底避免了类定义阶段的跨模块导入，代价是需要外部手动处理实例初始化。

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