Python 自动化：将 JSON 数据写入 Word 表格与段落（附代码）

脚本专家

在现代业务场景中，JSON 是 API 响应、配置文件、数据库导出中最常用的数据格式。但将结构化数据呈现给非技术人员或用于正式报告时，直接展示 JSON 原文并不友好。手动复制粘贴效率低、易出错。本文介绍如何使用 Python 和 Free Spire.Doc for Python 库，自动将 JSON 数据写入 Word 文档，支持段落、表格、嵌套数据合并单元格，以及从文件批量生成多表格。

首先安装依赖库：

2. pip install spire.doc.free

复制代码

一、读取 JSON 数据并写入 Word 段落
当 JSON 为简单键值对结构时，可以用段落形式输出每个字段，适合生成配置说明、信息卡片等。

2. import json
3. from spire.doc import *
4. from spire.doc.common import *
6. json_data = {
7.     "项目名称": "智慧城市数据平台",
8.     "版本": "v3.2.1",
9.     "负责人": "张伟",
10.     "状态": "进行中",
11.     "启动日期": "2024-01-15",
12.     "预计完成": "2024-12-31",
13.     "技术栈": "Python, Kafka, PostgreSQL, Docker",
14.     "描述": "基于物联网传感器数据构建城市级实时监控与分析平台"
15. }
17. document = Document()
18. section = document.AddSection()
20. # 添加标题
21. title = section.AddParagraph()
22. title_text = title.AppendText("项目信息概览")
23. title.Format.HorizontalAlignment = HorizontalAlignment.Center
24. title_text.CharacterFormat.FontName = "微软雅黑"
25. title_text.CharacterFormat.Bold = True
26. title_text.CharacterFormat.FontSize = 18
27. section.AddParagraph()
29. # 遍历键值对写入段落
30. for key, value in json_data.items():
31.     para = section.AddParagraph()
32.     text_range = para.AppendText(f"{key}：{value}")
33.     text_range.CharacterFormat.FontSize = 12
34.     text_range.CharacterFormat.FontName = "微软雅黑"
36. document.SaveToFile("ProjectInfo.docx", FileFormat.Docx)
37. document.Close()

复制代码

说明：Document() 创建文档，AddSection() 添加节，AppendText() 写入内容，通过 CharacterFormat 设置字体字号。适合数据量少、扁平的 JSON。

二、将 JSON 数组数据写入 Word 表格
2.1 基础员工信息表

2. import json
3. from spire.doc import *
4. from spire.doc.common import *
6. json_employees = [
7.     {"姓名": "张三", "部门": "技术部", "职位": "高级工程师", "入职日期": "2020-03-15", "薪资": "25000"},
8.     {"姓名": "李四", "部门": "市场部", "职位": "市场经理", "入职日期": "2019-06-20", "薪资": "22000"},
9.     {"姓名": "王五", "部门": "人力资源部", "职位": "HR专员", "入职日期": "2021-01-10", "薪资": "15000"},
10.     {"姓名": "赵六", "部门": "财务部", "职位": "财务主管", "入职日期": "2018-11-05", "薪资": "20000"},
11.     {"姓名": "钱七", "部门": "技术部", "职位": "产品经理", "入职日期": "2020-08-22", "薪资": "23000"}
12. ]
14. document = Document()
15. section = document.AddSection()
17. title = section.AddParagraph()
18. title_text = title.AppendText("员工信息表")
19. title.Format.HorizontalAlignment = HorizontalAlignment.Center
20. title_text.CharacterFormat.Bold = True
21. title_text.CharacterFormat.FontSize = 18
22. section.AddParagraph()
24. headers = list(json_employees[0].keys())
25. table = section.AddTable(True)
26. table.ResetCells(len(json_employees) + 1, len(headers))
28. # 表头行
29. header_row = table.Rows[0]
30. header_row.IsHeader = True
31. header_row.Height = 30
32. header_row.HeightType = TableRowHeightType.Exactly
33. for i, header in enumerate(headers):
34.     cell = header_row.Cells[i]
35.     cell.CellFormat.VerticalAlignment = VerticalAlignment.Middle
36.     cell.CellFormat.Shading.BackgroundPatternColor = Color.get_Gray()
37.     paragraph = cell.AddParagraph()
38.     paragraph.Format.HorizontalAlignment = HorizontalAlignment.Center
39.     text_range = paragraph.AppendText(header)
40.     text_range.CharacterFormat.Bold = True
41.     text_range.CharacterFormat.FontSize = 12
43. # 数据行
44. for row_idx, employee in enumerate(json_employees):
45.     data_row = table.Rows[row_idx + 1]
46.     data_row.Height = 25
47.     data_row.HeightType = TableRowHeightType.Exactly
48.     for col_idx, key in enumerate(headers):
49.         cell = data_row.Cells[col_idx]
50.         cell.CellFormat.VerticalAlignment = VerticalAlignment.Middle
51.         paragraph = cell.AddParagraph()
52.         paragraph.Format.HorizontalAlignment = HorizontalAlignment.Center
53.         paragraph.AppendText(str(employee[key]))
55. # 隔行变色
56. for row_idx in range(1, table.Rows.Count):
57.     if row_idx % 2 == 0:
58.         row = table.Rows[row_idx]
59.         for i in range(row.Cells.Count):
60.             row.Cells[i].CellFormat.Shading.BackgroundPatternColor = Color.get_LightBlue()
62. document.SaveToFile("EmployeeJsonTable.docx", FileFormat.Docx)
63. document.Close()

