Django模块化唯一合法单位是通过django-admin startapp生成的App，必须注册到INSTALLED_APPS，且每个App需独立包含models.py、views.py等文件；跨App引用模型须用字符串（如'orders.Order'），外键to参数禁用类引用，related_name和app_name须带App前缀以防冲突。
App 是 Django 模块化的唯一合法单位
不是靠文件夹、包名或 import 路径来划分边界，Django 的模块化强制绑定在 django-admin startapp 生成的 App 上。每个 App 必须有独立的 models.py、views.py、apps.py，且必须注册到 INSTALLED_APPS 才能被识别。漏注册会导致 CommandError: App 'xxx' could not be found 或迁移失败。
- 一个 App 对应一个业务域（如
orders、payments），不是按技术分层（比如别建api或utils这种通用 App） - 跨 App 引用模型时，必须用字符串形式（
'orders.Order'），避免循环导入；直接 import 类会破坏启动顺序 -
apps.py中的default_app_config已废弃，Django 3.2+ 只认AppConfig.name和label，改错会导致LookupError: No installed app with label 'xxx'
models.py 里不能跨 App 定义外键关系
外键、多对多、一对一字段的 to 参数必须是字符串（'auth.User'），不能写成 User 类本身——哪怕你已经 from django.contrib.auth.models import User。否则在 App 加载顺序不确定时，会触发 RuntimeError: Model class xxx doesn't declare an explicit app_label。
- 反向关系名（
related_name）要带 App 前缀，比如related_name='orders_orderitem_set'，否则多个 App 都引用Order时会冲突 - 如果两个 App 都需要访问同一张表（比如共享用户配置），不要复制模型，用
ForeignKey('auth.User', ...)或抽象基类 +Meta.app_label控制归属 - 迁移文件生成后，检查
dependencies字段是否包含其他 App 的最新迁移号，缺失会导致django.db.migrations.exceptions.InconsistentMigrationHistory
URL 分发必须按 App 组织，不能全堆在主 urls.py
主 urls.py 只保留 admin/、api/ 这类顶层入口，其余全部用 include() 接入各 App 自己的 urls.py。硬编码路径（如 path('orders/list/', ...)）会污染主路由，让 App 失去可插拔性。
- 每个 App 的
urls.py必须定义app_name = 'orders'，否则{% url 'list' %}会找不到命名空间 - 模板里用
{% url 'orders:list' %}，而不是{% url 'list' %}—— 后者在多个 App 都有list时必然出错 - 如果 App 内部需要重定向到另一个 App 的视图，用
reverse('payments:confirm')，别拼接字符串 URL，否则改路径时全挂
静态文件和模板路径天然隔离，但命名容易撞车
Django 按 App 名搜索 static/ 和 templates/ 子目录，所以 myproject/orders/static/css/style.css 和 myproject/payments/static/css/style.css 不会冲突。但模板文件名一旦重复（比如都叫 detail.html），Django 会按 INSTALLED_APPS 顺序取第一个匹配项，导致渲染错页面。
- 模板路径必须带 App 名前缀：
templates/orders/detail.html，调用时写return render(request, 'orders/detail.html') - 静态文件引用统一用
{% static 'orders/css/style.css' %}，别省略 App 目录名，否则压缩工具（如 Whitenoise）可能找不到资源 - 第三方 App（如
django-allauth）的模板会被自动加载，如果本地覆盖了同名模板（如templates/account/login.html），就等于接管了它的 UI，升级时需手动比对变更
事情说清了就结束。最常被忽略的是 app_name 和 related_name 的命名规范——它们不报错，但会让协作和后期维护成本翻倍。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
