使用Python在Word文檔中創(chuàng)建表格并設置各種格式

更新時間：2026年03月16日 08:53:02 作者：大丸子

在現代辦公環(huán)境中,Word 文檔是信息傳遞和報告輸出的重要載體,本文將使用?Free Spire.Doc for Python?展示如何在 Word 文檔中創(chuàng)建基礎表格、設置表格樣式、合并與拆分單元格、創(chuàng)建嵌套表格等實用功能,需要的朋友可以參考下

在現代辦公環(huán)境中，Word 文檔是信息傳遞和報告輸出的重要載體。從制作財務報表、項目進度表，到創(chuàng)建產品對比清單、員工信息表，表格以其清晰的結構化展示能力，成為各類文檔中不可或缺的元素。然而，當需要處理大量數據或定期生成標準化報告時，手動在 Word 中創(chuàng)建和格式化表格不僅耗時耗力，還容易出現格式不一致、數據錄入錯誤等問題。而 Python 憑借其強大的自動化處理能力，結合專業(yè)的文檔操作庫，可以高效地實現 Word 表格的批量創(chuàng)建、格式化和數據填充，大幅提升工作效率。

本文將使用 Free Spire.Doc for Python 展示如何在 Word 文檔中創(chuàng)建基礎表格、設置表格樣式、合并與拆分單元格、創(chuàng)建嵌套表格等實用功能，結合實際業(yè)務場景的數據示例，幫助你快速掌握 Word 表格自動化處理技能。

1. 環(huán)境準備與庫安裝

首先需要安裝 Free Spire.Doc for Python：

pip install spire.doc.free

安裝完成后，我們可以開始創(chuàng)建 Word 文檔并準備表格。下面是一個創(chuàng)建 Word 文件的簡單示例：

from spire.doc import *
from spire.doc.common import *
# 創(chuàng)建一個新的 Word 文檔
document = Document()
# 添加一個節(jié)
section = document.AddSection()
# 添加一個段落作為標題
title = section.AddParagraph()
text_range = title.AppendText("員工信息表")
title.Format.HorizontalAlignment = HorizontalAlignment.Center
text_range.CharacterFormat.Bold = True
text_range.CharacterFormat.FontSize = 18
# 保存初始文件
document.SaveToFile("EmployeeTable.docx", FileFormat.Docx)
document.Close()
print("Word 文檔已創(chuàng)建：EmployeeTable.docx")

說明：
Document 對象代表整個 Word 文檔，AddSection() 方法添加一個新的節(jié)，AddParagraph() 方法添加段落。這里我們創(chuàng)建了一個包含標題的文檔，為后續(xù)創(chuàng)建表格做好準備。

2. 創(chuàng)建基礎表格：員工信息管理

假設我們需要為人力資源部門創(chuàng)建一份員工信息表，包含姓名、部門、職位、入職日期和聯系方式等字段。我們可以在代碼中直接生成表格并填充數據：

from spire.doc import *
from spire.doc.common import *
# 創(chuàng)建文檔
document = Document()
section = document.AddSection()
# 添加標題
title = section.AddParagraph()
text_range = title.AppendText("員工信息表")
title.Format.HorizontalAlignment = HorizontalAlignment.Center
text_range.CharacterFormat.Bold = True
text_range.CharacterFormat.FontSize = 18
section.AddParagraph()  # 添加空行
# 準備表頭和數據
headers = ["姓名", "部門", "職位", "入職日期", "聯系方式"]
employees = [
    ["張三", "技術部", "軟件工程師", "2020-03-15", "13800138001"],
    ["李四", "市場部", "市場經理", "2019-06-20", "13800138002"],
    ["王五", "人力資源部", "人力資源專員", "2021-01-10", "13800138003"],
    ["趙六", "財務部", "會計", "2018-11-05", "13800138004"],
    ["錢七", "技術部", "產品經理", "2020-08-22", "13800138005"],
]
# 創(chuàng)建表格
table = section.AddTable(True)
table.ResetCells(len(employees) + 1, len(headers))
# 設置表頭行
header_row = table.Rows[0]
header_row.IsHeader = True
header_row.Height = 30
header_row.HeightType = TableRowHeightType.Exactly
# 填充表頭并設置樣式
for i, header in enumerate(headers):
    cell = header_row.Cells[i]
    cell.CellFormat.VerticalAlignment = VerticalAlignment.Middle
    cell.CellFormat.Shading.BackgroundPatternColor = Color.get_Gray()
    paragraph = cell.AddParagraph()
    paragraph.Format.HorizontalAlignment = HorizontalAlignment.Center
    text_range = paragraph.AppendText(header)
    text_range.CharacterFormat.Bold = True
    text_range.CharacterFormat.FontSize = 12
