PythonWord文档自动生成_docx模块实战讲解【教程】-Python教程-PHP中文网

PythonWord文档自动生成_docx模块实战讲解【教程】

舞夢輝影

发布： 2025-12-20 04:37:16

原创

810人浏览过

pythonword文档自动生成_docx模块实战讲解【教程】

用 Python 自动生成 Word 文档，python-docx 是最常用、最稳定的方案。它不依赖 Microsoft Word，纯 Python 实现，适合批量生成合同、报告、成绩单等结构化文档。

安装只需一行命令：
pip install python-docx

核心对象有三个：
• Document：整个文档，是操作入口
• Paragraph：段落，可添加文字、样式、缩进等
• Table：表格，支持行列增删、单元格合并与格式设置

新建文档直接调用：
from docx import Document
doc = Document()

秒哒

秒哒-不用代码就能实现任意想法

584

文字必须放在段落（Paragraph）中，不能直接写入文档对象。
常用操作包括：

添加普通段落：doc.add_paragraph("这是第一段")
添加带样式的段落：doc.add_paragraph("标题", style="Heading 1")（内置样式名区分大小写）
对已有段落加粗/斜体/下划线：run = p.add_run("重点内容")
run.bold = True; run.italic = True; run.underline = True
设置行距、首行缩进（需访问 paragraph_format）：p.paragraph_format.line_spacing = 1.5
p.paragraph_format.first_line_indent = Cm(0.74)（需 from docx.shared import Cm）

表格是自动生成文档的高频需求，比如学生成绩单、订单明细：

创建 3 行 4 列空表：table = doc.add_table(rows=3, cols=4)
填入数据推荐用循环：for i, row_data in enumerate(data):
for j, cell_text in enumerate(row_data):
table.cell(i, j).text = str(cell_text)
合并单元格（如表头跨列）：table.cell(0, 0).merge(table.cell(0, 3))
设置列宽（单位为 EMU，Cm 更直观）：table.columns[0].width = Cm(3)

保存前务必调用 doc.save("output.docx")，文件后缀必须是 .docx（不是 .doc）。常见问题：

中文乱码？ 确保系统已安装中文字体（如 SimSun），并在 run.font.name 或 paragraph.style.font.name 中显式指定，同时用 run._element.rPr.rFonts.set(qn('w:eastAsia'), '微软雅黑') 设置东亚字体
样式不生效？ 不要直接修改 style 对象，而是用 p.style = doc.styles['Heading 2'] 赋值；自定义样式需先 add_style 再使用
图片插不进去？ 支持 PNG/JPEG，路径需为绝对路径或相对当前工作目录，doc.add_picture("chart.png", width=Cm(12))

以上就是PythonWord文档自动生成_docx模块实战讲解【教程】的详细内容，更多请关注php中文网其它相关文章！