Django后台管理创建与定制完整指南

林舟
林舟
发布时间:2026-10-14| 5人浏览过
原创

本文详细记录Django后台系统的创建流程,涵盖从项目结构分析、App创建、模型设计到数据库迁移的完整步骤。重点讲解后台管理类的高级定制,包括使用装饰器注册模型、重写save_model处理用户归属、动态显示字段、自定义__str__方法,以及通过SimpleListFilter和get_queryset实现高级过滤与列表展示优化。

Django后台创建基础流程

第一步,深入分析目标项目的整体架构,梳理各模块间的依赖与关联,绘制清晰的关系图,为后续开发奠定结构基础。

第二步,执行命令 python manage.py startapp XXX 来创建一个新的应用模块,其中XXX替换为具体的应用名称。

第三步,依据前文梳理的关系图,在models层进行数据模型设计。明确实体间的关系,规划好数据结构,确保数据库设计的合理性与规范性。

第四步,打开项目的settings配置文件,在INSTALLED_APPS列表中添加新创建app的名称,确保Django能正确识别并加载该应用。

第五步,执行命令 python manage.py makemigrations。该命令会根据models层的变更生成对应的迁移文件,记录数据库结构的修改计划。

第六步,执行命令 python manage.py migrate。该命令将实际执行迁移文件中的操作,将数据库结构同步更新,完成数据表的创建或修改。

后台管理类配置与用户创建

第七步,配置后台管理界面。建议采用装饰器方式注册模型,具体实现参考下方代码示例,通过定义Admin类来指定后台显示的各项属性。


@admin.register(模块类名)
class 模块类名Admin(admin.ModelAdmin):
	配置的代码,比如显示什么 等等

第八步,执行命令 python manage.py createsuperuser 创建超级用户。按照提示依次输入用户名、邮箱(可为空)及密码。注意,输入密码时控制台不会显示字符,这是正常的安全机制。

动态字段与显示定制

第九步,在定义models字段时,若需根据请求来源动态设置用户名,可重写save_model方法。具体实现参考下方代码,该方法在保存对象前将当前请求的用户赋值给owner字段。


 def save_model(self, request, obj, form, change):
  obj.owner = request.user
  return super(模块类名Admin, self).save_model(request,obj,form,change)

配置完成后,在list_display列表中引用owner字段,系统便会根据每次请求的不同来源自动获取并显示对应用户信息,实现动态数据展示。

第十步,对于在models中未直接定义但需在后台展示的字段(如当前登录用户),可以通过自定义方法实现。具体做法参考下方代码,在Admin类中定义该方法并返回所需值。


 def 字段名称(self, obj):
  return obj.xxx()

 字段名称.short_description = '文本描述'

接着,在list_display列表中添加该自定义方法的名称,即可在后台列表中直接显示该字段内容,无需修改底层数据模型。


list_display = [
	'name','sex','age','字段名称'
]

第十一步,强烈建议在每个models类中重写__str__方法。该方法决定了对象在后台列表及表单中的默认显示文本,参考下方代码示例,返回关键标识字段以提升可读性。


def __str__(self):
	return self.字段名称

高级过滤器与数据源定制

第十二步,若内置过滤器无法满足需求,可自定义过滤器。核心思路是继承admin.SimpleListFilter类,重写title和parameter_name属性,以及lookups和queryset方法。具体实现参考下方代码,通过筛选queryset实现自定义过滤逻辑。


class 类名Filter(admin.SimpleListFilter):
 """自定义过滤器 """
 title = '分类过滤器'
 parameter_name = 'owner_category'

 def lookups(self, request, model_admin):
  return Category.objects.filter(筛选条件).values_list('参数1,必须是主键', '参数2,显示在界面上的内容')

 def queryset(self, request, queryset):
  category_id = self.value()
  if category_id:
   return queryset.filter(category__id=category_id)
  return queryset


@admin.register(类名)
class 类名Admin(admin.ModelAdmin):
 
 list_filter = [类名Filter]
 

第十三步,若后台列表显示内容(list_display)不符合预期,可通过定制get_queryset方法调整数据源。该方法在生成最终查询集前进行过滤,具体实现参考下方代码,确保展示的数据符合业务逻辑。


 def get_queryset(self, request):
  qs = super(PostAdmin, self).get_queryset(request)
  return qs.filter(筛选条件)

鉴于当前学习进度,编辑页面的具体配置将在后续内容中补充完善,目前主要聚焦于列表展示与基础后台功能。

总结

至此,关于Django后台创建的基本步骤及高级定制技巧已介绍完毕。如需了解更多Django后台相关操作,可查阅本站往期文章或继续浏览后续内容。感谢大家的支持与关注!

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。