Python操作docx表格文字：从基础到进阶的完整指南

在自动化办公场景中，Word文档（.docx格式）的表格处理是高频需求。Python通过python-docx库提供了强大的表格操作能力，本文将从基础操作到高级技巧，系统讲解如何通过Python实现表格的创建、文字编辑、样式设置及复杂功能。

一、环境准备与基础概念

1.1 环境配置

安装python-docx库是首要步骤，推荐使用虚拟环境隔离依赖：

python -m venv docx_env
source docx_env/bin/activate  # Linux/Mac
docx_env\Scripts\activate     # Windows
pip install python-docx

1.2 核心对象模型

python-docx通过三个核心类操作表格：

• Document：代表整个文档对象
• Table：表格对象，包含行和列
• Cell：单元格对象，存储文字和样式

二、表格基础操作

2.1 创建表格

使用add_table()方法创建表格，需指定行数和列数：

from docx import Document
doc = Document()
table = doc.add_table(rows=3, cols=3)  # 3行3列表格
doc.save("basic_table.docx")

2.2 访问单元格

通过行列索引访问单元格（从0开始）：

cell = table.cell(0, 1)  # 第1行第2列
cell.text = "示例文字"

2.3 遍历表格

使用嵌套循环遍历所有单元格：

for row in table.rows:
    for cell in row.cells:
        print(cell.text)

三、表格文字处理

3.1 文字写入与读取

• 写入文字：直接赋值cell.text属性
• 读取文字：通过cell.text获取内容

# 批量写入数据
data = [
    ["姓名", "年龄", "职业"],
    ["张三", "28", "工程师"],
    ["李四", "32", "设计师"]
]
for i, row_data in enumerate(data):
    for j, text in enumerate(row_data):
        table.cell(i, j).text = str(text)

3.2 文字格式设置

通过Paragraph和Run对象设置字体样式：

from docx.shared import Pt, RGBColor
cell = table.cell(0, 0)
paragraph = cell.paragraphs[0]
run = paragraph.add_run("标题")
run.bold = True
run.font.size = Pt(14)
run.font.color.rgb = RGBColor(0, 0, 255)  # 蓝色

3.3 多段落文字处理

单个单元格可包含多个段落：

cell = table.cell(1, 1)
cell.text = ""  # 清空默认段落
cell.add_paragraph("第一段").add_run("加粗").bold = True
cell.add_paragraph("第二段")

四、表格样式设置

4.1 表格样式应用

预置样式通过style属性设置：

table.style = "Table Grid"  # 带边框的表格
table.style = "Light Shading"  # 浅色底纹

4.2 自定义样式

通过add_table_style()创建新样式（需配合docx.styles模块）：

from docx.oxml.ns import qn
from docx.oxml import OxmlElement
def set_table_style(table):
    tbl = table._tbl
    tblPr = tbl.get_or_add_tblPr()
    tblW = OxmlElement('w:tblW')
    tblW.set(qn('w:w'), '5000')  # 表格宽度5000缇（约17.6cm）
    tblW.set(qn('w:type'), 'pct')
    tblPr.append(tblW)
set_table_style(table)

4.3 单元格样式控制

• 背景色：
  ```python
  from docx.shared import Pt, RGBColor

shading = OxmlElement(‘w:shd’)
shading.set(qn(‘w:fill’), ‘FF0000’) # 红色背景
cell._tc.get_or_add_tcPr().append(shading)

- **边框设置**：
```python
from docx.oxml import OxmlElement
from docx.oxml.ns import qn
def set_cell_border(cell, border_type, color, width):
    tc = cell._tc
    tcPr = tc.get_or_add_tcPr()
    for line in ('top', 'left', 'bottom', 'right'):
        tag = f'w:{line}'
        element = OxmlElement(tag)
        element.set(qn('w:val'), border_type)
        element.set(qn('w:sz'), str(width))
        element.set(qn('w:color'), color)
        tcPr.append(element)
set_cell_border(table.cell(0, 0), 'single', '000000', 4)  # 黑色单线边框

五、高级功能实现

5.1 动态表格生成

根据数据动态调整行列数：