# 填充數據行
for row_idx, employee in enumerate(employees):
    data_row = table.Rows[row_idx + 1]
    data_row.Height = 25
    data_row.HeightType = TableRowHeightType.Exactly
    for col_idx, value in enumerate(employee):
        cell = data_row.Cells[col_idx]
        cell.CellFormat.VerticalAlignment = VerticalAlignment.Middle
        cell.CellFormat.Shading.BackgroundPatternColor = Color.Empty()
        paragraph = cell.AddParagraph()
        paragraph.Format.HorizontalAlignment = HorizontalAlignment.Center
        paragraph.AppendText(value)
# 設置隔行變色
for row_idx in range(1, table.Rows.Count):
    if row_idx % 2 == 0:
        row = table.Rows[row_idx]
        for cell_idx in range(row.Cells.Count):
            cell = row.Cells[cell_idx]
            cell.CellFormat.Shading.BackgroundPatternColor = Color.get_LightBlue()
# 保存文檔
document.SaveToFile("EmployeeTable.docx", FileFormat.Docx)
document.Close()
print("員工信息表已創(chuàng)建完成")

文檔預覽：

說明：
通過 section.AddTable(True) 創(chuàng)建表格，ResetCells() 方法設置表格的行數和列數。我們?yōu)楸眍^行設置了灰色背景和粗體字，數據行居中對齊，并實現了隔行變色效果，使表格更加清晰易讀。

3. 設置表格樣式與邊框

為了讓表格更具專業(yè)性和可讀性，我們可以應用預設的表格樣式并自定義邊框樣式：

from spire.doc import *
from spire.doc.common import *
# 創(chuàng)建文檔
document = Document()
section = document.AddSection()
# 添加標題
title = section.AddParagraph()
text_Range = title.AppendText("季度銷售報表")
title.Format.HorizontalAlignment = HorizontalAlignment.Center
text_Range.CharacterFormat.Bold = True
text_Range.CharacterFormat.FontSize = 18
section.AddParagraph()
# 創(chuàng)建表格
table = section.AddTable(True)
table.ResetCells(5, 4)
# 填充表頭
headers = ["產品名稱", "第一季度", "第二季度", "第三季度"]
for i, header in enumerate(headers):
    cell = table.Rows[0].Cells[i]
    cell.AddParagraph().AppendText(header)
    cell.CellFormat.VerticalAlignment = VerticalAlignment.Middle
# 填充數據
data = [
    ["筆記本電腦", "120萬", "135萬", "150萬"],
    ["平板電腦", "85萬", "92萬", "105萬"],
    ["智能手機", "200萬", "220萬", "245萬"],
    ["智能手表", "45萬", "52萬", "60萬"],
]
for row_idx, row_data in enumerate(data):
    for col_idx, value in enumerate(row_data):
        table.Rows[row_idx + 1].Cells[col_idx].AddParagraph().AppendText(value)
# 應用表格樣式
table.ApplyStyle(DefaultTableStyle.ColorfulListAccent1)
# 自定義邊框樣式
table.Format.Borders.BorderType = BorderStyle.Single
table.Format.Borders.LineWidth = 1.0
table.Format.Borders.Color = Color.get_Black()
# 設置外邊框加粗
table.Format.Borders.Left.LineWidth = 2.0
table.Format.Borders.Right.LineWidth = 2.0
table.Format.Borders.Top.LineWidth = 2.0
table.Format.Borders.Bottom.LineWidth = 2.0
# 保存文檔
document.SaveToFile("SalesReport.docx", FileFormat.Docx)
document.Close()
print("銷售報表已創(chuàng)建完成")

文檔預覽：

說明：
ApplyStyle() 方法應用預設的表格樣式，Format.Borders 屬性用于設置邊框樣式。我們可以單獨設置上下左右邊框的寬度、顏色和類型，創(chuàng)建專業(yè)的表格外觀。

4. 合并與拆分單元格：創(chuàng)建復雜表格結構

在實際業(yè)務中，我們經常需要創(chuàng)建包含合并單元格的復雜表格結構，例如產品規(guī)格對比表：

from spire.doc import *
from spire.doc.common import *
# 創(chuàng)建文檔
document = Document()
section = document.AddSection()
# 添加標題
title = section.AddParagraph()
text_range = title.AppendText("產品規(guī)格對比表")
title.Format.HorizontalAlignment = HorizontalAlignment.Center
text_range.CharacterFormat.Bold = True
text_range.CharacterFormat.FontSize = 18
section.AddParagraph()
# 創(chuàng)建表格（8行6列）
table = section.AddTable(True)
table.ResetCells(8, 6)
# 填充表頭（合并第一行的前3列和后3列）
table.ApplyHorizontalMerge(0, 0, 2)  # 合并第1行的第1-3列
table.ApplyHorizontalMerge(0, 3, 5)  # 合并第1行的第4-6列
table.Rows[0].Cells[0].AddParagraph().AppendText("基礎信息")
table.Rows[0].Cells[3].AddParagraph().AppendText("技術參數")
# 填充第二列表頭
sub_headers = ["產品名稱", "型號", "價格", "處理器", "內存", "存儲"]
for i, header in enumerate(sub_headers):
    table.Rows[1].Cells[i].AddParagraph().AppendText(header)