复制代码

关键点：list(json_employees[0].keys()) 动态提取表头，ResetCells() 初始化表格，表头灰色背景粗体，数据居中并隔行变色。

2.2 带样式的季度销售表格

2. import json
3. from spire.doc import *
4. from spire.doc.common import *
6. json_sales = [
7.     {"产品名称": "笔记本电脑", "第一季度": "120万", "第二季度": "135万", "第三季度": "150万", "第四季度": "168万"},
8.     {"产品名称": "平板电脑", "第一季度": "85万", "第二季度": "92万", "第三季度": "105万", "第四季度": "118万"},
9.     {"产品名称": "智能手机", "第一季度": "200万", "第二季度": "220万", "第三季度": "245万", "第四季度": "280万"},
10.     {"产品名称": "智能手表", "第一季度": "45万", "第二季度": "52万", "第三季度": "60万", "第四季度": "72万"}
11. ]
13. document = Document()
14. section = document.AddSection()
16. title = section.AddParagraph()
17. title_text = title.AppendText("2024年度季度销售报表")
18. title.Format.HorizontalAlignment = HorizontalAlignment.Center
19. title_text.CharacterFormat.Bold = True
20. title_text.CharacterFormat.FontSize = 18
21. section.AddParagraph()
23. headers = list(json_sales[0].keys())
24. table = section.AddTable(True)
25. table.ResetCells(len(json_sales) + 1, len(headers))
27. for i, header in enumerate(headers):
28.     cell = table.Rows[0].Cells[i]
29.     cell.CellFormat.VerticalAlignment = VerticalAlignment.Middle
30.     cell.CellFormat.Shading.BackgroundPatternColor = Color.get_DarkSeaGreen()
31.     paragraph = cell.AddParagraph()
32.     paragraph.Format.HorizontalAlignment = HorizontalAlignment.Center
33.     text_range = paragraph.AppendText(header)
34.     text_range.CharacterFormat.Bold = True
35.     text_range.CharacterFormat.FontSize = 12
36.     text_range.CharacterFormat.TextColor = Color.get_White()
38. for row_idx, item in enumerate(json_sales):
39.     for col_idx, key in enumerate(headers):
40.         cell = table.Rows[row_idx + 1].Cells[col_idx]
41.         cell.CellFormat.VerticalAlignment = VerticalAlignment.Middle
42.         paragraph = cell.AddParagraph()
43.         paragraph.Format.HorizontalAlignment = HorizontalAlignment.Center
44.         paragraph.AppendText(str(item[key]))
46. table.ApplyStyle(DefaultTableStyle.ColorfulListAccent1)
47. table.Format.Borders.BorderType = BorderStyle.Single
48. table.Format.Borders.LineWidth = 1.0
49. table.Format.Borders.Color = Color.get_Black()
51. document.SaveToFile("SalesJsonReport.docx", FileFormat.Docx)
52. document.Close()

