Python操作Word文档7种方法的实现与对比(史上最全)

 更新时间:2025年03月08日 11:16:14   作者:极客代码  
在Python中操作Word文档是一项常见的任务,特别是在办公自动化和数据处理领域,本文将详细总结和对比几种常用的Python库和方法,有需要的可以了解下

在Python中操作Word文档是一项常见的任务,特别是在办公自动化和数据处理领域。本文将详细总结和对比几种常用的Python库和方法,包括它们的优缺点、适用场景以及具体的代码示例。我们将深入探讨每种方法的具体功能和使用技巧,帮助你更好地理解和选择合适的方法。

1. python-docx

概述:

python-docx 是一个用于创建和修改Microsoft Word文档(.docx格式)的Python库。它提供了丰富的API,使得开发者可以轻松地生成和编辑Word文档。

主要功能:

  • 创建新的Word文档
  • 添加段落、标题、图片、表格等
  • 设置文本格式(字体、大小、颜色等)
  • 读取和修改现有文档的内容
  • 插入分页符、书签、超链接等

优点:

  • 跨平台:可以在任何支持Python的平台上运行。
  • 易于使用:API简洁明了,文档详尽。
  • 功能丰富:支持多种文档元素的创建和编辑。

缺点:

  • 只支持 .docx 格式,不支持 .doc 格式。
  • 对于复杂的Word文档(如包含宏或嵌入对象的文档)支持有限。

适用场景:

  • 创建和编辑简单的Word文档。
  • 自动生成报告、简历等文档。
  • 批量处理Word文档。

详细功能和代码示例:

1.创建和编辑文档

from docx import Document
from docx.shared import Pt, Inches

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

# 添加标题
doc.add_heading('文档标题', 0)

# 添加段落
doc.add_paragraph('这是文档的第一个段落。')

# 添加带有样式的文本
p = doc.add_paragraph('这是一个带')
run = p.add_run('有特殊格式')
run.bold = True
run.italic = True

# 设置字体样式
run = p.add_run('这是设置字体的文本')
run.font.name = 'Arial'
run.font.size = Pt(14)
run.font.bold = True
run.font.italic = True
run.font.color.rgb = RGBColor(0xFF, 0x00, 0x00)  # 红色

# 添加图片
doc.add_picture('path_to_image.jpg', width=Inches(1.25))

# 添加表格
table = doc.add_table(rows=2, cols=3)
table.cell(0, 0).text = '行1列1'
table.cell(0, 1).text = '行1列2'
table.cell(1, 0).text = '行2列1'

# 添加分页符
doc.add_page_break()

# 添加书签
p = doc.add_paragraph('这是书签位置')
p.add_bookmark('bookmark_name')

# 添加超链接
p = doc.add_paragraph('这是一个超链接:')
run = p.add_hyperlink('https://www.example.com', '点击这里')

# 保存文档
doc.save('example.docx')

2.读取和修改现有文档

from docx import Document

# 打开现有文档
doc = Document('existing_document.docx')

# 读取文档内容
for para in doc.paragraphs:
    print(para.text)

# 修改文档内容
para = doc.paragraphs[0]
para.text = '这是修改后的内容'

# 添加新段落
doc.add_paragraph('这是添加的新段落')

# 删除段落
para = doc.paragraphs[1]
p = para._element
p.getparent().remove(p)
p._p = p._element = None

# 保存修改后的文档
doc.save('modified_document.docx')

2. docx-mailmerge

概述:

docx-mailmerge 是一个用于批量生成Word文档的库。它允许你在Word模板中定义占位符,然后通过Python脚本填充这些占位符,生成多个类似的文档。

主要功能:

  • 读取Word模板文件
  • 替换模板中的占位符
  • 生成多个文档

优点:

  • 简单易用:只需要定义模板和数据即可生成多个文档。
  • 支持复杂的数据结构:可以处理嵌套的数据。

缺点:

  • 功能相对单一:主要适用于邮件合并场景。
  • 不支持复杂的文档编辑操作。

适用场景:

  • 批量生成合同、发票、证书等文档。
  • 自动化生成个性化报告。

详细功能和代码示例:

创建模板和生成文档