# 填充產品數據
products = [
    ["ProBook X1", "PB-2024", "5999元", "i7-1360P", "16GB", "512GB SSD"],
    ["UltraBook Pro", "UB-2024", "7999元", "i7-1370P", "32GB", "1TB SSD"],
    ["Gaming Laptop", "GL-2024", "9999元", "i9-13900HX", "32GB", "1TB SSD"],
]
for row_idx, product in enumerate(products):
    for col_idx, value in enumerate(product):
        table.Rows[row_idx + 2].Cells[col_idx].AddParagraph().AppendText(value)
# 合并底部的備注行（合并所有列）
note_row = table.Rows[6]
table.ApplyHorizontalMerge(6, 0, 5)
note_row.Cells[0].AddParagraph().AppendText("注：以上價格僅供參考，實際價格以官網為準。")
# 在最后一行拆分單元格
table.Rows[7].Cells[0].SplitCell(3, 2)  # 將第8行第1列拆分為3行2列
# 保存文檔
document.SaveToFile("ProductComparison.docx", FileFormat.Docx)
document.Close()
print("產品規(guī)格對比表已創(chuàng)建完成")

文檔預覽：

說明：
ApplyHorizontalMerge() 方法用于水平合并單元格（同一行內），ApplyVerticalMerge() 方法用于垂直合并單元格（同一列內）。SplitCell() 方法可以將一個單元格拆分為多個單元格，實現更靈活的表格布局。

5. 創(chuàng)建嵌套表格：展示層級數據

嵌套表格可以在一個單元格內包含另一個表格，適用于展示具有層級關系的數據，例如產品目錄：

from spire.doc import *
from spire.doc.common import *
# 創(chuàng)建文檔
document = Document()
section = document.AddSection()
# 添加標題
title = section.AddParagraph()
text_range = title.AppendText("產品目錄")
title.Format.HorizontalAlignment = HorizontalAlignment.Center
text_range.CharacterFormat.Bold = True
text_range.CharacterFormat.FontSize = 18
section.AddParagraph()
# 創(chuàng)建主表格（3行2列）
main_table = section.AddTable(True)
main_table.ResetCells(3, 2)
# 設置主表格列寬
main_table.Rows[0].Cells[0].SetCellWidth(150, CellWidthType.Point)
main_table.AutoFit(AutoFitBehaviorType.AutoFitToWindow)
# 填充主表格第一列（產品類別）
main_table.Rows[0].Cells[0].AddParagraph().AppendText("電子產品")
main_table.Rows[1].Cells[0].AddParagraph().AppendText("家居用品")
main_table.Rows[2].Cells[0].AddParagraph().AppendText("辦公用品")
# 在第一行第二列創(chuàng)建嵌套表格（電子產品）
nested_table1 = main_table.Rows[0].Cells[1].AddTable(True)
nested_table1.ResetCells(4, 3)
nested_table1.AutoFit(AutoFitBehaviorType.AutoFitToContents)
# 填充嵌套表格1的表頭
nested_headers = ["產品名稱", "型號", "價格"]
for i, header in enumerate(nested_headers):
    cell = nested_table1.Rows[0].Cells[i]
    cell.CellFormat.Shading.BackgroundPatternColor = Color.get_LightGray()
    cell.AddParagraph().AppendText(header)
# 填充嵌套表格1的數據
electronics = [
    ["智能手機", "SP-2024", "3999元"],
    ["平板電腦", "TB-2024", "2999元"],
    ["智能手表", "SW-2024", "1999元"],
]
for row_idx, item in enumerate(electronics):
    for col_idx, value in enumerate(item):
        nested_table1.Rows[row_idx + 1].Cells[col_idx].AddParagraph().AppendText(value)
# 在第二行第二列創(chuàng)建嵌套表格（家居用品）
nested_table2 = main_table.Rows[1].Cells[1].AddTable(True)
nested_table2.ResetCells(3, 3)
nested_table2.AutoFit(AutoFitBehaviorType.AutoFitToContents)
for i, header in enumerate(nested_headers):
    cell = nested_table2.Rows[0].Cells[i]
    cell.CellFormat.Shading.BackgroundPatternColor = Color.get_LightGray()
    cell.AddParagraph().AppendText(header)