复制代码

ApplyStyle() 快速应用预设样式，Format.Borders 自定义边框。深绿色表头配白色字增强层次。

三、处理嵌套 JSON 数据：合并单元格表格
实际数据常含嵌套结构，如产品分类。通过 ApplyVerticalMerge 合并分类列单元格实现层级关系。

2. import json
3. from spire.doc import *
4. from spire.doc.common import *
6. json_catalog = {
7.     "电子产品": [
8.         {"型号": "SP-2024", "名称": "智能手机", "价格": "3999元"},
9.         {"型号": "TB-2024", "名称": "平板电脑", "价格": "2999元"}
10.     ],
11.     "家居用品": [
12.         {"型号": "RC-2024", "名称": "电饭煲", "价格": "599元"},
13.         {"型号": "AP-2024", "名称": "空气净化器", "价格": "1299元"}
14.     ],
15.     "办公用品": [
16.         {"型号": "PR-2024", "名称": "打印机", "价格": "1599元"},
17.         {"型号": "SH-2024", "名称": "碎纸机", "价格": "399元"}
18.     ]
19. }
21. document = Document()
22. section = document.AddSection()
24. title = section.AddParagraph()
25. title_text = title.AppendText("产品目录")
26. title.Format.HorizontalAlignment = HorizontalAlignment.Center
27. title_text.CharacterFormat.Bold = True
28. title_text.CharacterFormat.FontSize = 18
29. section.AddParagraph()
31. total_rows = 1 + sum(len(items) for items in json_catalog.values())
32. col_count = 4  # 分类、型号、名称、价格
33. table = section.AddTable(True)
34. table.ResetCells(total_rows, col_count)
36. headers = ["分类", "型号", "名称", "价格"]
37. for i, header in enumerate(headers):
38.     cell = table.Rows[0].Cells[i]
39.     cell.CellFormat.VerticalAlignment = VerticalAlignment.Middle
40.     cell.CellFormat.Shading.BackgroundPatternColor = Color.get_Gray()
41.     paragraph = cell.AddParagraph()
42.     paragraph.Format.HorizontalAlignment = HorizontalAlignment.Center
43.     text_range = paragraph.AppendText(header)
44.     text_range.CharacterFormat.Bold = True
46. current_row = 1
47. for category, items in json_catalog.items():
48.     start_row = current_row
49.     for item in items:
50.         row = table.Rows[current_row]
51.         row.Cells[1].AddParagraph().AppendText(item["型号"])
52.         row.Cells[2].AddParagraph().AppendText(item["名称"])
53.         row.Cells[3].AddParagraph().AppendText(item["价格"])
54.         current_row += 1
55.     # 写入分类名并合并单元格
56.     table.Rows[start_row].Cells[0].AddParagraph().AppendText(category)
57.     if len(items) > 1:
58.         table.ApplyVerticalMerge(0, start_row, start_row + len(items) - 1)
59.     table.Rows[start_row].Cells[0].CellFormat.VerticalAlignment = VerticalAlignment.Middle
60. table.ApplyStyle(DefaultTableStyle.ColorfulGridAccent3)
62. document.SaveToFile("CatalogJsonTable.docx", FileFormat.Docx)
63. document.Close()

复制代码

ApplyVerticalMerge(列索引, 起始行, 结束行) 垂直合并同一分类的单元格，更直观展示层级。

四、从 JSON 文件批量写入多个表格
同一 JSON 可包含多组数据集，循环创建各自独立的表格，适合生成汇总报告。

