使用 python-docx 创建、读取和修改 Word 文档(.docx),支持文本、段落、表格、样式、图片等操作。
DOCX 文档操作工具
功能概述
DOCX 文档操作工具是一项面向实际任务的技能,主要用于使用 python-docx 库进行 Word 文档的创建、读取和修改;已安装 python-docx:;
核心要点
- 创建新文档;
- 读取现有文档;
- 修改现有文档;
使用与执行
可用表格样式;Table Grid - 基础网格;Light Grid Accent 1 - 浅色网格;Medium Grid 1 - 中等网格;Medium Grid 2 - 中等网格。它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。
结果检查与注意事项
从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。该技能适合用于一次性任务,也可以接入自动化工作流,与其他技能或上层代理配合完成更完整的业务链路;在组合使用时,应明确每一步的输入输出关系,并避免不同步骤之间出现参数冲突。
DOCX 文档操作工具
使用 python-docx 库进行 Word 文档的创建、读取和修改。
前置要求
已安装 python-docx:
pip install python-docx
常用操作
创建新文档
from docx import Document
from docx.shared import Inches, Pt, RGBColor
from docx.enum.text import WD_ALIGN_PARAGRAPH
# 创建新文档
doc = Document()
# 添加标题
doc.add_heading('文档标题', level=1)
# 添加段落
p = doc.add_paragraph('这是一个普通段落。')
p.add_run('这是加粗文字').bold = True
p.add_run(',这是普通文字。')
# 保存文档
doc.save('output.docx')
读取现有文档
from docx import Document
doc = Document('input.docx')
# 读取所有段落文本
for para in doc.paragraphs:
print(para.text)
# 读取表格
for table in doc.tables:
for row in table.rows:
for cell in row.cells:
print(cell.text)
添加表格
from docx import Document
doc = Document()
# 创建 3x3 表格
table = doc.add_table(rows=3, cols=3)
table.style = 'Light Grid Accent 1'
# 填充表头
hdr_cells = table.rows[0].cells
hdr_cells[0].text = '姓名'
hdr_cells[1].text = '年龄'
hdr_cells[2].text = '城市'
# 填充数据
row_cells = table.rows[1].cells
row_cells[0].text = '张三'
row_cells[1].text = '25'
row_cells[2].text = '北京'
doc.save('table.docx')
设置样式
from docx import Document
from docx.shared import Pt, RGBColor, Inches
from docx.enum.text import WD_ALIGN_PARAGRAPH
doc = Document()
# 添加标题并设置样式
heading = doc.add_heading('标题', level=1)
heading.alignment = WD_ALIGN_PARAGRAPH.CENTER
# 添加段落并设置格式
p = doc.add_paragraph()
run = p.add_run('自定义格式文字')
run.font.size = Pt(14)
run.font.bold = True
run.font.color.rgb = RGBColor(255, 0, 0)
# 设置段落间距
p.paragraph_format.space_before = Pt(12)
p.paragraph_format.space_after = Pt(12)
doc.save('styled.docx')
添加图片
from docx import Document
from docx.shared import Inches
doc = Document()
doc.add_heading('带图片的文档', level=1)
# 添加图片
doc.add_picture('image.png', width=Inches(5.0))
# 添加图片说明
doc.add_paragraph('图 1: 示例图片', style='Caption')
doc.save('with_image.docx')
修改现有文档
from docx import Document
doc = Document('existing.docx')
# 在开头插入段落
doc.paragraphs[0].insert_paragraph_before('新插入的段落')
# 修改现有段落
if doc.paragraphs:
doc.paragraphs[0].text = '修改后的文字'
# 添加新内容到末尾
doc.add_paragraph('添加到末尾的段落')
doc.save('modified.docx')
可用表格样式
Table Grid- 基础网格Light Grid Accent 1- 浅色网格Medium Grid 1- 中等网格Medium Grid 2- 中等网格 2Medium Grid 3- 中等网格 3
段落对齐方式
WD_ALIGN_PARAGRAPH.LEFT- 左对齐WD_ALIGN_PARAGRAPH.CENTER- 居中WD_ALIGN_PARAGRAPH.RIGHT- 右对齐WD_ALIGN_PARAGRAPH.JUSTIFY- 两端对齐
注意事项
- 文件格式: 仅支持 .docx 格式,不支持 .doc 格式
- 兼容性: 复杂格式在不同 Word 版本间可能有差异
- 图片: 支持的格式包括 PNG, JPEG, GIF, BMP
- 字体: 使用系统已安装的字体
热门AI工具
相关专题
Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章,帮助读者完成上线流程。
0
2026.10.28
Vite搭配Vue.js专题汇集创建Vue 3项目、配置开发环境、路径别名、Vue插件、代理、多环境构建与调试的已审核文章,帮助读者完成从初始化到日常开发的配置。
0
2026.10.28
Vite项目目录专题汇集入口文件、src源码、public静态资源、路径别名、项目根目录和构建输出目录相关的已审核文章,帮助读者理解各文件夹的用途与引用方式。
0
2026.10.28
本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。
0
2026.10.22
本专题介绍Gradle Wrapper的基本作用,涵盖文件组成、生成方法、版本配置和任务调用,帮助你理解项目如何使用指定的Gradle版本,减少不同开发环境带来的构建差异。
0
2026.10.22
本专题整理Golangci-lint常用Linters的用途与配置方法,覆盖错误处理、无效代码、安全、复杂度、命名和依赖检查,帮助项目合理选规则。
0
2026.10.22
本专题介绍Gradle Java项目构建方法,涵盖Java插件配置、依赖声明、源码编译、测试执行和打包检查,帮助你理解各阶段的任务关系,逐步完成项目构建。
0
2026.10.22
本专题汇总PHP常见时间戳漏洞,包括2038年溢出、时区漂移、时间戳伪造、重放攻击、时间盲注与日志审计失效等,并给出升级64位环境、使用 DateTimeImmutable、统一UTC、严格超时校验、预处理绑定、hash_equals 比对等修复方案,帮助开发者快速排查和加固时间相关代码。
0
2026.10.22
本专题聚焦Golangci-lint YAML配置文件,讲清运行参数、规则启停、目录排除、问题过滤及严重级别设置,便于团队统一检查标准。
0
2026.10.22
热门下载
相关下载
精品课程
共6课时 | 12.1万人学习
共79课时 | 161.6万人学习
共6课时 | 54.7万人学习