from mailmerge import MailMerge

# 打开模板文件
template = MailMerge('template.docx')

# 查看模板中的占位符
print(template.get_merge_fields())

# 定义数据
data = {
    'name': 'John Doe',
    'address': '123 Main St',
    'city': 'Anytown',
    'state': 'Anystate',
    'zip': '12345'
}

# 生成文档
template.merge(**data)
template.write('output.docx')

# 生成多个文档
data_list = [
    {'name': 'John Doe', 'address': '123 Main St', 'city': 'Anytown', 'state': 'Anystate', 'zip': '12345'},
    {'name': 'Jane Smith', 'address': '456 Elm St', 'city': 'Othertown', 'state': 'Otherstate', 'zip': '67890'}
]

for i, data in enumerate(data_list):
    template.merge(**data)
    template.write(f'output_{i+1}.docx')

3. win32com.client

概述:

win32com.client 是一个用于在Python中调用Windows COM对象的库。通过它,你可以直接控制Microsoft Word应用程序,实现对Word文档的高级操作。

主要功能:

  • 打开和关闭Word应用程序
  • 创建和编辑文档
  • 读取和修改文档内容
  • 处理复杂的文档结构(如宏、嵌入对象等)

优点:

  • 功能强大:可以实现几乎所有的Word操作。
  • 支持 .doc 和 .docx 格式。

缺点:

  • 仅限Windows平台。
  • 学习曲线较陡峭:需要熟悉COM对象和Word的内部结构。
  • 性能较低:由于需要启动Word应用程序,可能会有性能损失。

适用场景:

  • 需要进行复杂文档操作的场景。
  • 处理包含宏或嵌入对象的文档。

详细功能和代码示例:

1.创建和编辑文档

import os
from win32com.client import Dispatch

# 打开Word应用程序
word = Dispatch('Word.Application')
word.Visible = 0  # 后台运行,不显示
word.DisplayAlerts = 0  # 不显示警告

# 创建新文档
doc = word.Documents.Add()

# 添加标题
doc.Paragraphs.Add().Range.Text = '文档标题'
doc.Paragraphs.Last.Range.Font.Bold = True
doc.Paragraphs.Last.Range.Font.Size = 16

# 添加段落
doc.Paragraphs.Add().Range.Text = '这是文档的第一个段落。'

# 添加带有样式的文本
p = doc.Paragraphs.Add().Range
p.Text = '这是一个带'
p.Font.Bold = False
p.Font.Italic = False
p.Collapse(0)  # wdCollapseEnd
p.Text = '有特殊格式'
p.Font.Bold = True
p.Font.Italic = True

# 设置字体样式
p.Collapse(0)  # wdCollapseEnd
p.Text = '这是设置字体的文本'
p.Font.Name = 'Arial'
p.Font.Size = 14
p.Font.Bold = True
p.Font.Italic = True
p.Font.Color = 255  # 红色

# 添加图片
doc.InlineShapes.AddPicture('path_to_image.jpg', LinkToFile=False, SaveWithDocument=True)

# 添加表格
table = doc.Tables.Add(Range=doc.Paragraphs.Add().Range, NumRows=2, NumColumns=3)
table.Cell(1, 1).Range.Text = '行1列1'
table.Cell(1, 2).Range.Text = '行1列2'
table.Cell(2, 1).Range.Text = '行2列1'

# 添加分页符
doc.Paragraphs.Add().Range.InsertBreak(7)  # wdPageBreak

# 添加书签
doc.Bookmarks.Add('bookmark_name', doc.Paragraphs.Add().Range)
doc.Bookmarks['bookmark_name'].Range.Text = '这是书签位置'

# 添加超链接
p = doc.Paragraphs.Add().Range
p.Hyperlinks.Add(Anchor=p, Address='https://www.example.com', SubAddress='', ScreenTip='点击这里', TextToDisplay='点击这里')

# 保存文档
doc.SaveAs('example.docx')

# 关闭文档和Word应用程序
doc.Close()
word.Quit()

2.读取和修改现有文档

import os
from win32com.client import Dispatch

# 打开Word应用程序
word = Dispatch('Word.Application')
word.Visible = 0  # 后台运行,不显示
word.DisplayAlerts = 0  # 不显示警告

