python-docx

Python Docx

概述

Python-docx 是一个用于创建和处理 Microsoft Word（.docx）文档的 Python 库。本技能涵盖文档自动化的全面模式，包括：

• 创建文档：从头开始创建或使用模板
• 段落格式：设置样式、字体和对齐方式
• 生成表格：合并单元格、设置样式和格式
• 页眉和页脚：添加页码和动态内容
• 插入图像：设置尺寸和位置
• 管理样式：保持文档外观一致
• 处理模板：用于文档工作流
• 邮件合并模式：批量生成文档

何时使用本技能

适用场景：

• 根据数据以编程方式创建 Word 文档
• 生成格式统一的报告
• 创建合同、发票或法律文档
• 自动化基于模板的文档创建
• 修改现有 Word 文档
• 创建表格结构复杂的文档
• 使用代码块生成技术文档
• 创建带有页眉和页脚的多节文档
• 创建嵌入图像和图表的文档
• 批量处理文档生成

不适用场景：

• 只需简单填充模板（请改用 docx-templates）
• 最终输出为 PDF（请改用 pypdf 或 reportlab）
• 需要实时协作编辑
• 文档需要复杂的宏或 VBA
• 需要保留复杂的 Word 功能（请在 Windows 上使用 COM 自动化）
• 只需从文档中提取文本（请改用 python-docx2txt）

前置条件

安装

# Using pip
pip install python-docx

# Using uv (recommended)
uv pip install python-docx

# With image support
pip install python-docx Pillow

# Full installation with all optional dependencies
pip install python-docx Pillow lxml

验证安装

from docx import Document
from docx.shared import Inches, Pt, Cm
from docx.enum.text import WD_ALIGN_PARAGRAPH
from docx.enum.table import WD_TABLE_ALIGNMENT

print("python-docx installed successfully!")

版本历史

1.0.0（2026-01-17）

• 初始创建技能
• 核心功能文档
• 6 个完整代码示例
• 集成模式
• 最佳实践指南
• 故障排除部分

资源

• 官方文档：https://python-docx.readthedocs.io/
• GitHub 仓库：https://github.com/python-openxml/python-docx
• PyPI 软件包：https://pypi.org/project/python-docx/
• Open XML SDK 参考：https://docs.microsoft.com/en-us/office/open-xml/

相关技能

• docx-templates - 用于 Word 文档的 Jinja2 风格模板渲染
• pypdf - PDF 处理和生成
• openpyxl - Excel 文件自动化
• python-pptx - PowerPoint 演示文稿生成

---

本技能提供了从生产环境文档生成系统中提炼的 Word 文档自动化全面模式。

子技能

• 1. 基本文档创建
• 2. 高级段落格式设置
• 3. 表格创建与格式设置
• 4. 页眉、页脚与页面设置
• 5. 图像插入与定位
• 6. 样式管理与自定义样式
• 数据库报告生成（+1）
• 批量文档生成
• 1. 文档结构（+3）
• 常见问题