使用python-docx库可在word文档中插入图片和表格,1. 插入图片需调用document.add_picture()方法并指定文件路径及宽度(如inches或cm);2. 插入表格需调用document.add_table()方法设置行列数,并通过遍历行和单元格填充数据;同时可应用样式如table grid。该库支持基本样式设置,但对复杂布局和大型文档需注意性能与功能限制,建议结合模板使用以提升效率,最终生成结构清晰、格式规范的.docx文档。

Python操作Word文档,最常用的工具非
python-docx
库莫属。它提供了一套相当直观的接口,让我们可以像搭积木一样,创建、修改甚至读取
.docx
格式的Word文件。从插入文字、图片,到排版表格、调整样式,几乎日常能想到的文档自动化需求,它都能满足。
要操作Word文档,首先得确保你安装了
python-docx
库。如果还没装,一行命令就能搞定:
pip install python-docx
。
你看,这上手简直不要太简单。创建一个新的Word文档,然后往里加点内容,比如一个标题,再来几段正文,这都是基本操作。
立即学习“Python免费学习笔记(深入)”;
from docx import Documentfrom docx.shared import Inchesfrom docx.enum.text import WD_ALIGN_PARAGRAPH# 创建一个新文档document = Document()# 添加一个标题document.add_heading('Python自动化文档生成示例', level=1)# 添加一个段落p = document.add_paragraph('这是第一段正文。')p.add_run(' 这句话是').bold = Truep.add_run('加粗的。')p.add_run(' 这一句是').italic = Truep.add_run('斜体的。')document.add_paragraph('这是第二段正文,我们可以在这里继续添加内容。')# 添加一个三级标题document.add_heading('更多内容展示', level=3)# 添加一个列表document.add_paragraph('项目列表:', style='List Bullet')document.add_paragraph('第一项', style='List Bullet')document.add_paragraph('第二项', style='List Bullet')# 添加一个表格table = document.add_table(rows=1, cols=3)hdr_cells = table.rows[0].cellshdr_cells[0].text = '标题1'hdr_cells[1].text = '标题2'hdr_cells[2].text = '标题3'# 添加数据行data = [ ('数据A1', '数据A2', '数据A3'), ('数据B1', '数据B2', '数据B3')]for item in data: row_cells = table.add_row().cells row_cells[0].text = item[0] row_cells[1].text = item[1] row_cells[2].text = item[2]# 添加图片(确保你的路径下有这张图片,或者换成一个实际存在的图片路径)try: document.add_picture('example.png', width=Inches(4)) document.add_paragraph('这是一张插入的图片。')except FileNotFoundError: document.add_paragraph('注意:图片文件 "example.png" 未找到,请确保路径正确或替换为实际图片。')# 保存文档document.save('我的自动化文档.docx')print("文档 '我的自动化文档.docx' 已生成。")# 当然,读取现有文档内容也行,虽然有时候结构复杂了点,但基本段落和表格内容还是能抓出来的。# from docx import Document# existing_doc = Document('我的自动化文档.docx')# for para in existing_doc.paragraphs:# print(para.text)## for table in existing_doc.tables:# for row in table.rows:# for cell in row.cells:# print(cell.text, end='t')# print()
如何使用Python在Word文档中插入图片和表格?
这俩功能,图片和表格,在自动化报告里简直是标配。
python-docx
在这方面做得挺到位。
插入图片,主要用到
document.add_picture()
方法。你需要提供图片文件的路径,还可以选择性地指定图片的宽度或高度。宽度通常用
Inches
(英寸)或
Cm
(厘米)来表示,这比直接给像素值更符合Word的排版习惯。
from docx import Documentfrom docx.shared import Inches, Cmdocument = Document()document.add_heading('图片插入示例', level=2)# 插入一张图片,并指定宽度为4英寸# 假设当前目录下有一张名为 'my_image.jpg' 的图片try: document.add_picture('my_image.jpg', width=Inches(4)) document.add_paragraph('上面是一张宽度为4英寸的图片。')except FileNotFoundError: document.add_paragraph('图片文件 "my_image.jpg" 未找到,请自行准备或修改路径。')# 插入一张图片,并指定宽度为10厘米# try:# document.add_picture('another_image.png', width=Cm(10))# document.add_paragraph('上面是一张宽度为10厘米的图片。')# except FileNotFoundError:# document.add_paragraph('图片文件 "another_image.png" 未找到。')document.save('带图片的文档.docx')print("文档 '带图片的文档.docx' 已生成。")
至于表格,
document.add_table()
是入口。你得先告诉它表格有多少行多少列。然后,你可以通过
table.rows
和
table.cells
来访问单元格,往里面填内容。添加新的行就用
table.add_row()
。我记得有一次,需要批量生成带图表分析的报告,如果没有这玩意儿,估计得手点到抽筋。
from docx import Documentdocument = Document()document.add_heading('表格插入示例', level=2)# 创建一个3行4列的表格table = document.add_table(rows=3, cols=4)table.style = 'Table Grid' # 应用一个内置表格样式,让表格有边框# 填充表头hdr_cells = table.rows[0].cellshdr_cells[0].text = '姓名'hdr_cells[1].text = '年龄'hdr_cells[2].text = '城市'hdr_cells[3].text = '职业'# 填充数据行data_rows = [ ('张三', '30', '北京', '工程师'), ('李四', '25', '上海', '设计师')]for name, age, city, job in data_rows: row_cells = table.add_row().cells row_cells[0].text = name row_cells[1].text = age row_cells[2].text = city row_cells[3].text = jobdocument.add_paragraph('上面是一个包含数据的表格。')document.save('带表格的文档.docx')print("文档 '带表格的文档.docx' 已生成。")
Python处理Word文档时常见的样式设置有哪些?
文档嘛,除了内容还得有颜值。
python-docx
在样式控制上,虽然不像Word本身那么细致入微,但常用的基本都覆盖了。记住,文字的样式一般作用在
run
对象上,而段落的对齐、缩进什么的,那得找
paragraph
对象。
文字加粗、斜体、下划线: 这是最基础的。通过
run
对象的
bold
,
italic
,
underline
属性设置为
True
或
False
。段落对齐:
paragraph
对象有一个
alignment
属性,可以设置为
WD_ALIGN_PARAGRAPH.LEFT
,
WD_ALIGN_PARAGRAPH.CENTER
,
WD_ALIGN_PARAGRAPH.RIGHT
,
WD_ALIGN_PARAGRAPH.JUSTIFY
等。应用内置样式: Word本身有很多内置样式,比如“标题1”、“正文”、“列表”等。
python-docx
可以直接通过
document.add_paragraph(text, style='Style Name')
或
document.add_heading(text, level=N)
来应用这些样式。这省去了手动设置字体、字号、段落间距的麻烦。
from docx import Documentfrom docx.enum.text import WD_ALIGN_PARAGRAPHdocument = Document()document.add_heading('样式设置示例', level=2)# 段落对齐p_center = document.add_paragraph('这段文字居中对齐。')p_center.alignment = WD_ALIGN_PARAGRAPH.CENTERp_right = document.add_paragraph('这段文字右对齐。')p_right.alignment = WD_ALIGN_PARAGRAPH.RIGHT# 文字样式p_style = document.add_paragraph('这是一段正文。')run1 = p_style.add_run('这里是加粗文字。')run1.bold = Truerun2 = p_style.add_run(' 这里是斜体文字。')run2.italic = Truerun3 = p_style.add_run(' 这里是带下划线的文字。')run3.underline = True# 应用内置标题样式document.add_heading('这是一个H1级别的标题', level=1)document.add_heading('这是一个H2级别的标题', level=2)# 应用列表样式document.add_paragraph('项目一', style='List Bullet')document.add_paragraph('项目二', style='List Number')document.save('带样式的文档.docx')print("文档 '带样式的文档.docx' 已生成。")
处理大型或复杂Word文档时Python-docx有哪些注意事项?
说实话,
python-docx
虽好,但也不是万能药。尤其是在处理一些超大型或者Word里那些“奇技淫巧”的功能时,就得留心了。
性能与内存: 如果文档里图片特别多,或者表格行数上万,那生成起来肯定慢,内存占用也得注意。别指望它能瞬间搞定一个几百MB的文档。对于极端情况,你可能需要考虑分批处理或者优化数据结构。不支持的功能: 像Word里那些复杂的形状、SmartArt、批注、宏、VBA代码、以及一些高级的布局(比如文字环绕图片、多列布局)之类的,
python-docx
目前基本是无能为力的。它主要聚焦在结构化文本和基础排版上。如果你需要操作这些高级特性,可能得考虑直接操作DOCX的XML结构(那可就复杂多了),或者寻找其他更专业的文档处理库。错误处理: 文件路径不对?或者尝试操作一个损坏的文档?那肯定会报错。所以,
try-except
是老朋友了,在文件操作和数据处理时,总是要做好异常捕获,确保程序健壮性。使用模板: 一个很实用的技巧是先用Word做好一个模板,里面留好占位符(比如
{{name}}
,
[图片位置]
),然后用Python打开模板,替换掉占位符内容。这样能省很多样式设置的麻烦,也能更好地控制最终文档的视觉效果。这比从零开始构建文档要高效得多,特别是当你有固定的报告格式时。
总的来说,
python-docx
是一个非常棒的工具,尤其适合那些有明确结构、需要批量生成的文档任务。但如果你期望它能完全替代Word本身的所有高级功能,那可能就有点不切实际了。理性看待,巧妙运用,效率自然就上来了。
以上就是Python怎样操作Word文档?python-docx库详解的详细内容,更多请关注创想鸟其它相关文章!
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1367724.html
微信扫一扫
支付宝扫一扫