# 打开现有文档
doc = word.Documents.Open('existing_document.docx')

# 读取文档内容
for para in doc.Paragraphs:
    print(para.Range.Text)

# 修改文档内容
para = doc.Paragraphs[0]
para.Range.Text = '这是修改后的内容'

# 添加新段落
doc.Paragraphs.Add().Range.Text = '这是添加的新段落'

# 删除段落
para = doc.Paragraphs[1]
para.Range.Delete()

# 保存修改后的文档
doc.Save()

# 关闭文档和Word应用程序
doc.Close()
word.Quit()

4. mammoth

概述:

mammoth 是一个用于将Word文档(.docx格式)转换为HTML的库。它可以帮助你将Word文档的内容提取出来,以便在Web应用中使用。

主要功能:

  • 将 .docx 文件转换为 HTML
  • 提取文档中的文本和样式信息

优点:

  • 轻量级:专注于文档转换,不依赖于其他库。
  • 易于集成:可以轻松地将转换后的HTML嵌入到Web应用中。

缺点:

  • 功能单一:主要用于文档转换,不支持文档编辑操作。
  • 不支持复杂的样式转换:某些复杂的样式可能无法完全保留。

适用场景:

  • 将Word文档转换为HTML,用于Web展示。
  • 提取文档中的纯文本内容。

详细功能和代码示例:

转换文档

from mammoth import convert_to_html

# 读取 .docx 文件
with open('input.docx', 'rb') as docx_file:
    result = convert_to_html(docx_file)

# 获取转换后的HTML
html = result.value

# 保存HTML文件
with open('output.html', 'w', encoding='utf-8') as html_file:
    html_file.write(html)

# 处理转换错误
if result.messages:
    for message in result.messages:
        print(f"Error: {message.type} - {message.message}")

5. pandoc

概述:

pandoc 是一个强大的文档转换工具,支持多种格式之间的转换。虽然它不是一个Python库,但可以通过Python脚本调用 pandoc 命令来实现文档转换。

主要功能:

  • 将多种格式的文档转换为Word文档(.docx)
  • 支持Markdown、LaTeX等多种格式

优点:

  • 支持广泛的文档格式。
  • 转换质量高:能够很好地保留原始文档的格式。

缺点:

  • 需要安装 pandoc 命令行工具。
  • 不支持文档编辑操作。

适用场景:

  • 将其他格式的文档转换为Word文档。
  • 需要高质量文档转换的场景。

详细功能和代码示例:

转换文档

import subprocess

# 调用 pandoc 命令将 Markdown 文件转换为 Word 文档
subprocess.run(['pandoc', 'input.md', '-o', 'output.docx'])

# 调用 pandoc 命令将 LaTeX 文件转换为 Word 文档
subprocess.run(['pandoc', 'input.tex', '-o', 'output.docx'])

# 调用 pandoc 命令将 HTML 文件转换为 Word 文档
subprocess.run(['pandoc', 'input.html', '-o', 'output.docx'])

# 处理转换错误
try:
    subprocess.run(['pandoc', 'input.md', '-o', 'output.docx'], check=True)
except subprocess.CalledProcessError as e:
    print(f"Error: {e.returncode} - {e.output}")

6. PyWinAuto

概述:

PyWinAuto 是一个自动化测试工具,可以用来模拟用户操作,包括打开和编辑Word文档。这种方法适用于需要进行复杂交互操作的场景。

主要功能:

  • 模拟用户操作(点击、输入文本等)
  • 控制应用程序窗口和菜单

优点:

  • 灵活性高:可以模拟任何用户操作。
  • 支持复杂的交互操作。

缺点:

  • 仅限Windows平台。
  • 学习曲线较陡峭:需要熟悉自动化测试的概念和技术。

适用场景:

  • 需要进行复杂交互操作的场景。
  • 测试和验证Word文档的功能。

详细功能和代码示例:

模拟用户操作

from pywinauto.application import Application

# 启动Word应用程序
app = Application().start('C:\\Program Files\\Microsoft Office\\Office16\\WINWORD.EXE')
app.connect(title='无标题 - Word')

