在 Flask 中生成报表通常涉及将数据可视化（如图表）或结构化文档（如 PDF、HTML 表格）集成到 Web 应用中，常用的方法包括：结合 Matplotlib 生成静态图表、使用 Plotly 生成交互式图表、利用 ReportLab 或 WeasyPrint 生成 PDF 报表，以及通过模板引擎渲染 HTML 表格,以下从几个方面展开。
使用 Matplotlib 生成图表并嵌入网页
Matplotlib 是 Python 最常用的静态图表库，在 Flask 中，可以将图表保存为图片（如 PNG）并直接嵌入 HTML 模板，或者通过 io.BytesIO 将图片流响应给前端。
基本流程：
- 在视图函数中生成图表。
- 将图表保存到
BytesIO对象。 - 使用
send_file返回图片流，或在模板中用<img>标签引用。
示例：返回图表图片流
from flask import Flask, send_file
import matplotlib.pyplot as plt
import io
import numpy as np
app = Flask(__name__)
@app.route('/chart')
def chart():
# 生成示例数据
x = np.linspace(0, 10, 100)
y = np.sin(x)
plt.plot(x, y)
plt.title("Sine Wave")
# 保存到内存
img = io.BytesIO()
plt.savefig(img, format='png')
img.seek(0)
plt.close()
return send_file(img, mimetype='image/png')
嵌入模板： 将图表保存为临时文件或使用 base64 编码,更常见的是在模板中直接调用图片路由。
使用 Plotly 生成交互式图表
Plotly 支持生成交互式 HTML 图表，通过
plotly.offline.plot 或 plotly.io.to_html 生成可直接嵌入的 HTML 片段。
示例：返回包含图表的 HTML
from flask import Flask, render_template_string
import plotly.express as px
import pandas as pd
app = Flask(__name__)
@app.route('/plotly')
def plotly_chart():
df = pd.DataFrame({
"月份": ["1月", "2月", "3月", "4月"],
"销售额": [100, 150, 130, 170]
})
fig = px.bar(df, x="月份", y="销售额", title="月度销售额")
# 生成 HTML 字符串
plot_html = fig.to_html(full_html=False)
return render_template_string("""
<html>
<body>
{{ plot_html | safe }}
</body>
</html>
""", plot_html=plot_html)
生成 PDF 报表
PDF 报表常用 ReportLab 或 WeasyPrint，ReportLab 可精细控制布局，WeasyPrint 则能将 HTML/CSS 转换为 PDF,适合复杂排版。
使用 ReportLab 生成简单 PDF
from flask import Flask, send_file
from reportlab.pdfgen import canvas
import io
app = Flask(__name__)
@app.route('/pdf')
def pdf_report():
buffer = io.BytesIO()
p = canvas.Canvas(buffer)
p.drawString(100, 750, "销售报表")
p.drawString(100, 700, "2024年1月 3月")
p.save()
buffer.seek(0)
return send_file(buffer, as_attachment=True, download_name='report.pdf', mimetype='application/pdf')
使用 WeasyPrint 将 HTML 模板转为 PDF
from flask import Flask, render_template, request
from weasyprint import HTML
import io
app = Flask(__name__)
@app.route('/html2pdf')
def html_to_pdf():
# 获取渲染后的 HTML 字符串
html = render_template('report.html', data=...)
pdf = HTML(string=html).write_pdf()
return send_file(io.BytesIO(pdf), mimetype='application/pdf', as_attachment=True, download_name='report.pdf')
表格：不同报表生成方式对比
| 方法 | 输出类型 | 交互性 | 适用场景 | 学习曲线 |
|---|---|---|---|---|
| Matplotlib | 图片（PNG/SVG） | 无 | 静态图表、需要定制化 | 中等 |
| Plotly | 交互式 HTML | 高 | 数据探索、仪表盘 | 中等 |
| ReportLab | 无 | 需要精确控制布局的 PDF | 较陡 | |
| WeasyPrint | 无 | 从 HTML 模板生成美观 PDF | 较平缓 | |
| 模板引擎（Jinja2） | HTML 表格 | 无 | 结构化数据展示 | 低 |
注意事项
- 性能：生成复杂图表或 PDF 可能消耗较多资源，可考虑异步任务（如 Celery）或缓存。
- 中文支持：Matplotlib 默认字体不含中文，需要设置中文字体（如
SimHei），ReportLab 也需要注册中文字体。 -
内存管理
：使用plt.close()关闭图形以防内存泄漏。 - 安全性：用户输入需谨慎处理,避免注入。
相关问题与解答
问题 1：如何让 Matplotlib 图表显示中文标签？
解答：需要在代码中指定支持中文的字体。
import matplotlib.pyplot as plt plt.rcParams['font.sans-serif'] = ['SimHei'] # 或 'Microsoft YaHei' plt.rcParams['axes.unicode_minus'] = False # 解决负号显示问题
如果系统没有相应字体，可以下载字体文件并注册：
from matplotlib.font_manager import FontProperties font = FontProperties(fname='path/to/your/font.ttf')'标题', fontproperties=font)
问题 2：在 Flask 中生成 PDF 时，如何将图表（如 Matplotlib 生成的图片）嵌入 PDF？
解答：可以使用两者结合，先用 Matplotlib 生成图片并保存到 BytesIO，再用 ReportLab 的 drawImage 将图片插入 PDF。
# 生成 Matplotlib 图片 img_buffer = io.BytesIO() plt.savefig(img_buffer, format='png') img_buffer.seek(0) # ReportLab 创建 PDF from reportlab.lib.pagesizes import letter from reportlab.pdfgen import canvas pdf_buffer = io.BytesIO() c = canvas.Canvas(pdf_buffer, pagesize=letter) c.drawImage(img_buffer, 100, 500, width=400, height=300) # 调整位置和大小 c.save() pdf_buffer.seek(0)
或者使用 WeasyPrint 时，将图片作为 base64 嵌入 HTML 模板，再转 PDF。
原创文章，发布者：酷盾叔，转转请注明出处：https://www.kd.cn/ask/509256.html
