快捷導(dǎo)航

使用Python輕松生成Word報告文檔的完整示例

更新時間：2026年03月16日 09:44:13 作者：大丸子

在自動化辦公場景中,我們經(jīng)常需要批量生成合同、分析報告、項目說明書或客戶函件,如果仍然依賴人工復(fù)制粘貼,不僅效率低下,而且難以保證格式統(tǒng)一與結(jié)構(gòu)規(guī)范,本文將通過一個完整示例,演示如何使用 Python自動創(chuàng)建一份結(jié)構(gòu)化的Word報告文檔,需要的朋友可以參考下

1. 創(chuàng)建文檔與基礎(chǔ)結(jié)構(gòu)

首先初始化 Word 文檔對象。

from spire.doc import *
from spire.doc.common import *
# 創(chuàng)建文檔
document = Document()
# 添加一個節(jié)
section = document.AddSection()

Word 文檔由“節(jié)（Section）”構(gòu)成。每個節(jié)可以獨立控制頁眉頁腳、頁面方向等屬性。

2. 添加標(biāo)題與正文段落

一份專業(yè)報告必須具備清晰的結(jié)構(gòu)層級。

# 添加主標(biāo)題
title = section.AddParagraph()
title.AppendText("2026年上半年銷售分析報告")
title.ApplyStyle(BuiltinStyle.Title)
# 添加一級標(biāo)題
heading1 = section.AddParagraph()
heading1.AppendText("一、整體銷售概況")
heading1.ApplyStyle(BuiltinStyle.Heading1)
# 添加正文
paragraph = section.AddParagraph()
paragraph.AppendText(
    "本報告基于公司上半年銷售數(shù)據(jù)進行統(tǒng)計分析，涵蓋銷售額、增長趨勢以及區(qū)域分布情況。"
)
paragraph.ApplyStyle(BuiltinStyle.Normal)

這里使用 ApplyStyle() 指定 Word 內(nèi)置樣式，而不是手動設(shè)置字體大小。這種方式更符合專業(yè)排版規(guī)范。

3. 插入表格數(shù)據(jù)

報告中通常包含數(shù)據(jù)統(tǒng)計表格。

# 添加表格（4行3列）
table = section.AddTable(True)
table.ResetCells(4, 3)
# 表頭
table.Rows[0].Cells[0].AddParagraph().AppendText("月份")
table.Rows[0].Cells[1].AddParagraph().AppendText("銷售額")
table.Rows[0].Cells[2].AddParagraph().AppendText("增長率")
# 示例數(shù)據(jù)
data = [
    ("1月", "12000", "5%"),
    ("2月", "15000", "8%"),
    ("3月", "18000", "12%"),
]
for i, row in enumerate(data):
    for j, cell in enumerate(row):
        table.Rows[i+1].Cells[j].AddParagraph().AppendText(cell)

使用 ResetCells() 定義表格結(jié)構(gòu)后，可以逐單元格填充內(nèi)容。

4. 插入分頁符

當(dāng)報告內(nèi)容較多時，通常需要分頁。

# 插入分頁
page_break = section.AddParagraph()
page_break.AppendBreak(BreakType.PageBreak)

分頁控制在自動生成長報告時尤為重要，例如：

合同分章節(jié)輸出
數(shù)據(jù)分析多模塊分隔
圖表與正文分離

5. 添加頁眉與頁腳

專業(yè)報告通常包含頁眉頁腳信息。

# 添加頁眉
header = section.HeadersFooters.Header.AddParagraph()
header.AppendText("公司內(nèi)部資料 - 機密")
header.Format.HorizontalAlignment = HorizontalAlignment.Right
# 添加頁腳
footer = section.HeadersFooters.Footer.AddParagraph()
footer.AppendField("Page", FieldType.FieldPage)
footer.AppendText(" / ")
footer.AppendField("NumPages", FieldType.FieldNumPages)

這里使用字段（Field）自動生成頁碼。

6. 設(shè)置字體與段落格式

如果需要自定義字體樣式：

para = section.AddParagraph()
text_range = para.AppendText("重點提示：本季度銷售額同比增長顯著。")
text_range.CharacterFormat.FontName = "Arial"
text_range.CharacterFormat.FontSize = 14
text_range.CharacterFormat.Bold = True

這種方式適用于強調(diào)段落或風(fēng)險提示說明。

7. 保存文檔

document.SaveToFile("AutoGenerateReport.docx", FileFormat.Docx)
document.Dispose()

生成的 Word 文檔將包含：

標(biāo)題層級結(jié)構(gòu)
正文段落
數(shù)據(jù)表格
自動分頁
頁眉頁腳與頁碼

生成結(jié)果預(yù)覽

以下是上述代碼生成的 Word 文檔預(yù)覽：

常見結(jié)構(gòu)控制方法

功能	方法
添加段落	`AddParagraph()`
設(shè)置樣式	`ApplyStyle()`
添加表格	`AddTable()`
插入分頁	`AppendBreak()`
添加頁眉頁腳	`HeadersFooters`
插入頁碼	`AppendField()`