Django Admin 实现 CSV 导出功能的完整指南

纸上星河

发布时间：2026-10-13| 6人浏览过

原创

本文详细解析如何在 Django Admin 中为模型列表添加 CSV 数据导出功能。通过定义自定义 Action 并封装为 Mixin 类，实现代码复用。文章提供了从注册动作到生成响应文件的完整代码示例，帮助开发者快速掌握 Django 后台数据导出技巧。

Django Admin 添加 CSV 导出功能教程

本文参考了 https://books.agiliq.com/projects/django-admin-cookbook/en/latest/export.html 中的相关资源。

在使用 Django Admin 后台管理时，经常需要为用户提供数据导出功能，以便将列表数据保存为本地文件，具体效果可参考下图所示界面。

接下来将介绍如何为 Django Admin 添加导出 CSV 的功能。

在 Django Admin 中，每个模型的 Admin 类（继承自 admin.ModelAdmin）都支持通过 actions 属性注册自定义操作，该属性的值应为当前类中定义的方法名，例如：


.......
@admin.register(Issue)
class IssueAdmin(admin.ModelAdmin):
  ......
  actions = ['export_as_csv'] # 增加动作, 对应相应的方法名
  def export_as_csv(self, request, queryset): # 具体的导出csv方法的实现
    pass
  export_as_csv.short_description = '导出CSV' # 该动作在admin中的显示文字

以下是导出 CSV 方法的具体实现细节：


  def export_as_csv(self, request, queryset):
    meta = self.model._meta # 用于确定导出的文件名, 格式为: app名.模型类名
    field_names = [field.name for field in meta.fields] # 所有属性名

    response = HttpResponse(content_type='text/csv')  # 指定响应内容类型
    response['Content-Disposition'] = f'attachment; filename={meta}.csv'
    response.charset = 'utf-8-sig' # 可选, 修改编码为带BOM的utf-8格式(Excel打开不会有乱码)
    writer = csv.writer(response)
    writer.writerow(field_names) # 将属性名写入csv
    for obj in queryset: # 遍历要导出的对象列表
      row = writer.writerow([getattr(obj, field) for field in field_names]) # 将当前对象的各属性值写入csv
    return response

由于导出 CSV 的功能通常适用于多个模型，我们可以将其封装为一个 Mixin 类以便复用，完整的代码实现如下：


import csv
from django.contrib import admin
from django.http import HttpResponse
from .models import Issue
class ExportCsvMixin(object):
  def export_as_csv(self, request, queryset):
    meta = self.model._meta
    field_names = [field.name for field in meta.fields]
    response = HttpResponse(content_type='text/csv')
    response['Content-Disposition'] = f'attachment; filename={meta}.csv'
    response.charset = 'utf-8-sig'
    writer = csv.writer(response)
    writer.writerow(field_names)
    for obj in queryset:
      row = writer.writerow([getattr(obj, field) for field in field_names])
    return response
  export_as_csv.short_description = '导出CSV'
@admin.register(Issue)
class IssueAdmin(admin.ModelAdmin, ExportCsvMixin):
  fields = ('key', 'summary', 'status', 'project',
       'origin', 'components', 'prj_level', 'prj_category',
       'assignee', 'origin_person', 'pm', 'dev_manager', 'test_manager', 'tester', 'fe_dev', 'backend_dev',
       'plan_begin', 'plan_end', 'fe_plan_begin', 'fe_plan_end', 'test_plan_begin',
       'test_plan_end', 'backend_plan_begin', 'backend_plan_end',
       'created', 'reopen', 'prd_begin', 'prd_end', 'dev_begin', 'dev_end',
       'test_begin', 'test_end', 'pm_check', 'ready', 'pause', 'done',
       'pm_take', 'dev_take', 'test_take', 'total_take',
       'tags',
       )
  readonly_fields = fields
  list_display = ('key', 'summary', 'status', 'origin', 'components', 'created', 'visit')
  list_filter = ('origin', 'components', 'status', 'tags')
  search_fields = ('key', 'summary')
  date_hierarchy = 'created'
  actions = ['export_as_csv']

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持本站。