异常教程

Django Admin 管理工具（手把手讲解）

更新时间:

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

  • 新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;
  • 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 82w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 2900+ 小伙伴加入学习 ，欢迎点击围观

前言

在 Web 开发领域，Django 作为 Python 的主流框架之一，凭借其“快速开发”和“可扩展性”赢得了广泛认可。而 Django Admin 管理工具，作为 Django 的核心功能之一，就像是一个“可视化控制台”，让开发者无需编写额外代码，就能直接管理数据库中的数据、用户权限和业务逻辑。无论是小型项目还是复杂系统，它都能帮助开发者快速搭建后台管理界面，显著提升开发效率。

对于编程初学者而言，Django Admin 是理解 MVC/MTV 框架模式的绝佳入口；而中级开发者则可以通过其自定义功能，实现更复杂的管理需求。本文将从零开始，通过实际案例和代码示例，深入讲解 Django Admin 的核心功能、自定义技巧，以及如何将其与业务场景结合，让读者既能掌握基础操作，又能探索进阶玩法。

快速入门：搭建你的第一个 Django Admin

1.1 创建项目与模型

首先，我们需要一个 Django 项目和一个简单的模型。假设我们要开发一个博客系统，其中包含 Post（文章）和 Category（分类）两个模型：

from django.db import models

class Category(models.Model):
    name = models.CharField(max_length=100)
    created_at = models.DateTimeField(auto_now_add=True)

    def __str__(self):
        return self.name

class Post(models.Model):
    title = models.CharField(max_length=200)
    content = models.TextField()
    category = models.ForeignKey(Category, on_delete=models.CASCADE)
    published = models.BooleanField(default=False)
    created_at = models.DateTimeField(auto_now_add=True)

1.2 注册模型到 Admin

完成模型定义后，只需在 admin.py 文件中注册模型，即可让 Django Admin 自动生成管理界面：

from django.contrib import admin
from .models import Category, Post

admin.site.register(Category)
admin.site.register(Post)

执行 python manage.py createsuperuser 创建管理员账户后，访问 /admin 路径，即可看到如下的界面：

示意图：Django Admin 默认界面示意图：Django Admin 默认界面

1.3 初体验：增删改查操作

登录 Admin 后，点击 Posts 或 Categories，即可进行以下操作：

  • 添加数据：点击“Add”按钮，填写表单提交即可新建记录。
  • 列表展示：默认显示所有字段，但可能因字段过多导致界面拥挤。
  • 搜索与过滤：顶部搜索栏可快速定位记录，侧边栏支持按分类或状态（如 published）筛选。

比喻：这就像一个“电子表格”，但具备数据库级别的数据校验和权限控制，避免手动操作出错。

自定义管理界面：让 Admin 更贴合业务需求

2.1 ModelAdmin 类：配置管理细节

默认界面可能无法满足复杂需求，此时需要通过 ModelAdmin 类自定义行为。例如，我们希望在文章列表中只显示标题、分类和发布状态，并支持按分类快速筛选：

class PostAdmin(admin.ModelAdmin):
    list_display = ('title', 'category', 'published', 'created_at')
    list_filter = ('category', 'published')
    search_fields = ('title', 'content')

admin.site.register(Post, PostAdmin)

关键点解释：

  • list_display：定义列表页展示的字段。
  • list_filter：在侧边栏添加过滤器。
  • search_fields：启用全局搜索，支持模糊匹配。

比喻：ModelAdmin 就像一个“装修工具包”，允许开发者根据需求重新布置 Admin 的“房间布局”。

2.2 自定义表单与字段显示

某些字段可能需要特殊处理，例如隐藏敏感数据或添加格式化输出。例如，我们希望在文章列表中显示分类的名称，而非数据库的 ID：

class PostAdmin(admin.ModelAdmin):
    # ... 其他配置 ...
    def category_name(self, obj):
        return obj.category.name if obj.category else "未分类"
    category_name.short_description = "分类名称"  # 设置表头标题

    list_display = ('title', 'category_name', 'published', 'created_at')

通过定义方法 category_name，并将其加入 list_display，即可实现字段的动态渲染。

2.3 行内编辑与关联对象管理

如果模型之间存在关联关系（如 Post 与 Category），可以使用 Inline 类实现“行内编辑”。例如，在编辑分类时直接管理其下的文章：

class PostInline(admin.TabularInline):
    model = Post
    extra = 0  # 初始显示的空表单数量

class CategoryAdmin(admin.ModelAdmin):
    inlines = [PostInline]

admin.site.register(Category, CategoryAdmin)

效果：在分类的编辑页面中，会直接显示该分类下的所有文章，无需跳转页面即可修改关联数据。

高级功能：权限控制与自定义动作

3.1 Django 权限系统详解

Django Admin 的权限基于模型的 add, change, delete 操作。例如，要创建一个只能编辑文章但不能删除的用户组：

group, _ = Group.objects.get_or_create(name='文章编辑者')
permission_add = Permission.objects.get(codename='add_post')
permission_change = Permission.objects.get(codename='change_post')
group.permissions.add(permission_add, permission_change)

比喻：权限系统如同“钥匙和锁”，开发者通过组合权限，控制不同用户对数据的操作能力。

3.2 自定义 Admin 动作

假设我们希望批量发布或下架文章，可以定义一个自定义动作：

class PostAdmin(admin.ModelAdmin):
    actions = ['mark_as_published', 'mark_as_unpublished']

    def mark_as_published(self, request, queryset):
        queryset.update(published=True)
    mark_as_published.short_description = "标记为已发布"

    def mark_as_unpublished(self, request, queryset):
        queryset.update(published=False)
    mark_as_unpublished.short_description = "标记为未发布"

执行后，会在 Admin 的操作下拉菜单中新增这两个选项，支持对选中的文章批量修改状态。

优化与扩展：让 Admin 更强大

4.1 使用第三方插件

Django Admin 的生态非常丰富，例如：

  • django-admin-tools：提供仪表盘和主题定制。
  • django-import-export：支持 Excel/CSV 格式的数据导入导出。

安装后，只需简单配置即可扩展功能：

pip install django-import-export

from import_export.admin import ImportExportModelAdmin

@admin.register(Post)
class PostAdmin(ImportExportModelAdmin):
    pass

4.2 自定义模板与样式

如果需要彻底改造 Admin 界面，可以覆盖其模板。例如，修改登录页面的标题：

  1. 在项目模板目录下创建 admin/login.html：
{% extends "admin/login.html" %}
{% block title %}博客后台登录{% endblock %}
  1. 在 settings.py 中配置模板路径：
TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [BASE_DIR / 'templates'],  # 添加模板目录
        ...
    },
]

结论

Django Admin 管理工具凭借其开箱即用的特性，已成为 Django 开发者的“得力助手”。从基础的数据管理到复杂的权限控制，它既能降低开发门槛，又能满足企业级应用需求。通过本文的案例和代码示例，读者可以掌握从快速搭建到深度定制的全套技能。

对于初学者，建议从简单模型开始实践，逐步探索 Admin 的配置选项；中级开发者则可以尝试结合第三方插件或自定义模板，打造个性化的管理后台。记住，Django Admin 不仅是一个工具，更是一种“快速迭代”的思维方式——通过最小化重复劳动，让开发者专注于业务逻辑的实现。

希望本文能帮助你解锁 Django Admin 的全部潜力！

最新发布

查看更多文章