def create_dynamic_table(doc, data):
    rows = len(data)
    cols = len(data[0]) if rows > 0 else 0
    table = doc.add_table(rows=rows, cols=cols)
    for i, row_data in enumerate(data):
        for j, text in enumerate(row_data):
            table.cell(i, j).text = str(text)
    return table
data = [["ID", "产品", "价格"], [1, "笔记本", 5999], [2, "手机", 3999]]
create_dynamic_table(doc, data)

5.2 表格合并单元格

使用merge()方法合并单元格：

# 合并第1行的第1-2列
cell = table.cell(0, 0)
cell.merge(table.cell(0, 1))

5.3 表格与文档其他元素交互

• 在表格前后添加内容：

  doc.add_paragraph("表格前内容")
  table = doc.add_table(...)
  doc.add_paragraph("表格后内容")

• 表格中插入图片：
  ```python
  from docx.shared import Inches

cell = table.cell(1, 1)
paragraph = cell.paragraphs[0]
run = paragraph.add_run()
run.add_picture(“image.png”, width=Inches(1.0))

## 六、实际应用案例
### 6.1 自动化报表生成
```python
def generate_report(output_path):
    doc = Document()
    # 添加标题
    doc.add_heading("季度销售报表", level=0)
    # 创建表格
    sales_data = [
        ["季度", "销售额(万)", "增长率"],
        ["Q1", 120, "-"],
        ["Q2", 150, "25%"],
        ["Q3", 180, "20%"]
    ]
    table = doc.add_table(rows=len(sales_data), cols=len(sales_data[0]))
    # 填充数据并设置样式
    for i, row in enumerate(sales_data):
        for j, text in enumerate(row):
            cell = table.cell(i, j)
            cell.text = str(text)
            if i == 0:  # 表头样式
                paragraph = cell.paragraphs[0]
                run = paragraph.runs[0]
                run.font.bold = True
                run.font.color.rgb = RGBColor(255, 255, 255)
                cell._tc.get_or_add_tcPr().append(
                    OxmlElement('w:shd').set(
                        qn('w:fill'), '4F81BD'
                    )
                )
    doc.save(output_path)
generate_report("sales_report.docx")

6.2 数据导出为Word表格

将数据库查询结果导出为Word表格：

import sqlite3
from docx import Document
def export_to_word(db_path, output_path):
    conn = sqlite3.connect(db_path)
    cursor = conn.cursor()
    cursor.execute("SELECT * FROM products")
    data = cursor.fetchall()
    headers = [desc[0] for desc in cursor.description]
    doc = Document()
    table = doc.add_table(rows=1, cols=len(headers))
    # 添加表头
    for j, header in enumerate(headers):
        table.cell(0, j).text = header
    # 添加数据行
    for row in data:
        row_cells = table.add_row().cells
        for j, value in enumerate(row):
            row_cells[j].text = str(value)
    doc.save(output_path)
    conn.close()
export_to_word("products.db", "products_report.docx")

七、常见问题与解决方案

7.1 中文乱码问题

确保使用支持中文的字体：

from docx.shared import Pt
style = doc.styles['Normal']
font = style.font
font.name = '微软雅黑'
font._element.rPr.rFonts.set(qn('w:eastAsia'), '微软雅黑')

7.2 表格宽度控制

通过列宽设置实现均匀分布：

def set_column_widths(table, widths):
    """widths: 列宽比例列表，如[1, 2, 1]表示三列比例为1:2:1"""
    for i, width in enumerate(widths):
        for row in table.rows:
            row.cells[i].width = Pt(width * 30)  # 30pt为基准单位

7.3 性能优化

处理大型表格时：

• 使用doc.save()前关闭其他程序
• 分批处理数据，避免内存溢出
• 考虑使用docx.opc.constants中的常量优化XML结构

八、总结与展望

python-docx库为Word表格自动化提供了完整的解决方案，从基础操作到高级样式控制均能实现。开发者应掌握：

1. 核心对象模型（Document/Table/Cell）
2. 文字处理与格式设置
3. 样式定制技巧
4. 动态表格生成方法

未来发展方向包括：

• 与Pandas等数据分析库深度集成
• 实现更复杂的表格布局（如跨页表格）
• 开发可视化表格设计工具

通过系统学习这些技术，开发者可以显著提升文档处理效率，为企业自动化流程提供有力支持。