类实例跨脚本相互依赖引发Python循环导入错误，求合规代码结构

问题场景 #

你有相互依赖的类实例，分散在不同脚本中，代码如下：

my_class.py #

class MyClass:
    def __init__(self):
        self.value = None

scriptA.py #

import scriptB

from my_class import MyClass

foo = MyClass()
foo.value = scriptB.bar.value + 1

scriptB.py #

import scriptA

from my_class import MyClass

bar = MyClass()
bar.value = 2

baz = MyClass()
baz.value = scriptA.foo.value + 1

scriptC.py #

import scriptA
import scriptB

print(scriptA.foo.value + scriptB.bar.value + scriptB.baz.value)

运行scriptC.py时预期得到3+2+4=9的结果，但实际触发循环导入错误：

[...]
baz.value = scriptA.foo.value + 1
AttributeError: partially initialized module 'scriptA' has no attribute 'foo' (most likely due to a circular import)

Python推荐的代码结构方案 #

方案1：集中初始化所有实例 #

把实例的创建和依赖赋值拆分，将初始化逻辑单独放到一个模块，避免模块间直接循环引用。

1. 保留my_class.py不变。
2. 修改scriptA.py和scriptB.py，仅定义实例，不做依赖赋值：

scriptA.py

from my_class import MyClass

foo = MyClass()

scriptB.py

from my_class import MyClass

bar = MyClass()
baz = MyClass()

3. 新增init_instances.py，按依赖顺序初始化实例值：

import scriptA
import scriptB

# 先初始化无依赖的bar
scriptB.bar.value = 2
# 再初始化依赖bar的foo
scriptA.foo.value = scriptB.bar.value + 1
# 最后初始化依赖foo的baz
scriptB.baz.value = scriptA.foo.value + 1

4. 修改scriptC.py，先导入初始化模块再使用实例：

import init_instances
import scriptA
import scriptB

print(scriptA.foo.value + scriptB.bar.value + scriptB.baz.value)

方案2：延迟初始化依赖值 #

把依赖赋值逻辑封装到函数中，避免模块加载阶段就触发循环引用，在需要使用前手动调用初始化函数。

scriptA.py

from my_class import MyClass

foo = MyClass()

def init_foo():
    import scriptB
    foo.value = scriptB.bar.value + 1

scriptB.py

from my_class import MyClass

bar = MyClass()
bar.value = 2
baz = MyClass()

def init_baz():
    import scriptA
    baz.value = scriptA.foo.value + 1

scriptC.py

import scriptA
import scriptB

# 按依赖顺序执行初始化
scriptA.init_foo()
scriptB.init_baz()

print(scriptA.foo.value + scriptB.bar.value + scriptB.baz.value)

方案3：将实例统一放到单个模块 #

把所有相互依赖的实例集中到同一个模块，彻底消除循环引用的根源。

instances.py

from my_class import MyClass

bar = MyClass()
bar.value = 2

foo = MyClass()
foo.value = bar.value + 1

baz = MyClass()
baz.value = foo.value + 1

scriptC.py

import instances

print(instances.foo.value + instances.bar.value + instances.baz.value)

以上三种方案都能规避Python模块加载时的循环依赖问题，符合Python的模块设计规范。

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