# 模拟输入文本
app.window(title='无标题 - Word').type_keys('Hello, World!', with_spaces=True)

# 保存文档
app.window(title='无标题 - Word').menu_select('文件->另存为...')
app.window(title='另存为').type_keys('C:\\path\\to\\file.docx', with_spaces=True)
app.window(title='另存为').button('保存').click()

# 关闭文档
app.window(title='无标题 - Word').menu_select('文件->关闭')

# 关闭Word应用程序
app.kill()

7. Apache POI via Py4J

概述:

Apache POI 是一个Java库,用于处理Microsoft Office文件格式。通过 Py4J,你可以在Python中调用Java代码,从而利用 Apache POI 处理Word文档。

主要功能:

  • 创建和编辑Word文档
  • 读取和修改文档内容
  • 处理复杂的文档结构

优点:

  • 功能强大:可以实现几乎所有Word操作。
  • 支持多种Office文件格式。

缺点:

  • 需要安装Java环境。
  • 学习曲线较陡峭:需要熟悉Java和 Py4J 的使用。

适用场景:

  • 需要处理复杂文档结构的场景。
  • 需要跨平台支持的场景。

详细功能和代码示例:

创建和编辑文档

首先,你需要安装 Py4J 和 Apache POI,然后编写一个Java类来处理Word文档。

// Java code (WordProcessor.java)
import org.apache.poi.xwpf.usermodel.*;

public class WordProcessor {
    public void createDocument(String path) {
        XWPFDocument document = new XWPFDocument();
        
        // 添加标题
        XWPFParagraph titlePara = document.createParagraph();
        titlePara.setAlignment(ParagraphAlignment.CENTER);
        XWPFRun titleRun = titlePara.createRun();
        titleRun.setText("文档标题");
        titleRun.setFontSize(16);
        titleRun.setBold(true);
        
        // 添加段落
        XWPFParagraph para = document.createParagraph();
        XWPFRun run = para.createRun();
        run.setText("这是文档的第一个段落。");
        
        // 添加带有样式的文本
        run = para.createRun();
        run.setText("这是一个带");
        run = para.createRun();
        run.setText("有特殊格式");
        run.setBold(true);
        run.setItalic(true);
        
        // 设置字体样式
        run = para.createRun();
        run.setText("这是设置字体的文本");
        run.setFontFamily("Arial");
        run.setFontSize(14);
        run.setBold(true);
        run.setItalic(true);
        run.setColor("FF0000");  // 红色
        
        // 添加图片
        try {
            InputStream pictureStream = new FileInputStream("path_to_image.jpg");
            document.addPictureData(pictureStream, Document.PICTURE_TYPE_JPEG);
            int pictureIndex = document.getAllPictures().size();
            XWPFParagraph picPara = document.createParagraph();
            XWPFRun picRun = picPara.createRun();
            picRun.addPicture(document.getAllPictures().get(pictureIndex - 1), Document.PICTURE_TYPE_JPEG, "image.jpg", Units.toEMU(100), Units.toEMU(100));
        } catch (Exception e) {
            e.printStackTrace();
        }
        
        // 添加表格
        XWPFTable table = document.createTable(2, 3);
        table.getRow(0).getCell(0).setText("行1列1");
        table.getRow(0).getCell(1).setText("行1列2");
        table.getRow(1).getCell(0).setText("行2列1");
        
        // 添加分页符
        XWPFParagraph pageBreakPara = document.createParagraph();
        pageBreakPara.createRun().addBreak(BreakType.PAGE);
        
        // 添加书签
        XWPFParagraph bookmarkPara = document.createParagraph();
        bookmarkPara.createBookmark("bookmark_name");
        bookmarkPara.createRun().setText("这是书签位置");
        
        // 添加超链接
        XWPFParagraph linkPara = document.createParagraph();
        XWPFHyperlink link = linkPara.createHyperlink();
        link.setAddress("https://www.example.com");
        link.createRun().setText("点击这里");
        
        // 保存文档
        try {
            FileOutputStream out = new FileOutputStream(path);
            document.write(out);
            out.close();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

然后在Python中调用这个Java类:

from py4j.java_gateway import JavaGateway, GatewayClient

# 启动Java Gateway
gateway = JavaGateway(GatewayClient(port=25333), start_callback_server=True)

# 获取Java对象
word_processor = gateway.entry_point.getWordProcessor()

# 调用Java方法
word_processor.createDocument("output.docx")

# 关闭Gateway
gateway.close()

总结

方法主要功能优点缺点适用场景
python-docx创建、编辑Word文档跨平台、易于使用、功能丰富只支持 .docx 格式、不支持复杂文档创建和编辑简单文档、自动生成报告
docx-mailmerge批量生成Word文档简单易用、支持复杂数据功能单一、不支持文档编辑批量生成合同、发票等
win32com.client控制Word应用程序功能强大、支持 .doc 和 .docx 格式仅限Windows平台、学习曲线陡峭复杂文档操作、处理嵌入对象
mammoth将 .docx 转换为 HTML轻量级、易于集成功能单一、不支持文档编辑文档转换、Web展示
pandoc文档格式转换支持广泛格式、转换质量高需要安装命令行工具文档转换、高质量输出
PyWinAuto模拟用户操作灵活性高、支持复杂交互仅限Windows平台、学习曲线陡峭复杂交互操作、测试验证
Apache POI via Py4J创建、编辑Word文档功能强大、支持多种格式需要Java环境、学习曲线陡峭复杂文档操作、跨平台支持

到此这篇关于Python操作Word文档7种方法的实现与对比(史上最全)的文章就介绍到这了,更多相关Python操作Word内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • 在Spyder中如何导入项目

    在Spyder中如何导入项目

    文章介绍了在Spyder中导入已存在项目时遇到的错误及解决方法,通过创建新项目并复制`.spyproject`文件夹到已存在项目中,可以成功导入项目,此外,还提到如何在Spyder中显示项目资源管理器
    2025-01-01
  • pytorch ImageFolder的覆写实例

    pytorch ImageFolder的覆写实例

    今天小编就为大家分享一篇pytorch ImageFolder的覆写实例,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-02-02
  • Pandas中的 transform()结合 groupby()用法示例详解

    Pandas中的 transform()结合 groupby()用法示例详解

    这篇文章主要介绍了Pandas中的 transform() 结合 groupby() 用法示例,本文通过一个餐厅数据集给大家分享解决方案,示例代码简单易懂,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友参考下吧
    2021-09-09
  • Python 中的判断语句,循环语句,函数

    Python 中的判断语句,循环语句,函数

    这篇文章主要介绍了Python 中的判断语句,循环语句,函数,文章围绕主题展开详细的内容介绍,具有一定的参考价值,需要的小伙伴可以参考一下
    2022-08-08
  • Python读写Redis数据库操作示例

    Python读写Redis数据库操作示例

    Redis是一个开源的非关系型数据库,它采用C语言编写,是一个key-value存储系统,它存储的value类型很多,包括string(字符串),list(链表),set(集合),zset(有序集合),hash(哈希)
    2014-03-03
  • 详解Python中列表数据的保存与读取

    详解Python中列表数据的保存与读取

    列表是一种非常灵活的数据结构,它可以包含多种类型的元素,本文将介绍如何将一组列表保存到txt文件中,并提供相应的读取方法,希望对大家有所帮助
    2024-04-04
  • python3使用pandas获取股票数据的方法

    python3使用pandas获取股票数据的方法

    今天小编就为大家分享一篇python3使用pandas获取股票数据的方法,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2018-12-12
  • 基于Python编写新手向的简易翻译工具

    基于Python编写新手向的简易翻译工具

    对于刚接触编程的新手来说,编写一个实用的工具是快速入门的好方法,本文将详细介绍如何用 Python 编写一个简易的翻译工具,需要的小伙伴可以了解下
    2025-08-08
  • flask框架中的cookie和session使用

    flask框架中的cookie和session使用

    这篇文章主要介绍了flask框架中的cookie和session使用,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2021-01-01
  • python多维列表总是只转为一维数组问题解决

    python多维列表总是只转为一维数组问题解决

    这篇文章主要为大家介绍了python多维列表总是只转为一维数组问题解决实例详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2022-09-09

最新评论