Python Docx 表格格式

简介

Microsoft Word 是一款广泛使用的文字处理软件，而 Docx 是 Word 文档的一种常见格式。在处理 Word 文档时，我们经常需要对其中的表格进行操作，比如修改表格样式、插入数据等。Python 提供了一个强大的库叫做 python-docx，它可以帮助我们读取、创建和修改 Word 文档中的表格。

本文将详细介绍如何使用 python-docx 库来处理表格格式。我们将先了解 python-docx 的基本使用方法，然后探讨如何控制表格的样式，并最后给出一些实际应用的示例。

安装和导入

首先，我们需要通过 pip 安装 python-docx 库：

pip install python-docx

安装完成后，我们可以在代码中导入该库：

import docx

创建和保存 Word 文档

首先，我们需要创建一个空的 Word 文档，并保存到指定的路径：

from docx import Document

doc = Document()
doc.save("my_document.docx")

上述代码将创建一个名为 "my_document.docx" 的空 Word 文档。我们可以打开这个文档，验证是否创建成功。

创建表格

接下来，我们将在文档中创建一个简单的表格，并填入一些数据。下面的代码演示了如何创建一个 3 行 3 列的表格，并在每个单元格中填入数字 1 到 9：

from docx import Document

# 创建一个 3 行 3 列的表格
rows = 3
cols = 3
table = doc.add_table(rows=rows, cols=cols)

# 填入数据
data = [1, 2, 3, 4, 5, 6, 7, 8, 9]
for i in range(rows):
    for j in range(cols):
        cell = table.cell(i, j)
        cell.text = str(data[i * cols + j])

# 保存文档
doc.save("my_document.docx")

运行上述代码后，我们将得到一个包含有数字 1 到 9 的 3x3 表格。

控制表格样式

除了填充数据，我们还可以通过 python-docx 来控制表格的样式，包括字体、颜色、边框等。

设置字体和颜色

要设置表格中的文字字体和颜色，我们可以使用 run 对象。下面的代码演示了如何将表格中的第一行设置为红色字体：

from docx import Document
from docx.shared import RGBColor

# 创建文档和表格
doc = Document()
table = doc.add_table(rows=3, cols=3)

# 设置文字的字体和颜色
row = table.rows[0]
for cell in row.cells:
    cell_text = cell.paragraphs[0]
    run = cell_text.add_run()
    run.text = cell.text
    run.font.color.rgb = RGBColor(255, 0, 0)  # 设置为红色

# 保存文档
doc.save("my_document.docx")

设置边框和对齐方式

要设置表格的边框和对齐方式，我们可以使用 Table 对象的属性。下面的代码演示了如何将表格的边框设置为实线，并将表格内容居中对齐：

from docx import Document
from docx.enum.table import WD_BORDER_STYLE
from docx.enum.text import WD_PARAGRAPH_ALIGNMENT

# 创建文档和表格
doc = Document()
table = doc.add_table(rows=3, cols=3)

# 设置表格的边框样式
table.style = "Table Grid"  # 设置边框为实线

# 设置表格的对齐方式
table.alignment = WD_PARAGRAPH_ALIGNMENT.CENTER

# 保存文档
doc.save("my_document.docx")

示例应用

到目前为止，我们已经学习了如何使用 python-docx 创建和修改表格的基本样式。在实际应用中，我们可以将这些技术与其他功能结合起来，以满足我们的需求。