Python + Spire.PDF：从JSON自动生成专业PDF报表教

脚本专家

在企业日常运营中，JSON 格式的数据广泛应用于 API 接口、配置文件和数据交换场景。但将结构化的 JSON 数据转换为适合阅读和分发的 PDF 报告，往往需要手动复制粘贴或借助复杂的模板工具，不仅效率低下，还容易出现格式错乱、数据遗漏。对于需要定期生成财务报表、项目进度报告、客户信息汇总等场景，自动化生成 PDF 文档成为提升工作效率的关键需求。

本文将介绍如何使用 Python 从 JSON 数据自动生成格式规范的 PDF 文档，所有代码基于 Free Spire.PDF for Python（

2. pip install spire.pdf.free

复制代码

）。整个过程完全自动化，无需人工干预，适用于业务报表生成、数据归档、合同附件制作、API 数据可视化等场景。你可以灵活控制文档布局、字体样式、表格结构和页面元素，确保生成的 PDF 专业美观。

---

一、准备 JSON 数据并创建 PDF 文档

首先定义示例 JSON 数据（以销售数据报告为例，包含产品信息、销售记录和统计摘要），并初始化 PDF 文档对象。

2. import json
3. from spire.pdf import PdfDocument, PdfPageBase
4. from spire.pdf.graphics import *
6. json_data = """
7. {
8.     "report_title": "2024年第一季度销售报告",
9.     "company": "ABC科技有限公司",
10.     "date": "2024-03-31",
11.     "summary": {
12.         "total_sales": 1580000,
13.         "total_orders": 342,
14.         "average_order_value": 4619.88
15.     },
16.     "products": [
17.         {"name": "笔记本电脑", "category": "电子产品", "quantity": 120, "unit_price": 5999, "total": 719880},
18.         {"name": "无线鼠标", "category": "配件", "quantity": 450, "unit_price": 89, "total": 40050},
19.         {"name": "机械键盘", "category": "配件", "quantity": 280, "unit_price": 399, "total": 111720},
20.         {"name": "显示器", "category": "电子产品", "quantity": 95, "unit_price": 2499, "total": 237405},
21.         {"name": "USB集线器", "category": "配件", "quantity": 600, "unit_price": 59, "total": 35400}
22.     ]
23. }
24. """
25. data = json.loads(json_data)
26. doc = PdfDocument()
27. page = doc.Pages.Add()

复制代码

2. json.loads()

复制代码

将 JSON 字符串解析为 Python 字典。

2. PdfDocument()

复制代码

创建 PDF 文档对象，

2. Pages.Add()

复制代码

添加新页面。示例数据包含报告标题、公司信息、统计摘要和产品列表，模拟真实业务场景。

---

二、绘制文档标题和公司信息

在页面顶部绘制报告标题和公司基本信息，建立文档的整体框架。

2. def draw_header(page, data):
3.     margin_left = 50
4.     margin_top = 50
5.     y_position = margin_top
7.     company_font = PdfTrueTypeFont("Arial", 14.0, PdfFontStyle.Bold, True)
8.     company_brush = PdfSolidBrush(PdfRGBColor(Color.get_DarkGray()))
9.     page.Canvas.DrawString(data["company"], company_font, company_brush, margin_left, y_position)
10.     y_position += 25
12.     title_font = PdfTrueTypeFont("Arial", 24.0, PdfFontStyle.Bold, True)
13.     title_brush = PdfSolidBrush(PdfRGBColor(Color.get_Navy()))
14.     title_format = PdfStringFormat(PdfTextAlignment.Left)
15.     page.Canvas.DrawString(data["report_title"], title_font, title_brush, margin_left, y_position, title_format)
16.     y_position += 35
18.     date_font = PdfTrueTypeFont("Arial", 11.0, PdfFontStyle.Regular, True)
19.     date_brush = PdfSolidBrush(PdfRGBColor(Color.get_Gray()))
20.     page.Canvas.DrawString(f"报告日期：{data['date']}", date_font, date_brush, margin_left, y_position)
21.     return y_position + 30
23. current_y = draw_header(page, data)

复制代码

2. PdfTrueTypeFont

复制代码

设置字体名称、大小和样式（如 Bold）。

2. PdfSolidBrush

复制代码

定义文本颜色，

2. DrawString

复制代码

在指定坐标绘制文本，可配合

2. PdfStringFormat

