Python + Spire.Doc 操作 Word 批注：添加、回复
在团队协作和文档审阅中，批注允许审阅者在不修改正文的前提下添加备注、建议或图片。当需要批量处理或集成到自动化流程时，用 Python 操作 Word 批注能显著提升效率。本文基于 Spire.Doc for Python 库，演示如何用代码添加段落批注、针对特定文本批注、回复已有批注、提取批注内容，以及修改和删除批注。环境准备
安装 Spire.Doc for Python 库，它提供了完整的 Word 批注 API。在终端中执行：
pip install Spire.Doc
安装后导入相应模块即可开始编程。
基础操作：为段落添加批注
最常见的场景是在指定段落末尾附加一条批注。通过获取文档节（Section）中的段落对象，调用 AppendComment() 方法，同时设置作者和缩写。
from spire.doc import *
from spire.doc.common import *
document = Document()
document.LoadFromFile("示例文档.docx")
section = document.Sections
paragraph = section.Paragraphs
comment = paragraph.AppendComment("可以给一些例图")
comment.Format.Author = "审阅者A"
comment.Format.Initial = "RA"
document.SaveToFile("AddComment.docx", FileFormat.Docx)
document.Close()
AppendComment() 接收字符串作为批注内容，返回 Comment 对象。通过 Format 属性可设置作者和缩写，这些信息会显示在 Word 批注面板中。
为特定文本添加批注
实际审阅中常需要对段落中的某一段关键文字添加批注。此时需先查找目标文本，再通过 CommentMark 标记起止范围，最后将 Comment 绑定到该范围。
from spire.doc import *
from spire.doc.common import *
document = Document()
document.LoadFromFile("input.docx")
# 查找目标文本
keystring = "关键数据"
find = document.FindString(keystring, False, True)
# 创建批注标记
commentmarkStart = CommentMark(document)
commentmarkStart.Type = CommentMarkType.CommentStart
commentmarkStart.CommentId = 1
commentmarkEnd = CommentMark(document)
commentmarkEnd.CommentId = 1
commentmarkEnd.Type = CommentMarkType.CommentEnd
# 创建批注内容
comment = Comment(document)
comment.Format.CommentId = 1
comment.Body.AddParagraph().Text = "此处数据请补充原始出处。"
comment.Format.Author = "审阅者B"
# 获取查找结果所在的段落和位置
range = find.GetRanges()
para = range.OwnerParagraph
index = para.ChildObjects.IndexOf(range)
# 插入批注标记并绑定
para.ChildObjects.Insert(index, commentmarkStart)
para.ChildObjects.Insert(index + 2, commentmarkEnd)
para.ChildObjects.Add(comment)
document.SaveToFile("CommentOnSpecificText.docx", FileFormat.Docx)
document.Close()
核心思路：先用 FindString() 定位目标文本，再用 CommentMark 的 CommentStart 和 CommentEnd 标记作用范围，最后将 Comment 对象添加到段落中。CommentId 必须一致，用于关联标记和批注内容。
回复批注
多人协作审阅时，对已有批注进行回复可形成讨论链。通过 ReplyToComment() 方法创建回复。
from spire.doc import *
from spire.doc.common import *
doc = Document()
doc.LoadFromFile("CommentOnSpecificText.docx")
originalComment = doc.Comments.get_Item(0)
replyComment = Comment(doc)
replyComment.Format.Author = "原作者"
replyComment.Body.AddParagraph().AppendText("已补充，参见参考文献第三条。")
originalComment.ReplyToComment(replyComment)
if originalComment.OwnerParagraph:
originalComment.OwnerParagraph.ChildObjects.Add(replyComment)
doc.SaveToFile("ReplyToComment.docx", FileFormat.Docx)
doc.Close()
创建新 Comment 对象并设置作者和内容，调用原始批注的 ReplyToComment() 方法建立关系，然后将回复批注作为子对象添加到原批注所在段落。
提取批注内容
文档包含大量批注时，可通过遍历 Comments 集合一次性提取作者和内容。
from spire.doc import *
from spire.doc.common import *
doc = Document()
doc.LoadFromFile("Commented.docx")
for i in range(doc.Comments.Count):
comment = doc.Comments.get_Item(i)
author = comment.Format.Author
for j in range(comment.Body.Paragraphs.Count):
p = comment.Body.Paragraphs.get_Item(j)
print(f"[{author}] {p.Text}")
doc.Close()
遍历 doc.Comments，每条批注获取作者和正文。实际应用可将结果写入文件或数据库，便于批量分析和跟踪。
修改和删除批注
审阅过程中可能需要修改批注内容或删除不再需要的批注。
from spire.doc import *
from spire.doc.common import *
doc = Document()
doc.LoadFromFile("Commented.docx")
# 修改第一条批注的内容
doc.Comments.Body.Paragraphs.Replace("原始批注内容", "修改后的批注内容", False, False)
# 删除第二条批注
doc.Comments.RemoveAt(1)
doc.SaveToFile("ModifyComment.docx", FileFormat.Docx)
doc.Close()
Replace() 用于在批注正文中查找并替换文本，RemoveAt() 根据索引移除指定批注。结合使用可灵活管理文档批注。
总结
以上代码覆盖了文档批注的核心操作：段落批注、特定文本批注、回复、提取、修改删除。在这些基础上还可探索在批注中插入图片、批量处理多个文档、导出批注报告等高级功能，有助于构建完善的文档自动化处理流程。
Re: Python + Spire.Doc 操作 Word 批注：添加、回复
感谢楼主的详细分享！Spire.Doc 这个库处理 Word 批注确实方便，特别是 `AppendComment` 和 `ReplyToComment` 的组合，能轻松模拟多人协作的审阅流程。针对特定文本加批注那部分，通过 `CommentMark` 标记范围的做法很实用，我之前在处理类似需求时还苦恼于怎么精准定位，这下有思路了。另外，提取批注内容遍历 `Comments` 集合也很高效，收藏备用！Re: Python + Spire.Doc 操作 Word 批注：添加、回复
感谢分享，这个教程很详细，特别是针对特定文本添加批注和回复批注的部分，之前一直没找到清晰的实现思路。请问如果文档中有多处相同的“关键数据”，而我只想给其中某一段添加批注，应该如何定位到具体的那一次出现呢？Re: Python + Spire.Doc 操作 Word 批注：添加、回复
感谢分享！这个教程很实用，正好解决了我在批量处理Word审阅时的痛点。之前手动操作太繁琐，用Python自动添加和回复批注确实能省不少时间。请问文档里提到的Spire.Doc库对中文批注的兼容性怎么样？我试过其他库，有时中文会乱码。还有，如果需要在批注里插入图片，您有没有试过？另外，希望后续能补充一下“删除批注”的具体示例。再次感谢，准备拿您的代码试试效果。
页:
[1]