如何在Django Admin页面用自定义Logo替换站点标题？

步骤1：创建Admin模板覆盖目录 #

在你的Django项目根目录下，新建 templates/admin 文件夹。这个目录会用来存放自定义的Admin模板，覆盖Django默认的模板文件。

步骤2：创建/编辑 base_site.html 文件 #

在 templates/admin 目录下新建 base_site.html 文件，写入以下内容：

{% load static %}
{% extends "admin/base.html" %}

{% block branding %}
    <div id="site-name">
        <a href="{% url 'admin:index' %}">
            <img src="{% static 'images/admin-logo.png' %}" alt="后台Logo" style="height: 40px; vertical-align: middle;">
        </a>
    </div>
{% endblock %}

• 把 images/admin-logo.png 替换成你实际的Logo文件路径（比如 assets/logo-admin.png）。
• 可通过调整 style 属性里的 height 值适配Admin顶部高度，避免Logo过大撑开布局。

步骤3：放置Logo到静态文件目录 #

1. 在项目根目录下创建 static 文件夹，按你写的路径存放Logo（比如 static/images/admin-logo.png）。
2. 确保 settings.py 已正确配置静态文件：

STATIC_URL = 'static/'
STATICFILES_DIRS = [BASE_DIR / 'static']

常见问题排查 #

• Logo不显示：检查静态文件路径是否正确，开发环境下刷新页面，看浏览器控制台的资源加载报错；生产环境需运行 python manage.py collectstatic 收集静态文件。
• 样式错位：调整Logo的 height 或添加 margin 属性，对齐顶部导航栏。

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