复制代码

设置对齐方式。通过递增 y_position 实现垂直布局，避免重叠。

---

三、绘制统计摘要信息

在标题下方展示关键的业务统计数据，以简洁方式呈现核心指标。

2. def draw_summary(page, data, y_position):
3.     margin_left = 50
4.     summary = data["summary"]
6.     section_font = PdfTrueTypeFont("Arial", 16.0, PdfFontStyle.Bold, True)
7.     section_brush = PdfSolidBrush(PdfRGBColor(Color.get_Black()))
8.     page.Canvas.DrawString("销售摘要", section_font, section_brush, margin_left, y_position)
9.     y_position += 30
11.     content_font = PdfTrueTypeFont("Arial", 11.0, PdfFontStyle.Regular, True)
12.     content_brush = PdfSolidBrush(PdfRGBColor(Color.get_Black()))
13.     summary_items = [
14.         f"总销售额：¥{summary['total_sales']:,.2f}",
15.         f"订单总数：{summary['total_orders']}",
16.         f"平均订单价值：¥{summary['average_order_value']:,.2f}"
17.     ]
18.     for item in summary_items:
19.         page.Canvas.DrawString(item, content_font, content_brush, margin_left, y_position)
20.         y_position += 22
21.     return y_position + 20
23. current_y = draw_summary(page, data, current_y)

复制代码

使用 f-string 格式化数字，

2. :,

复制代码

添加千位分隔符，

2. .2f

复制代码

保留两位小数。摘要信息逐行排列，间隔 22 个单位，形成清晰的信息层级。

---

四、创建产品明细表格

表格是展示结构化数据的最佳方式。将 JSON 中的产品列表转换为 PDF 表格，包含表头和数据行。

2. def draw_product_table(page, data, y_position):
3.     margin_left = 50
4.     products = data["products"]
6.     table_title_font = PdfTrueTypeFont("Arial", 16.0, PdfFontStyle.Bold, True)
7.     table_title_brush = PdfSolidBrush(PdfRGBColor(Color.get_Black()))
8.     page.Canvas.DrawString("产品明细", table_title_font, table_title_brush, margin_left, y_position)
9.     y_position += 30
11.     columns = ["产品名称", "类别", "数量", "单价", "总价"]
12.     column_widths = [120, 100, 80, 100, 100]
14.     header_font = PdfTrueTypeFont("Arial", 11.0, PdfFontStyle.Bold, True)
15.     header_brush = PdfSolidBrush(PdfRGBColor(Color.get_White()))
16.     header_bg_brush = PdfSolidBrush(PdfRGBColor(Color.get_Navy()))
17.     x_position = margin_left
18.     for i, col in enumerate(columns):
19.         rect = RectangleF(x_position, y_position, column_widths[i], 25)
20.         page.Canvas.DrawRectangle(header_bg_brush, rect)
21.         page.Canvas.DrawString(col, header_font, header_brush, x_position + 5, y_position + 5)
22.         x_position += column_widths[i]
23.     y_position += 25
25.     row_font = PdfTrueTypeFont("Arial", 10.0, PdfFontStyle.Regular, True)
26.     row_brush = PdfSolidBrush(PdfRGBColor(Color.get_Black()))
27.     alternate_brush = PdfSolidBrush(PdfRGBColor(Color.get_LightGray()))
28.     for idx, product in enumerate(products):
29.         bg_brush = PdfSolidBrush(PdfRGBColor(Color.get_White())) if idx % 2 == 0 else alternate_brush
30.         x_position = margin_left
31.         row_height = 22
32.         row_rect = RectangleF(margin_left, y_position, sum(column_widths), row_height)
33.         page.Canvas.DrawRectangle(bg_brush, row_rect)
34.         cell_data = [
35.             product["name"],
36.             product["category"],
37.             str(product["quantity"]),
38.             f"¥{product['unit_price']:,}",
39.             f"¥{product['total']:,}"
40.         ]
41.         for i, cell_value in enumerate(cell_data):
42.             page.Canvas.DrawString(cell_value, row_font, row_brush, x_position + 5, y_position + 4)
43.             x_position += column_widths[i]
44.         y_position += row_height
46.     border_pen = PdfPen(PdfRGBColor(Color.get_Black()), 0.5)
47.     table_width = sum(column_widths)
48.     table_height = 25 + len(products) * 22
49.     page.Canvas.DrawRectangle(border_pen, RectangleF(margin_left, y_position - table_height, table_width, table_height))
50.     # 横线
51.     for i in range(len(products) + 2):
52.         if i == 0:
53.             line_y = y_position - table_height
54.         elif i == 1:
55.             line_y = y_position - table_height + 25
56.         else:
57.             line_y = y_position - table_height + 25 + (i - 1) * 22
58.         page.Canvas.DrawLine(border_pen, margin_left, line_y, margin_left + table_width, line_y)
59.     # 竖线
60.     x_pos = margin_left
61.     for width in column_widths:
62.         page.Canvas.DrawLine(border_pen, x_pos, y_position - table_height, x_pos, y_position)
63.         x_pos += width
64.     page.Canvas.DrawLine(border_pen, x_pos, y_position - table_height, x_pos, y_position)
65.     return y_position + 30
67. current_y = draw_product_table(page, data, current_y)

