Python-docx表格排版实战：从基础对齐到专业文档生成-CSDN博客

1. 从零开始：为什么你需要掌握Python-docx的表格排版？

如果你经常需要处理Word文档，尤其是那些包含大量数据表格的报告、合同或者方案，那你肯定对重复的手动调整感到头疼。我刚开始做数据分析的时候，每周都要手动生成十几份周报，光是调整表格的对齐、样式就得花上大半天，效率低不说，还容易出错。后来发现了Python-docx这个库，简直像是打开了新世界的大门。它不是什么高深莫测的黑科技，而是一个能让你用Python代码轻松操作Word文档的工具，特别适合批量处理和自动化生成。

简单来说，Python-docx能让你像搭积木一样，用代码“画”出一个结构清晰、排版专业的Word文档。而表格，作为文档中承载数据、对比信息的关键元素，它的美观与否直接决定了文档的专业度。一个单元格文字左对齐、右对齐乱七八糟的表格，和一个所有内容都整齐居中的表格，给人的观感是天差地别的。很多新手朋友拿到这个库，知道怎么把数据塞进表格，但一到调整排版就卡壳，生成的文档总差那么点意思。这篇文章，我就把我这些年用Python-docx处理表格排版的经验和踩过的坑，掰开揉碎了讲给你听，从最基础的单元格对齐，一直讲到如何生成一份可以直接交付的专业级文档。

2. 环境搭建与核心对象：你的第一张自动化表格

工欲善其事，必先利其器。开始之前，我们得先把环境准备好。安装非常简单，打开你的命令行（终端），输入下面这行命令就行：

pip install python-docx

我这里强烈建议你创建一个虚拟环境来操作，避免和你系统里其他的Python包产生冲突。安装完成后，我们就可以在代码里引入它了。理解Python-docx操作文档的逻辑很重要，它把整个Word文档看作一个由不同对象组成的树形结构。对于表格来说，你需要理清这几个核心对象的关系，我画个简单的层级图帮你理解：

Document：文档本身，一切操作的起点。
Table：表格对象。一个文档里可以有多个表格，它们被放在一个列表里。
Row：行对象。一个表格由多行组成。
Cell：单元格对象。一行由多个单元格组成，这是我们进行排版操作的最小单位。
Paragraph：段落对象。每个单元格里可以有一个或多个段落（想象一下你在一个单元格里按了回车换行）。
Run：文本块。段落里可以有多个不同样式的文本块，比如加粗几个字。

理解了这些，我们来看怎么创建一个文档并添加第一个表格。下面这段代码，我建议你跟着敲一遍，感受一下整个过程：

from docx import Document
from docx.shared import Inches

# 1. 创建一个新的Word文档对象
doc = Document()

# 2. 给文档加个标题
doc.add_heading('我的第一份自动化报告', 0)

# 3. 添加一个3行4列的表格
# 第一个参数是行数，第二个参数是列数
table = doc.add_table(rows=3, cols=4)

# 4. 给表格填充一些示例数据
data = [
    ['产品', '第一季度', '第二季度', '增长率'],
    ['产品A', '120万', '150万', '25%'],
    ['产品B', '80万', '95万', '18.75%']
]

# 遍历数据，填充到表格的每个单元格中
for i, row_data in enumerate(data):
    # 获取表格的第i行
    row = table.rows[i]
    for j, cell_data in enumerate(row_data):
        # 获取第i行第j列的单元格，并写入数据
        row.cells[j].text = str(cell_data)

# 5. 保存文档
doc.save('我的第一份报告.docx')

运行这段代码，你会得到一个名为“我的第一份报告.docx”的文件。打开它，你会看到一个有数据的表格，但所有文字都挤在单元格的左上角，看起来不太美观。别急，我们接下来就解决这个问题。

3. 对齐的奥秘：搞定水平与垂直居中

表格排版里，对齐是最基础也最让人困惑的点。很多人搞不清“表格整体对齐”、“单元格内文本对齐”和“单元格内文本垂直对齐”这三者的区别。我刚开始也在这里绕了很久，咱们一个一个来拆解。

3.1 单元格内文本的水平居中

这是最常用的需求。我们想让单元格里的文字在水平方向上居中显示。关键就在于操作单元格（Cell）里的段落（Paragraph）。每个单元格默认至少有一个段落，即使你没输入任何文字。所以，我们需要设置这个段落的对齐属性。

from docx import Document
from docx.enum.text import WD_ALIGN_PARAGRAPH

doc = Document()
table = doc.add_table(rows=2, cols=3)

# 填充数据
table.cell(0, 0).text = '姓名'
table.cell(0, 1).text = '部门'
table.cell(0, 2).text = '销售额'
table.cell(1, 0).text = '张三'
table.cell(1, 1).text = '市场部'
table.cell(1, 2).text = '¥120,000'

# 关键步骤：设置每个单元格内段落的水平对齐方式
for row in table.rows:
    for cell in row.cells:
        # 获取单元格的第一个段落（也是默认的段落）
        paragraph = cell.paragraphs[0]
        # 设置段落对齐方式为居中
        paragraph.alignment = WD_ALIGN_PARAGRAPH.CENTER

doc.save('水平居中示例.docx')

这里有个细节需要注意：WD_ALIG