Python处理Word文档中的批注(添加、删除)_Python

在多人协作编辑 word 文档时，批注可以帮助沟通修改意见、追踪讨论内容。无论是团队审阅报告，还是批改论文，批注都能让交流更直观。而如果你需要批量添加或删除批注，手动操作不仅耗时，还容易出错。本文将带你学习如何用 python 自动化处理 word 批注，让文档审阅更高效、更智能。

本文将使用 spire.doc 来演示怎样在 python 中添加和删除批注。你可以导航到 e-iceblue 官网下载这个专业的 word 库。

python 在 word 文档中快速添加批注

在具体操作之前，我们先来看最常见的应用场景——为 word 文档添加批注。批注可以帮助我们精准标出需要修改或关注的内容，方便团队成员快速理解反馈。根据使用场景的不同，添加批注通常分为针对段落和针对特定文本两种情况。

python 给段落添加批注

借助 spire.doc，你可以通过调用 paragraph.appendcomment() 方法为段落添加批注。下面是完整的示例代码，稍后我们将对其进行详细解析。

代码示例——对 word 文档中第十六段添加批注：

from spire.doc import *
from spire.doc.common import *

# 创建一个 document 类对象并加载一个 word 文档
doc = document()
doc.loadfromfile("e:/administrator/python1/input/ai绘画的利与弊-图片版.docx")

# 获取第一节
section = doc.sections.get_item(0)

# 获取第 16 段
paragraph = section.paragraphs.get_item(15)

# 向段落添加注释
comment = comment(doc)
comment.body.addparagraph().text = "可以列举一些案例"

# 设置注释的作者
comment.format.author = "陈莉"

paragraph.childobjects.add(comment)

# 创建注释开始标记和结束标记，并将它们设置为创建的注释的开始和结束标记
commentstart = commentmark(doc, commentmarktype.commentstart)
commentend = commentmark(doc, commentmarktype.commentend)
commentstart.commentid = comment.format.commentid
commentend.commentid = comment.format.commentid

# 在段落的开头和结尾分别插入注释开始标记和结束标记
paragraph.childobjects.insert(0, commentstart)
paragraph.childobjects.add(commentend)

# 保存文档
doc.savetofile("e:/administrator/python1/output/批注段落.docx")
doc.close()

下方为上面的代码添加的批注预览图：

代码解析：

加载需要批注的 word 文档。
通过索引先获取节，再获取想要批注的段落。需要注意的是，这里的段落是通过索引来获取的，所以一定要确定想要添加批注的段落到底是第几段。
通过 paragraph.appendcomment() 方法为该段落添加批注。
使用 comment.format.author 属性设置批注的作者。
创建评论开始标记和结束标记，并通过 commentmark.commentid 属性将它们设置为所创建评论的开始和结束标记。
通过 paragraph.childobjects.insert() 方法将批注开始标记和结束标记分别插入段首和段尾。

python 给指定文本添加批注

给文本添加批注是另一个常见需求，尤其适用于需要对专业术语、关键概念或表格数据进行说明或补充注释的场景。与为段落添加批注不同，你需要先查找目标文本，将其获取为文本范围，然后再为该范围添加批注。

代码示例——在 word 文档中给特定的文本添加批注：

from spire.doc import *
from spire.doc.common import *

# 创建一个 document 类的对象并加载一个 word 文档
doc = document()
doc.loadfromfile("e:/administrator/python1/output/批注段落.docx")

# 查找要添加评论的文本
text = doc.findstring("ai绘画逐渐", true, true)

# 创建一个评论对象并设置评论的内容和作者
comment = comment(doc)
comment.body.addparagraph().text = "可以解释一下什么是ai绘画"
comment.format.author = "张萍"

# 将找到的文本作为文本范围，并获取其所属的段落
range = text.getasonerange()
paragraph = range.ownerparagraph

# 将评论添加到段落中
paragraph.childobjects.insert(paragraph.childobjects.indexof(range) + 1, comment)

# 创建评论起始标记和结束标记，并将它们设置为创建的评论的起始标记和结束标记
commentstart = commentmark(doc, commentmarktype.commentstart)
commentend = commentmark(doc, commentmarktype.commentend)
commentstart.commentid = comment.format.commentid
commentend.commentid = comment.format.commentid

# 在找到的文本之前和之后插入创建的评论起始和结束标记
paragraph.childobjects.insert(paragraph.childobjects.indexof(range), commentstart)
paragraph.childobjects.insert(paragraph.childobjects.indexof(range) + 1, commentend)

# 保存文档
doc.savetofile("e:/administrator/python1/output/批注文本.docx")
doc.close()

下面是上方代码创建的批注预览：

代码解析：

加载需要批注的 word 文档。
通过 documemt.findstring() 方法查找指定文本。
创建批注类对象，通过 comment.body.addparagraph().text 属性设置批注内容，并通过 comment.format.author 属性设置批注作者。
使用 textselection.getasonerange() 方法将文本作为一个文本范围获取，并通过 textrange.ownerparagraph 属性获取文本所属的段落。
通过 paragraph.childobjects.insert() 方法在找到的文本后插入批注。
创建评论开始标记和结束标记，将它们设置为所创建评论的开始和结束标记。然后将批注开始标记和结束标记分别插入段首和段尾。

python 删除 word 文档中的批注

在文档审阅完成、准备生成最终稿时，删除 word 中的批注是必不可少的操作。这样不仅能让文章更清晰整洁，还能提升整体的专业感。借助 spire.doc，无论是删除单条批注，还是批量清除所有批注，都可以轻松实现。

代码示例——删除第二个批注：

from spire.doc import *
from spire.doc.common import *

# 创建一个 document 类对象并加载一个 word 文档
doc = document()
doc.loadfromfile("e:/administrator/python1/output/批注文本.docx")

# 移除第二个注释
doc.comments.removeat(1)

# 移除所有注释
#doc.comments.clear()

# 保存文档
doc.savetofile("e:/administrator/python1/output/删除批注.docx")
doc.close()

代码解析：