报表制作实战：Excel/PDF 导出与前端可视化图表

在 Web 项目中，报表是数据的可视化呈现形式（报表 = 多样的格式 + 动态的数据）。本节课将基于 Django 实现三类核心报表功能：Excel 文件导出、PDF 文件导出、前端 ECharts 统计图表，满足不同场景下的数据展示需求。

一、导出 Excel 报表

报表就是用表格、图表等格式来动态显示数据，所以有人用这样的公式来描述报表：

报表 = 多样的格式 + 动态的数据

Excel 报表适合数据批量下载、离线分析，我们选用xlwt库（轻量、性能优，仅支持 xls 格式）实现教师信息 Excel 导出。

1. 1. 安装依赖

pip install xlwt

1. 2. 编写 Excel 导出视图函数

defexport_teachers_excel(request):# 创建工作簿    wb = xlwt.Workbook()# 添加工作表    sheet = wb.add_sheet('老师信息表')# 查询所有老师的信息    queryset = Teacher.objects.all()# 向Excel表单中写入表头    colnames = ('姓名', '介绍', '好评数', '差评数', '学科')for index, name inenumerate(colnames):        sheet.write(0, index, name)# 向单元格中写入老师的数据    props = ('name', 'detail', 'good_count', 'bad_count', 'subject')for row, teacher inenumerate(queryset):for col, prop inenumerate(props):            value = getattr(teacher, prop, '')ifisinstance(value, Subject):                value = value.name            sheet.write(row + 1, col, value)# 保存Excel    buffer = BytesIO()    wb.save(buffer)# 将二进制数据写入响应的消息体中并设置MIME类型    resp = HttpResponse(buffer.getvalue(), content_type='application/vnd.ms-excel')# 中文文件名需要处理成百分号编码    filename = quote('老师.xls')# 通过响应头告知浏览器下载该文件以及对应的文件名    resp['content-disposition'] = f'attachment; filename*=utf-8\'\'{filename}'return resp

1. 3. 配置 URL 路由

urlpatterns = [    path('excel/', views.export_teachers_excel),]

核心优化说明

• • select_related('subject')：关联查询学科，避免循环中多次查询数据库（N+1 问题）；
• • BytesIO：内存中操作文件，无需生成临时文件，提升性能；
• • quote()：处理中文文件名，避免浏览器解析乱码；
• • 表头样式：可选配置，提升 Excel 可读性。

二、导出 PDF 报表

1. 1. 安装依赖

# 安装reportlab库（PDF生成核心库）pip install reportlab

1. 2. 编写 PDF 导出视图函数

defexport_pdf(request: HttpRequest) -> HttpResponse:    buffer = io.BytesIO()    pdf = canvas.Canvas(buffer)    pdf.setFont("Helvetica", 80)    pdf.setFillColorRGB(0.2, 0.5, 0.3)    pdf.drawString(100, 550, 'hello, world!')    pdf.showPage()    pdf.save()    resp = HttpResponse(buffer.getvalue(), content_type='application/pdf')    resp['content-disposition'] = 'inline; filename="demo.pdf"'return resp

1. 3. 配置 URL 路由

urlpatterns = [# 其他路由...    path('export/pdf/', views.export_teachers_pdf, name='export_pdf'),  # PDF导出]

关键说明

• • 字体问题：reportlab默认无中文字体，需指定系统存在的中文字体（如SimSun宋体、Microsoft YaHei微软雅黑）；
• • 页面布局：canvas：适合自定义位置绘制（如报表、证件），灵活度高；SimpleDocTemplate：适合流式文档（如长文本、列表），自动分页；
• • 响应头配置：inline：浏览器在线预览 PDF；attachment：强制下载 PDF 文件。

三、生成前端统计图表

前端图表适合数据可视化展示（柱状图、折线图、饼图等），我们使用百度 ECharts（开源、易用）实现教师好评 / 差评统计。

1. 1. 编写数据接口视图

defget_teachers_data(request):    queryset = Teacher.objects.all()    names = [teacher.name for teacher in queryset]    good_counts = [teacher.good_count for teacher in queryset]    bad_counts = [teacher.bad_count for teacher in queryset]return JsonResponse({'names': names, 'good': good_counts, 'bad': bad_counts})

1. 2. 配置 URL 路由

urlpatterns = [    path('teachers_data/', views.get_teachers_data),]

1. 3. 编写前端图表页面（ECharts）