Django无法识别自定义models模块问题该如何解决？

1. 确认App已注册 #

• 首先检查项目settings.py中的INSTALLED_APPS列表，必须将包含models模块的对应App完整注册，仅注册models子模块无效。
  示例配置：

INSTALLED_APPS = [
    # 其他内置App
    'your_app_name', # 替换为你的实际App名称
]

2. 检查models目录结构与导入规则 #

标准拆分后的models目录结构如下：

your_app_name/
├── __init__.py
├── apps.py
└── models/
    ├── __init__.py # 必须存在，标识为Python包
    ├── user.py # 自定义模型文件，可按业务拆分多个
    └── order.py

• 重点检查models/__init__.py的导入写法：必须显式导入所有需要暴露的模型类，不能仅导入模型文件模块
  正确写法示例：

from .user import User, UserProfile
from .order import Order, OrderItem

错误写法（无法被Django识别）：

from . import user
from . import order

3. 补全模型类的关联配置 #

如果上述配置正常仍无法识别，可在每个拆分的模型类的Meta属性中显式指定所属App：

from django.db import models

class Order(models.Model):
    # 字段定义略
    class Meta:
        app_label = 'your_app_name' # 替换为实际所属App的名称

4. 验证导入与重置迁移 #

• 先通过Django Shell手动验证导入是否正常，执行python manage.py shell后输入导入命令：from your_app_name.models import 你的模型类名，根据报错信息可直接定位语法错误、命名冲突等问题。
• 若之前生成过错误的迁移文件，需先清理：删除App下migrations目录中除__init__.py外的所有文件，同时删除数据库中django_migrations表内对应App的迁移记录，再重新执行迁移命令：

python manage.py makemigrations your_app_name
python manage.py migrate

常见踩坑点 #

• 模型类未继承django.db.models.Model，Django不会将其识别为数据表模型
• models目录或模型文件命名和Django内置模块、第三方依赖重名，导致导入被覆盖
• models/__init__.py存在语法错误，导致Django加载时跳过整个models包

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