Django中INSTALLED_APPS两种配置写法的差异及原理

这两种写法都是用来注册base应用，但核心区别在于是否显式指定应用的配置类，具体差异如下：

1. 底层加载逻辑不同 #

• 写'base'时，Django会自动去base/apps.py中查找默认生成的配置类（即BaseConfig），自动关联并实例化这个类完成注册。
• 写'base.apps.BaseConfig'时，是直接明确指定要加载的配置类，Django无需自动查找，直接加载该类完成注册。

2. 自定义配置的生效条件 #

如果需要给应用添加自定义配置（比如修改后台显示名称、设置默认字段类型等），必须使用'base.apps.BaseConfig'写法：
比如在base/apps.py中自定义配置：

from django.apps import AppConfig

class BaseConfig(AppConfig):
    default_auto_field = 'django.db.models.BigAutoField'
    name = 'base'
    verbose_name = '基础管理模块'  # 自定义后台显示名称

此时只有注册'base.apps.BaseConfig'，verbose_name这类自定义配置才会生效；若仅写'base'，自定义配置不会被识别。

3. 初始化操作的触发 #

如果应用需要在启动时执行初始化操作（比如注册信号），通常会把代码放在BaseConfig的ready()方法里：

class BaseConfig(AppConfig):
    # ...其他配置
    def ready(self):
        import base.signals  # 注册应用信号

这种场景下，必须显式注册'base.apps.BaseConfig'，否则ready()方法不会被调用，初始化逻辑无法执行。

4. 规范与扩展性 #

• 简单场景下两种写法都能正常运行，因为startapp命令生成的默认配置类已经绑定了应用名称name='base'。
• Django官方推荐显式指定配置类的写法，尤其是在项目需要扩展功能时，这种写法能让配置逻辑更清晰，避免后续出现隐藏问题。

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