复制代码

表格采用表头深色背景、白色文字的设计，数据行使用交替背景色（白色和浅灰色），提升视觉区分度。

2. RectangleF

复制代码

用于绘制矩形区域，

2. DrawLine

复制代码

绘制横线和竖线形成网格。列宽根据内容长度合理分配。

---

五、添加页脚信息

在页面底部添加页脚，包含页码和版权信息，使文档更完整专业。

2. def draw_footer(page, page_number, total_pages):
3.     page_width = page.Canvas.ClientSize.Width
4.     margin_bottom = 30
5.     line_pen = PdfPen(PdfRGBColor(Color.get_LightGray()), 0.5)
6.     page.Canvas.DrawLine(line_pen, 50, page.Canvas.ClientSize.Height - margin_bottom - 15, page_width - 50, page.Canvas.ClientSize.Height - margin_bottom - 15)
7.     footer_font = PdfTrueTypeFont("Arial", 9.0, PdfFontStyle.Regular, True)
8.     footer_brush = PdfSolidBrush(PdfRGBColor(Color.get_Gray()))
9.     footer_format = PdfStringFormat(PdfTextAlignment.Center)
10.     page_text = f"第 {page_number} 页 / 共 {total_pages} 页"
11.     page.Canvas.DrawString(page_text, footer_font, footer_brush, page_width / 2, page.Canvas.ClientSize.Height - margin_bottom, footer_format)
12.     copyright_text = "© 2024 ABC科技有限公司 - 内部资料，请勿外传"
13.     page.Canvas.DrawString(copyright_text, footer_font, footer_brush, page_width / 2, page.Canvas.ClientSize.Height - margin_bottom + 15, footer_format)
15. draw_footer(page, 1, 1)

复制代码

页脚包含水平分隔线、页码和版权声明，居中对齐，字体较小颜色较浅，不影响主内容。

---

六、保存 PDF 文档

2. output_file = "销售报告.pdf"
3. doc.SaveToFile(output_file)
4. doc.Close()
5. print(f"PDF 文档已生成：{output_file}")

复制代码

2. SaveToFile

复制代码

将内存中的 PDF 文档保存到文件系统，

2. Close

复制代码

释放资源。

---

关键类与方法解析

主要类说明

• PdfDocument：PDF 文档对象，管理整个文档生命周期
  
• PdfPageBase：页面对象，提供画布用于绘制内容
  
• PdfTrueTypeFont：字体类，设置字体名称、大小、样式
  
• PdfSolidBrush：画刷类，定义填充颜色
  
• PdfPen：画笔类，定义线条颜色和宽度
  
• PdfStringFormat：文本格式类，设置对齐方式等
  
• RectangleF：矩形结构，定义绘制区域
  
• PdfRGBColor：颜色类，支持 RGB 色彩模式
  

常用方法

• 2. doc.Pages.Add()

  复制代码
  ：添加新页面
  
• 2. page.Canvas.DrawString(text, font, brush, x, y, format)

  复制代码
  ：绘制文本
  
• 2. page.Canvas.DrawRectangle(brush/pen, rectangle)

  复制代码
  ：绘制矩形
  
• 2. page.Canvas.DrawLine(pen, x1, y1, x2, y2)

  复制代码
  ：绘制直线
  
• 2. doc.SaveToFile(filename)

  复制代码
  ：保存文档
  
• 2. doc.Close()

  复制代码
  ：关闭文档释放资源
  

