Python相对导入遇循环依赖报错：ImportError无法导入指定名称

项目结构 #

app
    ├───schemas
        ├───__init__.py
        ├───a.py
        ├───b.py
        ├───c.py
        └───d.py

文件说明 #

• a.py 包含类 A、ABase，b.py、c.py、d.py 结构类似，各自定义对应类（如b.py含B、BBase等）
• schemas/__init__.py 内容：

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

问题描述 #

在c.py和d.py中导入A、B时触发循环导入错误：

ImportError: cannot import name 'D' from partially initialized module 'app.schemas.d' (most likely due to a circular import) (\.\app\schemas\__init__.py)

已尝试的导入方式：

• 直接从源文件导入：from .a import A + from .b import B
• 跨层级导入：from ..schemas import A, B
• 从当前包导入：from . import A, B
• 上述方式的组合写法

此前其他项目中直接从源文件导入的方式可正常工作，当前场景下失效。

原因分析 #

错误根源是循环导入：__init__.py会依次导入a.py、b.py、c.py、d.py中的类，而如果c.py或d.py在模块顶部导入内容时，间接触发了__init__.py的加载（比如使用from . import A, B会加载__init__.py），此时__init__.py可能还未完成d.py或c.py的导入，导致模块处于未完全初始化状态，进而抛出错误。

解决方案 #

1. 强制直接从源文件导入 #

在c.py和d.py中明确从a.py、b.py直接导入，避免通过__init__.py中转：

# c.py/d.py 顶部的导入代码
from .a import A
from .b import B

若此方式仍失效，检查以下两点：

• 确认c.py/d.py中没有其他触发__init__.py加载的代码（如from . import *或导入依赖__init__的模块）
• 确保运行脚本时以项目根目录为工作目录，或把app所在路径加入sys.path，避免模块路径识别错误

2. 延迟导入（适用于无法解耦的循环依赖） #

如果C/D与A/B确实存在双向依赖，可将导入操作移到函数内部，避免模块加载阶段的循环：

# c.py 示例
def process_with_A():
    from .a import A
    # 此处编写使用A的逻辑

3. 重构代码解耦依赖 #

将A、B这类基础类抽离到单独的基础模块，比如新建schemas/base.py，把ABase、A、B移至该文件，其他模块统一从base.py导入：

# schemas/base.py
class ABase:
    # 基础类逻辑
class A(ABase):
    # A类逻辑
class BBase:
    # 基础类逻辑
class B(BBase):
    # B类逻辑

然后在a.py/b.py中可简化为从base.py导入，c.py/d.py直接从base.py导入A、B，彻底避免循环依赖。

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