Python 使用 Free Spire.Doc 自动化生成 Word 文档全流程指南

林舟

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

原创

针对批量生成合同、报表等项目文档的效率瓶颈，本文详解如何利用 Python 第三方库 Free Spire.Doc 实现 Word 文档的自动化生成。内容覆盖基础文档结构搭建、自定义排版样式、动态业务表格注入、图片嵌入以及页眉页脚配置。通过提供可直接运行的代码片段，开发者无需依赖 Microsoft Word 环境即可快速输出标准化文档，满足日常办公与系统集成的自动化需求。

环境准备

Free Spire.Doc 是一个功能完善的 Python 库，支持在不依赖 Microsoft Word 软件的环境下对 .doc 和 .docx 格式的文件进行创建、读取、修改与转换操作。使用 pip 包管理器即可完成安装：

pip install Spire.Doc.Free

注意：免费版面存在固定的容量限制，单文档最大仅支持 500 个段落与 25 张数据表。超出限额的内容将被自动截断。该限制足以应对常规的业务台账、测试报告或小型说明书生成，若涉及超长篇文档的大规模处理，建议评估其他解决方案。安装完成后，在 Python 脚本头部引入必要模块：

from spire.doc import *
from spire.doc.common import *

基础文档结构搭建

第1步：创建基础文档框架

目的：初始化 Word 文件的容器结构并完成基础排版设置。

Word 对象的组织遵循严格的树状层次：Document → Section → Paragraph → TextRange。Document 充当根节点；Section 界定独立的页面布局范围（支持分页、边距及页眉页脚控制）；Paragraph 承载文本流；TextRange 则映射具体的连续字符段。

以下脚本演示了从零构建文档、设定纸张边距并填充标题与正文的过程：

# 实例化 Document 对象
doc = Document()

# 追加一个默认节（Section）
section = doc.AddSection()

# 配置页面四周留白（单位：磅）
section.PageSetup.Margins.Top = 60
section.PageSetup.Margins.Bottom = 60
section.PageSetup.Margins.Left = 70
section.PageSetup.Margins.Right = 70

# 挂载标题段落并套用内置样式
title = section.AddParagraph()
title.AppendText("2026年度技术报告")
title.ApplyStyle(BuiltinStyle.Title)

# 插入一级小节标题
heading1 = section.AddParagraph()
heading1.AppendText("一、项目概况")
heading1.ApplyStyle(BuiltinStyle.Heading1)

# 写入正文流水段落
para = section.AddParagraph()
para.AppendText("本报告总结了2026年度技术团队在核心产品研发、性能优化和用户体验提升等方面的工作成果。")
para.ApplyStyle(BuiltinStyle.Normal)

# 输出文件并释放资源
doc.SaveToFile("demo.docx")
doc.Dispose()

第2步：定制文本样式与对齐方式

目的：突破系统预设模板的限制，通过代码精确控制字体属性、颜色与段落对齐。

开发者可以通过实例化 ParagraphStyle 对象来定义专属排版规则。代码执行后，文档内对应的段落将直接继承新定义的字符格式与间距配置：

# 声明自定义段落样式
custom_style = ParagraphStyle(doc)
custom_style.Name = "CustomStyle"
custom_style.CharacterFormat.FontName = "宋体"
custom_style.CharacterFormat.FontSize = 12
custom_style.CharacterFormat.Bold = False
custom_style.CharacterFormat.TextColor = Color.get_Gray()
doc.Styles.Add(custom_style)

# 将自定义规则绑定至目标段落
para.ApplyStyle("CustomStyle")

# 调整段落水平排列位置
title.Format.HorizontalAlignment = HorizontalAlignment.Center
para.Format.HorizontalAlignment = HorizontalAlignment.Left

进阶场景：动态注入业务要素

第3步：生成自适应数据表格

目的：将内存中的结构化数据映射为规范的表格，解决手工制表易错位、格式不统一的痛点。

针对销售台账、运营报表等高频场景，可以直接传入二维数组。库内部会自动处理行列扩容、边框渲染与背景色套用：

from spire.doc import *
from spire.doc.common import *

doc = Document()
section = doc.AddSection()
section.PageSetup.Margins.All = 40

# 定义列名与业务明细
header = ["月份", "产品线", "营收金额(元)", "同比增幅"]
data_list = [
    ["1月", "软件服务", "235000", "6.2%"],
    ["2月", "硬件产品", "189000", "-2.1%"],
    ["3月", "运维外包", "321000", "12.5%"]
]

