虚拟环境下Django makemigrations提示learning_logs无变更如何解决

在激活虚拟环境的Django项目根目录执行迁移生成命令：

(env) PS C:\Users\MadYar\Desktop\code.py\learning_log> python manage.py makemigrations learning_logs

命令返回提示：

No changes detected in app 'learning_logs'

已确认settings.py中已将learning_logs加入INSTALLED_APPS配置：

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'learning_logs'
]

按优先级从高到低排查：

• 检查模型定义合法性
  确认learning_logs/models.py中自定义的模型类必须继承django.db.models.Model，未继承的类不会被Django识别为数据模型，示例正确写法：

  from django.db import models
  
  class YourModelName(models.Model):
      # 你的字段定义
      field_name = models.CharField(max_length=100)
  

  如果你把模型拆分到learning_logs/models/目录下的多个文件中，必须在learning_logs/models/__init__.py中导入所有模型类，否则Django扫描不到对应定义。
• 检查现有迁移文件状态
  打开learning_logs/migrations/目录，如果已经存在0001_initial.py之类的迁移文件，且你之后没有修改过模型字段、新增/删除模型，执行makemigrations返回无变更属于正常现象，直接执行python manage.py migrate应用已有迁移即可。
  执行python manage.py showmigrations learning_logs查看迁移应用状态，前缀为[X]的是已经同步到数据库的迁移，前缀为[ ]的是未同步的迁移，优先把未同步的迁移执行migrate命令应用。
  如果确认模型有修改但扫描不到，执行python manage.py makemigrations learning_logs --verbosity 2查看详细扫描日志，定位Django未读取到模型的具体原因。
• 检查应用目录结构合规性
  确认learning_logs应用根目录下存在__init__.py空文件，缺失该文件Python无法将目录识别为合法包，Django加载应用会失效。
  确认终端当前所在目录是manage.py所在的项目根目录（当前执行路径符合要求），且learning_logs应用目录在Python导包路径下。
  虚拟环境校验：执行pip show django确认当前虚拟环境安装的Django版本与项目适配版本一致，避免多环境版本冲突导致的扫描异常。
• 缓存清理兜底方案
  如果上述排查都没有问题，可以临时将INSTALLED_APPS中的'learning_logs'注释，执行一次python manage.py makemigrations，再取消注释重新执行makemigrations learning_logs命令，即可清除Django对该应用的迁移扫描缓存，正常识别模型变更。

  注意：非必要不要手动删除migrations目录下的文件，随意删除会导致后续迁移记录和数据库状态不匹配，引发更难排查的迁移冲突。

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