Django模型循环导入的根本原因是App初始化时模块未加载完成就相互引用，推荐用字符串引用外键（如'auth.User'）和将跨模型逻辑移至managers.py中延迟导入来解决。
为什么 models.py 里 import 其他模型会报错
循环导入不是 Django 特有，但 Django 的模型加载机制会让它更早暴露、更难调试。典型现象是启动时报 ImportError: cannot import name 'X' from partially initialized module 'Y'，或者迁移时 AppRegistryNotReady: Apps aren't loaded yet。根本原因是：Django 在初始化 apps 时会逐个导入 models.py，如果 A 模型在定义时就直接 import B 模型，而 B 又反过来 import A，模块还没载完就被要求用，就卡死。
用字符串引用代替直接 import 外键和多对多字段
Django 所有涉及模型关系的字段（ForeignKey、ManyToManyField、OneToOneField）都支持用字符串形式指定目标模型，比如 'auth.User' 或 'myapp.MyModel'。这是官方推荐解法，也是最轻量、最安全的绕过方式。
常见场景：
- 两个模型互相引用对方字段（如
UserProfile关联User，User又通过profile反向访问） - 把模型拆到多个文件（
models/下分目录），但又不想在顶层models.py里全量 import - 想延迟解析模型，避免启动时加载全部模型类
示例：
class Order(models.Model):
# 不要这样：
# from myapp.models import Customer
# customer = ForeignKey(Customer, on_delete=models.CASCADE)
<pre class="brush:python;toolbar:false;"># 要这样：
customer = ForeignKey('myapp.Customer', on_delete=models.CASCADE)
class Customer(models.Model):
同样，反向关联也用字符串
default_order = ForeignKey('myapp.Order', null=True, on_delete=models.SET_NULL)
把跨模型逻辑移到 managers.py 或 querysets.py，而不是塞进 models.py
很多人习惯在模型里写带 .filter() 的方法，结果一调用就触发其他模型 import。比如 User.get_active_orders() 里写了 Order.objects.filter(user=self)，而 Order 模型还没加载完，就会崩。
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
正确做法是把这类依赖外部模型的查询逻辑抽离：
- 用自定义
Manager，在managers.py里定义，只在需要时才 import 目标模型 - 或用
QuerySet子类，在querysets.py里组织，再挂到 manager 上 - 确保所有 import 都发生在函数/方法体内，而非模块顶层
示例（managers.py）：
class OrderManager(models.Manager):
def for_user(self, user):
from myapp.models import User # ✅ 延迟到调用时才 import
return self.filter(customer=user)
拆分 models.py 时，别让 __init__.py 自动 import 全部模型
有人为了“整洁”把模型按功能拆成 models/user.py、models/order.py，然后在 models/__init__.py 里写 from .user import User; from .order import Order —— 这等于又造了个新的循环入口。Django 加载 models 包时会先执行 __init__.py，里面一 import 就可能触发链式加载。
建议：
- 保持单个
models.py，除非模型数量 > 50 个且职责明显分离 - 真要拆，就不要在
__init__.py做任何 model import；让 app 的apps.py显式声明default_auto_field和name即可 - 如果用了
django.apps.AppConfig.ready()，里面所有 import 必须加 try/except 或延迟到函数内
最常被忽略的一点：字符串引用虽然解决 import 问题，但会让 IDE 无法跳转、类型检查失效。所以别全靠它——该合并的模型别硬拆，该放一起的逻辑别为了“解耦”强行隔离。循环导入本质是设计信号，不是语法补丁能掩盖的。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