home_goods = [
    ["電飯煲", "RC-2024", "599元"],
    ["空氣凈化器", "AP-2024", "1299元"],
]
for row_idx, item in enumerate(home_goods):
    for col_idx, value in enumerate(item):
        nested_table2.Rows[row_idx + 1].Cells[col_idx].AddParagraph().AppendText(value)
# 在第三行第二列創(chuàng)建嵌套表格（辦公用品）
nested_table3 = main_table.Rows[2].Cells[1].AddTable(True)
nested_table3.ResetCells(3, 3)
nested_table3.AutoFit(AutoFitBehaviorType.AutoFitToContents)
for i, header in enumerate(nested_headers):
    cell = nested_table3.Rows[0].Cells[i]
    cell.CellFormat.Shading.BackgroundPatternColor = Color.get_LightGray()
    cell.AddParagraph().AppendText(header)
office_supplies = [
    ["打印機", "PR-2024", "1599元"],
    ["碎紙機", "SH-2024", "399元"],
]
for row_idx, item in enumerate(office_supplies):
    for col_idx, value in enumerate(item):
        nested_table3.Rows[row_idx + 1].Cells[col_idx].AddParagraph().AppendText(value)
# 保存文檔
document.SaveToFile("ProductCatalog.docx", FileFormat.Docx)
document.Close()
print("產品目錄已創(chuàng)建完成")

文檔預覽：

說明：
通過 cell.AddTable(True) 方法在單元格內創(chuàng)建嵌套表格。每個嵌套表格可以獨立設置行數、列數和樣式，非常適合展示具有層級關系的數據，如產品分類、部門組織結構等。

6. 技術細節(jié)總結與關鍵類方法概覽

在前面的章節(jié)中，我們展示了如何使用 Free Spire.Doc for Python 創(chuàng)建基礎表格、設置表格樣式、合并與拆分單元格以及創(chuàng)建嵌套表格。從技術實現角度來看，Word 表格操作的核心流程可以總結為以下幾個關鍵步驟：

Python Word 表格操作步驟總結

創(chuàng)建文檔對象使用 Document() 創(chuàng)建 Word 文檔對象，通過 AddSection() 添加節(jié)，為表格提供容器。
創(chuàng)建表格使用 section.AddTable(True) 創(chuàng)建表格，通過 ResetCells() 設置表格的行數和列數。
填充表格內容通過 table.Rows[row_index].Cells[col_index] 訪問單元格，使用 AddParagraph().AppendText() 方法添加文本內容。
設置單元格格式使用 CellFormat 屬性設置單元格的背景顏色、垂直對齊方式、邊框等樣式。
合并與拆分單元格使用 ApplyHorizontalMerge() 和 ApplyVerticalMerge() 方法合并單元格，使用 SplitCell() 方法拆分單元格。
應用表格樣式使用 ApplyStyle() 應用預設的表格樣式，或通過 Format.Borders 自定義邊框樣式。
保存文檔使用 SaveToFile() 方法將文檔保存到指定路徑。

關鍵類、方法與屬性

類 / 方法 / 屬性	說明
`Document`	Word 文檔對象，支持創(chuàng)建、加載和保存文檔
`Document.SaveToFile()`	將文檔保存到指定文件路徑
`Section`	表示文檔中的節(jié)，是表格的容器對象
`Table`	表示表格對象，包含行和單元格
`Paragraph`	表示段落對象
`TextRange.CharacterFormat`	獲取文本格式對象，用于設置字體、大小、加粗等

通過理解上述關鍵類、方法和屬性，你可以靈活地創(chuàng)建各種類型的 Word 表格，并根據業(yè)務需求進行精細定制。掌握這些技術細節(jié)，能讓你在實際項目中快速生成高質量、格式統(tǒng)一的 Word 文檔報表，同時保持代碼簡潔和可維護性。

總結

本文以實際業(yè)務場景為例，展示了如何使用 Free Spire.Doc for Python 在 Word 文檔中創(chuàng)建基礎表格、設置表格樣式、合并與拆分單元格、創(chuàng)建嵌套表格等實用功能。通過編程方式生成表格，不僅避免了手動操作的繁瑣和易錯問題，還能輕松應對批量報告和復雜數據呈現需求。

掌握這一技能后，你可以將文檔生成與數據管理完全自動化，從而節(jié)省時間，提高效率，并為業(yè)務流程提供可靠的文檔支持。結合 Free Spire.Doc 的其他功能，如文檔模板、郵件合并、圖表插入等，可以進一步打造智能化的 Word 文檔自動化工作流，讓企業(yè)的文檔處理能力提升到新的高度。

以上就是使用Python在Word文檔中創(chuàng)建表格并設置各種格式的詳細內容，更多關于Python Word創(chuàng)建表格并設置格式的資料請關注腳本之家其它相關文章！

您可能感興趣的文章: