Python操作Word文档全攻略

怎么入门文章编程？需要学习哪些知识点？这是新手们刚接触编程时常见的问题；下面golang学习网就来给大家整理分享一些知识点，希望能够给初学者一些帮助。本篇文章就来介绍《Python操作Word文档方法详解》，涉及到，有需要的可以收藏一下

使用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文档，然后往里加点内容，比如一个标题，再来几段正文，这都是基本操作。

from docx import Document
from docx.shared import Inches
from docx.enum.text import WD_ALIGN_PARAGRAPH

# 创建一个新文档
document = Document()

# 添加一个标题
document.add_heading('Python自动化文档生成示例', level=1)

# 添加一个段落
p = document.add_paragraph('这是第一段正文。')
p.add_run(' 这句话是').bold = True
p.add_run('加粗的。')
p.add_run(' 这一句是').italic = True
p.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].cells
hdr_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 Document
from docx.shared import Inches, Cm

document = 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 Document

document = 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].cells
hdr_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 = job

document.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 Document
from docx.enum.text import WD_ALIGN_PARAGRAPH

document = Document()
document.add_heading('样式设置示例', level=2)

# 段落对齐
p_center = document.add_paragraph('这段文字居中对齐。')
p_center.alignment = WD_ALIGN_PARAGRAPH.CENTER

p_right = document.add_paragraph('这段文字右对齐。')
p_right.alignment = WD_ALIGN_PARAGRAPH.RIGHT

# 文字样式
p_style = document.add_paragraph('这是一段正文。')
run1 = p_style.add_run('这里是加粗文字。')
run1.bold = True
run2 = p_style.add_run(' 这里是斜体文字。')
run2.italic = True
run3 = 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文档全攻略》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于Python,word文档,python-docx,插入图片,插入表格的知识点！