2. import json
3. from spire.doc import *
4. from spire.doc.common import *
6. json_file_data = {
7.     "员工信息": [
8.         {"姓名": "张三", "部门": "技术部", "职位": "工程师"},
9.         {"姓名": "李四", "部门": "市场部", "职位": "经理"},
10.         {"姓名": "王五", "部门": "财务部", "职位": "会计"}
11.     ],
12.     "项目列表": [
13.         {"项目": "数据平台", "状态": "进行中", "进度": "75%"},
14.         {"项目": "移动应用", "状态": "已完成", "进度": "100%"},
15.         {"项目": "AI模型", "状态": "规划中", "进度": "10%"}
16.     ],
17.     "设备清单": [
18.         {"设备": "服务器A", "IP": "192.168.1.10", "状态": "运行中"},
19.         {"设备": "服务器B", "IP": "192.168.1.11", "状态": "维护中"},
20.         {"设备": "交换机", "IP": "192.168.1.1", "状态": "运行中"}
21.     ]
22. }
24. document = Document()
25. section = document.AddSection()
27. doc_title = section.AddParagraph()
28. doc_title_text = doc_title.AppendText("数据汇总报告")
29. doc_title.Format.HorizontalAlignment = HorizontalAlignment.Center
30. doc_title_text.CharacterFormat.Bold = True
31. doc_title_text.CharacterFormat.FontSize = 22
32. section.AddParagraph()
34. for table_name, records in json_file_data.items():
35.     # 每个表格的标题
36.     table_title = section.AddParagraph()
37.     table_title_text = table_title.AppendText(table_name)
38.     table_title_text.CharacterFormat.Bold = True
39.     table_title_text.CharacterFormat.FontSize = 14
40.     section.AddParagraph()
42.     headers = list(records[0].keys())
43.     table = section.AddTable(True)
44.     table.ResetCells(len(records) + 1, len(headers))
46.     for i, header in enumerate(headers):
47.         cell = table.Rows[0].Cells[i]
48.         cell.CellFormat.VerticalAlignment = VerticalAlignment.Middle
49.         cell.CellFormat.Shading.BackgroundPatternColor = Color.get_Gray()
50.         paragraph = cell.AddParagraph()
51.         paragraph.Format.HorizontalAlignment = HorizontalAlignment.Center
52.         text_range = paragraph.AppendText(header)
53.         text_range.CharacterFormat.Bold = True
55.     for row_idx, record in enumerate(records):
56.         for col_idx, key in enumerate(headers):
57.             cell = table.Rows[row_idx + 1].Cells[col_idx]
58.             cell.CellFormat.VerticalAlignment = VerticalAlignment.Middle
59.             paragraph = cell.AddParagraph()
60.             paragraph.Format.HorizontalAlignment = HorizontalAlignment.Center
61.             paragraph.AppendText(str(record[key]))
63.     table.ApplyStyle(DefaultTableStyle.ColorfulListAccent1)
64.     table.AutoFit(AutoFitBehaviorType.AutoFitToWindow)
65.     section.AddParagraph()  # 表格间空行
67. document.SaveToFile("JsonDataReport.docx", FileFormat.Docx)
68. document.Close()

复制代码

实际使用 json.load() 从 .json 文件读取数据替换示例字典。AutoFitToWindow 让表格自适应页面宽度。

关键类与方法一览
- Document：Word 文档对象，支持创建、加载、保存。
- AddSection()：添加节作为内容容器。
- AddTable()：在节中创建表格。
- ResetCells(rows, cols)：初始化表格行列。
- ApplyStyle(DefaultTableStyle.*)：应用预设样式（如 ColorfulListAccent1、ColorfulGridAccent3）。
- ApplyVerticalMerge(column, startRow, endRow)：垂直合并单元格。
- AutoFit(AutoFitBehaviorType.AutoFitToWindow)：自动调整表格宽度。
- Rows/ Cells：行/列集合。
- CellFormat.Shading.BackgroundPatternColor：单元格背景色。
- CellFormat.VerticalAlignment：垂直对齐。
- AddParagraph() / AppendText()：单元格或段落中添加文本。
- SaveToFile(path, FileFormat.Docx)：保存为 .docx。

以上方法均可灵活组合，满足从简单段落到复杂嵌套表格的自动化生成需求。代码可直接用于 API 报告、配置文档、数据导出等场景。

热心网友6

感谢分享这个实用的教程！将 JSON 数据自动写入 Word 文档确实能极大提高工作效率，特别是对于需要向非技术人员展示结构化数据的场景。您提供的段落写入示例清晰易懂，表格部分虽然中断了，但思路已经展示出来，相信读者能很快理解核心逻辑。如果后续能补充完整表格生成代码以及处理嵌套数据的合并单元格示例，这篇教程会更有深度。期待更多类似的自动化技巧分享！