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

用 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))

# word  # python  # 中文乱码  # microsoft  # 微软  # word文档  # 常见问题  # red 

相关文章： 黑客如何利用漏洞与弱口令入侵网站服务器？  长沙企业网站制作哪家好,长沙水业集团官方网站？  企业网站制作公司网页,推荐几家专业的天津网站制作公司？  建站主机空间推荐 高性价比配置与快速部署方案解析  整蛊网站制作软件,手机不停的收到各种网站的验证码短信,是手机病毒还是人为恶搞?有这种手机病毒吗？  高端建站三要素：定制模板、企业官网与响应式设计优化  如何快速重置建站主机并恢复默认配置？  导航网站建站方案与优化指南：一站式高效搭建技巧解析  常州自助建站：操作简便模板丰富，企业个人快速搭建网站  如何解决ASP生成WAP建站中文乱码问题？  ,有什么在线背英语单词效率比较高的网站？  如何在Mac上搭建Golang开发环境_使用Homebrew安装和管理Go版本  郑州企业网站制作公司,郑州招聘网站有哪些？  网页制作模板网站推荐,网页设计海报之类的素材哪里好？  专业型网站制作公司有哪些,我设计专业的，谁给推荐几个设计师兼职类的网站？  桂林网站制作公司有哪些,桂林马拉松怎么报名？  制作农业网站的软件,比较好的农业网站推荐一下？  c++怎么编写动态链接库dll_c++ __declspec(dllexport)导出与调用【方法】  教程网站设计制作软件,怎么创建自己的一个网站？  网站制作公司广州有几家,广州尚艺美发学校网站是多少？  手机钓鱼网站怎么制作视频,怎样拦截钓鱼网站。怎么办？  如何在云主机上快速搭建多站点网站？  完全自定义免费建站平台：主题模板在线生成一站式服务  购物网站制作公司有哪些,哪个购物网站比较好？  Bpmn 2.0的XML文件怎么画流程图  如何在阿里云ECS服务器部署织梦CMS网站？  宝塔建站教程：一键部署配置流程与SEO优化实战指南  如何在Golang中处理模块冲突_解决依赖版本不兼容问题  无锡营销型网站制作公司,无锡网选车牌流程？  图册素材网站设计制作软件,图册的导出方式有几种？  如何制作算命网站,怎么注册算命网站？  php能控制zigbee模块吗_php通过串口与cc2530 zigbee通信【介绍】  测试制作网站有哪些,测试性取向的权威测试或者网站？  实现点击下箭头变上箭头来回切换的两种方法【推荐】  清除minerd进程的简单方法  如何快速配置高效服务器建站软件？  网站制作说明怎么写,简述网页设计的流程并说明原因？  定制建站哪家更专业可靠？推荐榜单揭晓  行程制作网站有哪些,第三方机票电子行程单怎么开？  已有域名如何快速搭建专属网站？  c++ stringstream用法详解_c++字符串与数字转换利器  小型网站制作HTML,*游戏网站怎么搭建？  魔方云NAT建站如何实现端口转发？  如何通过虚拟机搭建网站？详细步骤解析  如何在香港服务器上快速搭建免备案网站？  建站主机如何选？高性价比方案全解析  如何获取开源自助建站系统免费下载链接？  网站制作壁纸教程视频,电脑壁纸网站？  如何挑选优质建站一级代理提升网站排名？  网页设计与网站制作内容,怎样注册网站？