本文介绍通过延迟导入、类型提示注解优化及模块重构三种方法，安全解除 python 模块间的循环依赖，保持代码结构清晰与可维护性。
在 Python 项目中，child.py 与 parent.py 相互引用会导致典型的循环导入（circular import）问题：child 导入 Parent 类用于返回类型注解和实例化，而 parent 又导入 Child 类用于字段类型声明。一旦执行 import 语句（尤其在模块顶层），Python 尚未完成任一模块的初始化，就会触发 AttributeError: partially initialized module 'xxx' has no attribute 'XXX'。
✅ 推荐方案一：延迟导入（Lazy Import）
将 parent 的导入移至方法内部，避免模块加载时的强依赖：
# child.py
from dataclasses import dataclass
@dataclass
class Child:
name: str
def get_mother(self):
# ✅ 延迟导入：仅在调用时加载 parent 模块
from parent import Parent
return Parent(
name="Jane",
children=[
Child(self.name),
Child("Alice"),
Child("Bob"),
],
)同时更新 parent.py，移除顶层 from child import Child，改用字符串形式的类型注解（PEP 563 启用后支持）：
# parent.py
from dataclasses import dataclass
@dataclass
class Parent:
name: str
# ✅ 使用字符串字面量避免运行时导入需求
children: list["Child"] # 注意引号包裹⚠️ 注意：Python 3.7+ 默认启用 from __future__ import annotations（推迟注解求值），若使用旧版本，请在文件顶部显式添加该导入。
✅ 推荐方案二：统一类型定义模块（推荐中大型项目）
创建独立的 models.py 或 types.py，集中声明所有核心数据类，消除双向依赖：
立即学习“Python免费学习笔记（深入）”；
# models.py
from dataclasses import dataclass
from typing import List
@dataclass
class Child:
name: str
@dataclass
class Parent:
name: str
children: List["Child"] # 字符串注解兼容前向引用然后 child.py 和 parent.py 均只导入 models：
# child.py
from dataclasses import dataclass
from models import Parent
@dataclass
class Child:
name: str
def get_mother(self) -> Parent:
return Parent(
name="Jane",
children=[Child(self.name), Child("Alice"), Child("Bob")]
)# parent.py
from dataclasses import dataclass
from models import Child
@dataclass
class Parent:
name: str
children: list[Child]此方式结构清晰、扩展性强，且天然规避循环导入。
❌ 不推荐的“修复”方式
- 仅改用 import parent 而非 from parent import Parent：仍会在模块顶层执行 import，无法解决初始化顺序问题；
- 在 __init__.py 中手动控制导入顺序：脆弱、不可靠，违背模块自治原则；
- 强制使用 if False: + from ... import ... 做伪导入：破坏静态分析，降低 IDE 支持度。
✅ 最终验证（main.py 无需修改）
# main.py
from child import Child
if __name__ == "__main__":
charles = Child("Charles")
print(f"{charles}'s mother is {charles.get_mother()}")运行成功输出：
Child(name='Charles')'s mother is Parent(name='Jane', children=[Child(name='Charles'), Child(name='Alice'), Child(name='Bob')])
总结
| 方法 | 适用场景 | 维护性 | 类型安全 |
|---|---|---|---|
| 延迟导入 + 字符串注解 | 快速修复、小型项目 | ★★★☆ | ✅（运行时）+ ✅（mypy 需启用 --follow-imports=normal） |
| 独立模型模块 | 中大型项目、需长期演进 | ★★★★★ | ✅✅（完整静态检查支持） |
核心原则：循环导入本质是架构耦合信号。优先通过合理分层（如引入 shared/models 层）解耦，其次用延迟导入兜底——而非妥协于技术债。