# 构造表格实例并分配行列空间
table = section.AddTable()
table.ResetCells(len(data_list)+1, len(header))

# 使表格宽度自动撑满可用页面区域
table.AutoFit(AutoFitBehaviorType.AutoFitToWindow)
# 调用预设的商务浅色系配色方案
table.ApplyStyle(DefaultTableStyle.GridTable1LightAccent6)

# 遍历写入表头文本并加粗
for col_idx, val in enumerate(header):
    cell = table.Rows[0].Cells[col_idx]
    cell.AddParagraph().AppendText(val).CharacterFormat.Bold = True

# 嵌套循环填充下方业务数据
for row_idx, row_data in enumerate(data_list, start=1):
    for col_idx, val in enumerate(row_data):
        table.Rows[row_idx].Cells[col_idx].AddParagraph().AppendText(val)

doc.SaveToFile("业务数据表.docx", FileFormat.Docx)
doc.Dispose()

第4步：排版图文混排版式

目的：在标准文本流中穿插可视化素材，增强文档的可读性与直观度。

借助 AppendPicture() 接口可以将本地存储的图片锚定到指定段落，同时能够精准控制缩放比例与相对定位：

from spire.doc import *
from spire.doc.common import *

doc = Document()
section = doc.AddSection()

# 预留图片展示区块的上方引导标题
title = section.AddParagraph()
title.AppendText("产品结构示意图")
title.ApplyStyle(BuiltinStyle.Heading1)

caption = section.AddParagraph()
caption.AppendText("下图展示了产品结构示意关联：")

# 实例化图片对象并将其挂靠至新建段落
image_para = section.AddParagraph()
picture = image_para.AppendPicture("product_diagram.png")

# 强制指定尺寸基准（单位：物理点 pt）
picture.Width = 400
picture.Height = 300

# 锁定整体画布居中分布
image_para.Format.HorizontalAlignment = HorizontalAlignment.Center

# 补齐底部的标准图注说明
caption_below = section.AddParagraph()
caption_below.AppendText("图1 产品结构示意图")
caption_below.Format.HorizontalAlignment = HorizontalAlignment.Center

doc.SaveToFile("report_with_image.docx")
doc.Dispose()

第5步：固化页眉与自动页码系统

目的：赋予文档正式的出版标识与阅读进度指示。

页眉与页脚属于 Section 级别的附属组件，必须挂载到对应的 HeadersFooters 容器中。配合 FieldType 枚举可以实现动态翻页计数：

from spire.doc import *
from spire.doc.common import *

doc = Document()
section = doc.AddSection()

# 切换垂直纵向排版模式
section.PageSetup.Orientation = PageOrientation.Portrait

# 构筑顶部信息栏
header = section.HeadersFooters.Header.AddParagraph()
header.AppendText("公司内部保密资料 - 技术专报")
header.Format.HorizontalAlignment = HorizontalAlignment.Right

# 构筑底部状态栏并植入自动计数器
footer = section.HeadersFooters.Footer.AddParagraph()
footer.AppendField("Page", FieldType.FieldPage)
footer.AppendText(" / ")
footer.AppendField("NumPages", FieldType.FieldNumPages)
footer.Format.HorizontalAlignment = HorizontalAlignment.Center

# 灌入主体文本流
content = section.AddParagraph()
content.AppendText("此处填入项目的详细汇报正文内容...")

doc.SaveToFile("带页眉页脚.docx")
doc.Dispose()

综合应用：封装企业级报告生成器

在实际的工程落地中，往往需要将上述碎片化的 API 调用的整合进统一的调度流程中。以下提供一个高阶封装范例，集成了多表头排版、指标对比矩阵与元数据管理，适合作为后台定时任务的输出端：

from spire.doc import *
from spire.doc.common import *

