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

安装与基础对象认知

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

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

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

插入文字与控制段落格式

文字必须放在段落（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))