Django如何迁移同一应用下其他Python文件中定义的模型

Django默认只会扫描每个已注册app下models模块内定义的模型，只要把这个识别入口打通，后续迁移、使用的逻辑和把模型全写在默认models.py里没有任何区别，具体操作步骤如下：

1. 打通模型识别入口 #

不管你把模型拆分到同app下的model123.py还是其他命名的独立py文件，第一步都要把这些模型显式导入到app的models模块入口，让Django的ORM能扫描到。
举个最常见的场景，你的app目录结构如下：

your_app/
  __init__.py
  admin.py
  apps.py
  model123.py  # 存放拆分后模型的独立文件
  models.py    # Django默认的模型入口文件
  views.py
  migrations/

直接打开your_app/models.py，把你在model123.py里定义的所有模型类导入进来即可：

# your_app/models.py
from .model123 import YourModel1, YourModel2, YourModel3  # 替换为你自己定义的模型类名

如果你的app模型总量很大，也可以把单文件的models.py替换为名为models的Python包：新建models文件夹，在文件夹内建空的__init__.py，把model123.py和其他拆分的模型文件都放进这个文件夹，最后在__init__.py里统一导入所有模型即可，效果和上面的操作完全一致。

注意：模型的导入路径一旦确定，生成完初始迁移后就不要随意改动，否则Django会判定为“删除旧模型、新增同名新模型”，生成冗余迁移文件，甚至引发数据丢失问题。

2. 执行数据库迁移 #

完成上面的导入步骤后，迁移操作和你之前的使用习惯完全一致，不需要加任何额外参数：

• 先生成迁移文件：
  python manage.py makemigrations your_app_name
• 再执行迁移同步到数据库：
  python manage.py migrate

如果执行makemigrations时检测不到你拆分的模型，逐一排查三个常见问题：

• 你的app是否已经添加到项目settings.py的INSTALLED_APPS列表中
• 拆分文件里的模型类是否正确继承了django.db.models.Model
• 模型是否正确导入到models模块入口，有没有出现循环导入报错

3. 日常调用模型 #

所有业务场景下都不需要直接从model123.py导入模型，统一从app的models模块导入即可，和之前的用法完全兼容：

• 视图、业务逻辑、序列化器中导入模型：
  from your_app.models import YourModel1, YourModel2
• admin后台注册模型时用同样的导入路径：

  from django.contrib import admin
  from your_app.models import YourModel1
  admin.site.register(YourModel1)
  

• 定义外键、多对多关联关系时，字符串引用规则不变，比如models.ForeignKey("your_app.YourModel1", on_delete=models.CASCADE)即可正常生效。

如果遇到循环导入报错（比如拆分的模型和models.py里的模型互相引用），优先用字符串形式写关联字段，不要直接导入模型类；如果依赖关系复杂，建议把存在强关联的模型放到同一个文件下，从根源上避免循环导入问题。

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