Django项目中模型是否必须创建在App内？核心目录建模型报错求解

问题背景 #

执行以下命令创建Django项目：

cd dj-container
django-admin startproject core .
django-admin startapp app1

在core目录下创建通用模型Country后，运行makemigrations时触发报错：

RuntimeError: Model class core.models.Country doesn't declare an explicit app_label and isn't in an application in INSTALLED_APPS.

疑问：是否需要将core加入INSTALLED_APPS并配置app_label？或者直接给模型加app_label？还是单独建App存通用表？

解决方案 #

1. 将core注册为常规App（推荐）

core虽然是项目初始化生成的配置目录，但完全可以作为存放通用逻辑的App使用，这是Django项目中很普遍的做法。

• 操作步骤：
  1. 在core目录下新建apps.py，内容参考app1/apps.py：

  from django.apps import AppConfig
  
  class CoreConfig(AppConfig):
      default_auto_field = 'django.db.models.BigAutoField'
      name = 'core'
  

  2. 在项目settings.py的INSTALLED_APPS中加入core：

  INSTALLED_APPS = [
      'django.contrib.admin',
      'django.contrib.auth',
      'django.contrib.contenttypes',
      'django.contrib.sessions',
      'django.contrib.messages',
      'django.contrib.staticfiles',
      'core.apps.CoreConfig',  # 显式注册，更规范
      # 或者直接写 'core' 也可以
      'app1',
  ]
  

• 优势：完全符合Django的App规范，后续通用的模型、工具类、全局视图等都可以放在这里，结构清晰，维护方便。

2. 给模型添加显式app_label（临时方案）

如果不想把core注册为App，可以直接在模型的Meta类中指定app_label：

from django.db import models

class Country(models.Model):
    name = models.CharField(max_length=100)
    # 其他字段定义

    class Meta:
        app_label = 'core'

• 注意：这种方式只能临时解决模型迁移的问题，后续如果在core下添加admin、信号、模板等逻辑，会出现更多不符合App规范的问题，不适合长期使用。

3. 单独创建新App存放通用表（适合大型项目）

创建一个专门的通用App（比如命名为common或base）：

python manage.py startapp common

将Country模型移到common/models.py中，再把common加入INSTALLED_APPS。

• 优势：项目结构划分更清晰，核心配置目录和业务通用逻辑完全分离；适合大型项目，后续通用模块的拆分、复用更方便。

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