import循环导致模块加载失败，因Python线性执行导入时A依赖B、B又依赖未执行完的A，引发ImportError；本质是模块状态不一致，需通过延迟导入、解耦设计或字符串引用等手段解决。
为什么 import 循环会导致模块加载失败
Python 解释器在导入模块时是线性执行的：遇到 import A 就立刻去加载 A.py，逐行执行其中的代码。如果 A.py 里有 import B，而 B.py 又反过来写了 import A，且此时 A 还没执行完——解释器就会卡住，抛出 ImportError: cannot import name 'X' from partially initialized module 'A'。
这不是语法错误，而是运行时模块状态不一致导致的。常见于拆分逻辑时把相互依赖的类/函数硬塞进不同文件，又没控制好导入时机。
- 避免在模块顶层直接
import相互依赖的模块；把导入移到函数或方法内部（延迟导入） - 检查是否真需要双向依赖：多数情况其实是设计问题，比如把配置、工具函数抽到第三模块更干净
- 用
if TYPE_CHECKING:包裹仅用于类型提示的导入，避免运行时触发
循环引用不一定报错，但会破坏 __all__ 和重载行为
有些循环引用能“侥幸”通过，比如两个模块只在函数体里互相调用，顶层没实际引用。表面看没问题，但暗藏风险：
-
from A import *可能漏掉本该导出的名称，因为A.__all__可能在B加载完成前就被读取了 - 用
importlib.reload()重载模块时，循环引用会让状态混乱，部分对象仍指向旧版本实例 - 调试时
print(A.__dict__)可能看到A的命名空间里没有刚定义的类，因为它被B的导入打断了执行流
用 sys.modules 检查是否已缓存模块
Python 导入后会把模块对象存在 sys.modules 字典里。循环引用发生时，你常会看到某个模块在字典里存在但内容为空（只有 __name__、__loader__ 等基础属性）。
立即学习“Python免费学习笔记（深入）”；
快速验证方式：
import sys
print('myapp.models' in sys.modules)
print(list(sys.modules.keys())[-5:]) # 看最后几个加载的模块名- 如果
myapp.models在sys.modules中但hasattr(sys.modules["myapp.models"], "User")是False，基本就是循环卡在中间了 - 不要手动删
sys.modules["xxx"]来“修复”，这会让后续导入行为不可预测 - 真正要改的是导入位置，不是绕过缓存
Django/Flask 项目里最常踩的坑：信号、模型、admin 注册顺序
这类框架大量依赖模块级注册（如 @receiver、admin.site.register()），一旦注册语句写在模块顶层，就极易和模型定义形成循环。
- Django 中，把
signals.py的导入从apps.py移到ready()方法里，而不是放在__init__.py或models.py顶部 - Flask 中，别在
__init__.py里直接from .models import User，改用工厂函数里按需导入 - 所有 ORM 模型间的外键引用，优先用字符串形式：
ForeignKey("auth.User", ...)而不是ForeignKey(User, ...)，避开模块级对象依赖
循环引用本质不是 Python 的缺陷，而是模块边界模糊的信号。越晚绑定依赖，越容易看清哪部分逻辑本该合并，或者哪层抽象该被抽离。很多人修了半天 import，最后发现删掉一个中间模块，问题自然消失。
