Django无法覆盖Admin基础模板：自定义面板图标无效求助

云原生阿岚

2026-6-26

Django Admin模板未生效排查方案

检查INSTALLED_APPS顺序
打开settings.py，确认你的自定义应用排在django.contrib.admin之前。Django模板查找会遵循INSTALLED_APPS的顺序，若你的应用在django.contrib.admin后面，系统会优先加载官方自带的base_site.html，导致自定义模板无法生效。示例配置：
```
INSTALLED_APPS = [
    'your_custom_app',  # 自定义应用放在最前面
    'django.contrib.admin',
    # 其他应用...
]
```
验证模板目录结构
确保base_site.html的路径完全正确：your_custom_app/templates/admin/base_site.html。注意your_custom_app必须是INSTALLED_APPS中注册的应用名称，避免出现冗余目录（比如app/templates/admin/templates/base_site.html这类错误结构）。
清除模板缓存
- 开发环境：重启Django开发服务器，同时删除项目根目录和应用目录下的__pycache__文件夹。
- 生产环境：若启用了模板缓存，执行python manage.py clearcache，或重启应用服务器，确保新模板被加载。

确认AdminSite使用方式
若你自定义了AdminSite类，需在urls.py中注册自己的实例，而非默认的admin.site.urls。示例：

# admin.py
from django.contrib.admin import AdminSite

class CustomAdminSite(AdminSite):
    site_header = 'Custom Admin'

custom_admin = CustomAdminSite(name='custom_admin')

# urls.py
from .admin import custom_admin

urlpatterns = [
    path('admin/', custom_admin.urls),
]

若使用默认AdminSite，需确保没有其他配置覆盖了模板路径。