表格是Word文档中常见的元素，用于组织和展示数据。python-docx提供了灵活的API来创建、修改和格式化表格，使您能够高效地处理各种表格数据。本章将详细介绍如何使用python-docx创建和操作表格。

1 创建表格

python-docx允许您轻松地创建和初始化表格。可以通过add_table()方法在文档中添加一个新的表格。

1.1 创建一个简单的表格

创建一个简单的表格需要指定行数和列数：

from docx import Document

# 创建一个新的文档
doc = Document()

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

1.2 为表格添加标题行

可以通过在创建表格后手动添加标题行来创建具有标题的表格：

# 获取表格的第一行
hdr_cells = table.rows[0].cells

# 为标题行的每个单元格添加内容
hdr_cells[0].text = '标题1'
hdr_cells[1].text = '标题2'
hdr_cells[2].text = '标题3'

1.3 在特定位置插入表格

如果需要在文档中的特定位置插入表格，可以使用add_paragraph()来指定表格的插入点：

# 在特定位置插入表格
para = doc.add_paragraph("以下是一个表格：")
table = doc.add_table(rows=2, cols=3)

这样，表格将被插入到指定段落的后面。

2 操作表格单元格

在表格创建后，您可以通过操作单元格来填充或修改表格内容。

2.1 向单元格添加内容

可以通过cell()方法获取表格中的某个单元格，并向其中添加内容：

# 向单元格添加文本内容
cell = table.cell(0, 0)
cell.text = '单元格内容'

2.2 合并单元格

合并单元格是表格操作中的常见需求，python-docx允许您合并行或列中的相邻单元格：

# 合并第一行的第二、三个单元格
merged_cell = table.cell(0, 1).merge(table.cell(0, 2))

# 设置合并后的单元格内容
merged_cell.text = '合并后的单元格内容'

2.3 修改单元格内容

修改单元格内容与添加内容类似，只需重新赋值即可：

# 修改单元格内容
cell = table.cell(1, 1)
cell.text = '修改后的内容'

2.4 删除表格行与列

python-docx不直接提供删除表格行或列的方法，但您可以通过操作底层的XML结构实现：

# 删除第一行
table._element.remove(table.rows[0]._element)

类似地，可以删除列或特定的单元格内容。

3 表格样式与格式化

表格的样式和格式化是影响表格展示效果的关键因素。python-docx提供了多种方法来格式化表格。

3.1 设置表格样式

python-docx支持Word内置的多种表格样式，您可以通过设置style属性应用这些样式：

# 设置表格样式为“Table Grid”
table.style = 'Table Grid'

您可以尝试不同的内置样式，如LightShading-Accent1、LightGrid-Accent2等，选择适合您需求的表格样式。

3.2 设置表格边框

您可以通过操作表格的每个单元格来设置边框的样式和颜色：

from docx.oxml import OxmlElement
from docx.oxml.ns import qn

# 为单元格设置边框
cell = table.cell(0, 0)
tc = cell._tc
tcPr = tc.get_or_add_tcPr()
tcBorders = OxmlElement('w:tcBorders')

# 设置边框样式
for border_name in ['top', 'left', 'bottom', 'right']:
    border = OxmlElement(f'w:{border_name}')
    border.set(qn('w:val'), 'single')
    border.set(qn('w:sz'), '4')
    border.set(qn('w:space'), '0')
    border.set(qn('w:color'), '000000')  # 设置黑色
    tcBorders.append(border)

tcPr.append(tcBorders)

3.3 设置单元格背景颜色

通过操作shd元素，可以为表格的单元格设置背景颜色：

# 设置单元格背景颜色为浅灰色
shading_elm = OxmlElement('w:shd')
shading_elm.set(qn('w:fill'), "D3D3D3")
table.cell(0, 0)._element.get_or_add_tcPr().append(shading_elm)

3.4 设置表格对齐方式

表格的对齐方式可以通过表格的alignment属性来设置：

from docx.enum.table import WD_TABLE_ALIGNMENT

# 表格居中对齐
table.alignment = WD_TABLE_ALIGNMENT.CENTER

同样，也可以设置单元格内的文本对齐方式：

from docx.enum.text import WD_ALIGN_PARAGRAPH

# 单元格内文本居中对齐
cell = table.cell(0, 0)
cell.paragraphs[0].alignment = WD_ALIGN_PARAGRAPH.CENTER

4 调整表格的行高与列宽

在某些情况下，您可能需要调整表格的行高和列宽来满足特定的排版需求。

1 设置列宽

您可以通过操作每个单元格的宽度来设置列宽：

from docx.shared import Inches

# 设置第一列的宽度为2英寸
for row in table.rows:
    row.cells[0].width = Inches(2)

2 设置行高

类似地，可以设置行高：

# 设置第一行的行高
row = table.rows[0]
row.height = Inches(0.5)

调整行高和列宽可以帮助您更精确地控制表格布局，提升文档的专业性。

5 表格的遍历与数据操作

在处理复杂表格时，遍历表格中的行和列进行批量操作是很常见的需求。

5.1 遍历表格的行与列

可以使用简单的循环遍历表格的所有行和列，进行相应的操作：

# 遍历表格的所有单元格并打印其内容
for row in table.rows:
    for cell in row.cells:
        print(cell.text)

5.2 向表格添加行

在表格末尾添加新行非常简单，只需调用add_row()方法：

# 添加一行新行
new_row = table.add_row()
new_row.cells[0].text = "新行内容"

5.3 从外部数据源填充表格

可以从外部数据源（如列表、字典、数据库等）批量填充表格内容：

data = [
    ["第一列", "第二列", "第三列"],
    ["数据1", "数据2", "数据3"],
]

# 将数据填充到表格中
for i, row_data in enumerate(data):
    row = table.rows[i]
    for j, cell_data in enumerate(row_data):
        row.cells[j].text = cell_data

这种操作方式可以极大地提高填充表格的效率。