def generate_project_report(project_name, start_date, end_date, budget, metrics, summary):
    """
    核心函数：一键打包输出结构化项目结项档案
    """
    doc = Document()
    section = doc.AddSection()
    
    # 全局安全边距兜底
    section.PageSetup.Margins.Top = 70
    section.PageSetup.Margins.Bottom = 70
    section.PageSetup.Margins.Left = 60
    section.PageSetup.Margins.Right = 60
    
    # --- 页眉页脚体系 ---
    header = section.HeadersFooters.Header.AddParagraph()
    header.AppendText(f"项目结项核验报告 - {project_name}")
    header.Format.HorizontalAlignment = HorizontalAlignment.Center
    
    footer = section.HeadersFooters.Footer.AddParagraph()
    footer.AppendField("Page", FieldType.FieldPage)
    footer.AppendText(" / ")
    footer.AppendField("NumPages", FieldType.FieldNumPages)
    footer.Format.HorizontalAlignment = HorizontalAlignment.Center
    
    # --- 顶层标题锚点 ---
    title = section.AddParagraph()
    title.AppendText(f"{project_name} - 结项验收报告")
    title.ApplyStyle(BuiltinStyle.Title)
    title.Format.HorizontalAlignment = HorizontalAlignment.Center
    title.Format.AfterSpacing = 20
    
    # --- 基础档案卡片区 ---
    heading_basic = section.AddParagraph()
    heading_basic.AppendText("一、项目基础档案")
    heading_basic.ApplyStyle(BuiltinStyle.Heading1)
    
    info_table = section.AddTable(True)
    info_table.ResetCells(4, 2)
    info_table.TableFormat.Borders.BorderType = BorderStyle.Single
    
    info_data = [("项目名称", project_name), ("执行周期", f"{start_date} 至 {end_date}"), 
                 ("预算额度", f"{budget} 万元"), ("出表日期", "2026年6月")]
    for i, (key, value) in enumerate(info_data):
        cell_0 = info_table.Rows[i].Cells[0].AddParagraph()
        cell_0.AppendText(key)
        cell_0.ApplyStyle(BuiltinStyle.Normal)
        
        cell_1 = info_table.Rows[i].Cells[1].AddParagraph()
        cell_1.AppendText(value)
        
    # --- 关键绩效指标(KPI)矩阵 ---
    heading_metrics = section.AddParagraph()
    heading_metrics.AppendText("二、KPI 达标情况核算")
    heading_metrics.ApplyStyle(BuiltinStyle.Heading1)
    
    metrics_table = section.AddTable(True)
    metrics_table.ResetCells(len(metrics) + 1, 3)
    metrics_table.TableFormat.Borders.BorderType = BorderStyle.Single
    
    metric_headers = ["考核指标维度", "当期实测值", "预定目标线"]
    for idx, h_text in enumerate(metric_headers):
        metrics_table.Rows[0].Cells[idx].AddParagraph().AppendText(h_text)
    
    for i, (name, actual, target) in enumerate(metrics):
        metrics_table.Rows[i + 1].Cells[0].AddParagraph().AppendText(name)
        metrics_table.Rows[i + 1].Cells[1].AddParagraph().AppendText(str(actual))
        metrics_table.Rows[i + 1].Cells[2].AddParagraph().AppendText(str(target))
    
    # --- 终局复盘综述 ---
    heading_summary = section.AddParagraph()
    heading_summary.AppendText("三、阶段复盘综述")
    heading_summary.ApplyStyle(BuiltinStyle.Heading1)
    
    summary_para = section.AddParagraph()
    summary_para.AppendText(summary)
    summary_para.ApplyStyle(BuiltinStyle.Normal)
    
    # 持久化落地
    output_file = f"{project_name}_结项报告.docx"
    doc.SaveToFile(output_file)
    doc.Dispose()
    
    print(f"交付物已归档：{output_file}")


if __name__ == "__main__":
    generate_project_report(
        project_name="新一代数据分析中台",
        start_date="2025-07-01",
        end_date="2026-06-30",
        budget=280,
        metrics=[
            ("并发吞吐量(TPS)", 12500, 10000),
            ("复杂查询延迟(ms)", 85, 100),
            ("终端满意度指数", 4.8, 4.5),
            ("功能按期交付率(%)", 98, 95)
        ],
        summary="本期攻坚圆满达成新一代数据分析中台的架构升级与集群部署。各项核心负载指标均平滑跨越预期基线，线上环境历经压测保持高可用运转态势，收集到的用户正向评价印证了体验优化的成效。下阶段将重点攻克多维智能洞察引擎与轻量化移动接入通道的研发攻关。"
    )

扩展能力与注意事项

多级清单编排：利用 ListFormat.ApplyStyle() 能够快速渲染有序或无序条款，极为适合合同附件、会议议程等结构化清单输出。
跨平台文档流转：底层接口兼容直接解析 .md 与 .html 源文件，随后一键转译为 docx，打通了 Markdown 知识库向正式汇报材料的导出链路。
增量式二次加工：支持反向加载历史版 docx 档案，通过字符串检索匹配精准锚点、实施关键字覆写或无缝追加新段落，大幅降低存量资产的重构成本。

以上就是 Python 使用 Free Spire.Doc 实现自动化生成 Word 文档的详细内容，更多关于 Python 办公自动化脚本与文档处理的资料请关注本站其它相关文章！