字体与样式设置

2. # 创建字体
3. font = PdfTrueTypeFont("Arial", 12.0, PdfFontStyle.Bold, True)
4. # 参数：字体名称、字号、样式（Bold/Italic/Regular/Underline）、是否嵌入
6. # 创建画刷
7. brush = PdfSolidBrush(PdfRGBColor(Color.get_Navy()))
8. # 支持的颜色：get_Black(), get_White(), get_Red(), get_Blue(), get_Navy() 等
10. # 创建画笔
11. pen = PdfPen(PdfRGBColor(Color.get_Black()), 0.5)
13. # 设置文本格式
14. format = PdfStringFormat(PdfTextAlignment.Center, PdfVerticalAlignment.Middle)

复制代码

布局技巧

• 垂直布局：递增 y 坐标实现从上到下排列
  
• 水平布局：递增 x 坐标实现从左到右排列
  
• 边距控制：设置 margin_left、margin_top 等变量统一管理
  
• 间距调整：根据字体高度和内容重要性调整行间距
  

---

扩展应用场景

1. 多页文档支持
当数据量较大时，需自动分页：

2. if current_y > page.Canvas.ClientSize.Height - 100:
3.     page = doc.Pages.Add()
4.     current_y = 50

复制代码

2. 从文件读取 JSON

2. with open('sales_data.json', 'r', encoding='utf-8') as f:
3.     data = json.load(f)

复制代码

3. 添加图表可视化（简单柱状图）

2. for i, product in enumerate(products):
3.     bar_height = product['total'] / 10000
4.     bar_rect = RectangleF(margin_left + i * 60, chart_y, 50, bar_height)
5.     page.Canvas.DrawRectangle(bar_brush, bar_rect)

复制代码

4. 批量生成报告

2. import glob
3. for json_file in glob.glob('reports/*.json'):
4.     with open(json_file, 'r') as f:
5.         data = json.load(f)
6.     generate_pdf(data, f"report_{json_file}.pdf")

复制代码

5. 自定义模板系统

2. class PDFTemplate:
3.     def __init__(self, config):
4.         self.font_config = config['fonts']
5.         self.color_scheme = config['colors']
6.         self.layout = config['layout']
7.     def render(self, data):
8.         # 根据配置渲染 PDF
9.         pass

复制代码

---

总结

通过本文示例，你已掌握使用 Python 从 JSON 数据自动生成专业 PDF 文档的完整流程：解析 JSON 数据结构 → 绘制标题、摘要、表格和页脚 → 保存文件。整个过程完全自动化，特别适用于业务报表、数据归档和文档分发场景。

相比手动制作 PDF，代码方式具有显著优势：高效性（一键生成）、一致性（统一格式和样式）、灵活性（根据数据动态调整布局）、可扩展性（轻松集成到现有系统）。在此基础上，可以进一步探索添加水印、加密文档、插入图像、生成目录等高级功能，为企业级文档自动化提供完整解决方案。

热心网友6

感谢分享，这个教程非常实用！我之前手工做报表经常出格式问题，正需要这种自动化的方案。想请教一下，示例里的 JSON 包含中文内容，代码中用 Arial 字体绘制标题，但 Arial 对中文支持可能不够完整，是否需要额外加载中文字体文件才能正常显示？另外期待后续完整代码，特别是表格和统计数据的绘制部分，想看看具体怎么布局。

热心网友6

感谢分享这个实用的自动化方案！用 JSON 直接生成 PDF 报表确实是很多企业场景的刚需，省去手动排版和复制的麻烦。我注意到示例中数据包含中文，字体用了 Arial，但 Arial 似乎对中文支持有限，实际运行时会不会出现乱码？另外，如果 JSON 里产品数量很多、一页放不下，Spire.PDF 有没有现成的方法支持分页，还是需要自己计算 Y 坐标手动换页？想请教一下你的实现思路。期待后续更完整的代码示例！

热心网友6

感谢分享，这个方案非常实用！JSON转PDF确实是很多报表自动化的痛点，你的代码结构清晰，尤其是字体、颜色和位置的设定很规范，直接套用就能跑通。想请教一下，如果JSON数据量很大（比如产品列表超过一页），你是打算如何处理分页的？另外Free Spire.PDF对中文字体的支持需要额外配置吗？期待你的后续内容，比如表格绘制和页码添加的部分。