Python + Spire.Doc 操作 Word 批注：添加、回复

脚本专家

在团队协作和文档审阅中，批注允许审阅者在不修改正文的前提下添加备注、建议或图片。当需要批量处理或集成到自动化流程时，用 Python 操作 Word 批注能显著提升效率。本文基于 Spire.Doc for Python 库，演示如何用代码添加段落批注、针对特定文本批注、回复已有批注、提取批注内容，以及修改和删除批注。

环境准备
安装 Spire.Doc for Python 库，它提供了完整的 Word 批注 API。在终端中执行：

2. pip install Spire.Doc

复制代码

安装后导入相应模块即可开始编程。

基础操作：为段落添加批注
最常见的场景是在指定段落末尾附加一条批注。通过获取文档节（Section）中的段落对象，调用 AppendComment() 方法，同时设置作者和缩写。

2. from spire.doc import *
3. from spire.doc.common import *
5. document = Document()
6. document.LoadFromFile("示例文档.docx")
8. section = document.Sections[0]
9. paragraph = section.Paragraphs[3]
11. comment = paragraph.AppendComment("可以给一些例图")
12. comment.Format.Author = "审阅者A"
13. comment.Format.Initial = "RA"
15. document.SaveToFile("AddComment.docx", FileFormat.Docx)
16. document.Close()

复制代码

AppendComment() 接收字符串作为批注内容，返回 Comment 对象。通过 Format 属性可设置作者和缩写，这些信息会显示在 Word 批注面板中。

为特定文本添加批注
实际审阅中常需要对段落中的某一段关键文字添加批注。此时需先查找目标文本，再通过 CommentMark 标记起止范围，最后将 Comment 绑定到该范围。

2. from spire.doc import *
3. from spire.doc.common import *
5. document = Document()
6. document.LoadFromFile("input.docx")
8. # 查找目标文本
9. keystring = "关键数据"
10. find = document.FindString(keystring, False, True)
12. # 创建批注标记
13. commentmarkStart = CommentMark(document)
14. commentmarkStart.Type = CommentMarkType.CommentStart
15. commentmarkStart.CommentId = 1
17. commentmarkEnd = CommentMark(document)
18. commentmarkEnd.CommentId = 1
19. commentmarkEnd.Type = CommentMarkType.CommentEnd
21. # 创建批注内容
22. comment = Comment(document)
23. comment.Format.CommentId = 1
24. comment.Body.AddParagraph().Text = "此处数据请补充原始出处。"
25. comment.Format.Author = "审阅者B"
27. # 获取查找结果所在的段落和位置
28. range = find.GetRanges()
29. para = range[0].OwnerParagraph
30. index = para.ChildObjects.IndexOf(range[0])
32. # 插入批注标记并绑定
33. para.ChildObjects.Insert(index, commentmarkStart)
34. para.ChildObjects.Insert(index + 2, commentmarkEnd)
35. para.ChildObjects.Add(comment)
37. document.SaveToFile("CommentOnSpecificText.docx", FileFormat.Docx)
38. document.Close()

复制代码

核心思路：先用 FindString() 定位目标文本，再用 CommentMark 的 CommentStart 和 CommentEnd 标记作用范围，最后将 Comment 对象添加到段落中。CommentId 必须一致，用于关联标记和批注内容。

回复批注
多人协作审阅时，对已有批注进行回复可形成讨论链。通过 ReplyToComment() 方法创建回复。

2. from spire.doc import *
3. from spire.doc.common import *
5. doc = Document()
6. doc.LoadFromFile("CommentOnSpecificText.docx")
8. originalComment = doc.Comments.get_Item(0)
10. replyComment = Comment(doc)
11. replyComment.Format.Author = "原作者"
12. replyComment.Body.AddParagraph().AppendText("已补充，参见参考文献第三条。")
14. originalComment.ReplyToComment(replyComment)
16. if originalComment.OwnerParagraph:
17.     originalComment.OwnerParagraph.ChildObjects.Add(replyComment)
19. doc.SaveToFile("ReplyToComment.docx", FileFormat.Docx)
20. doc.Close()

复制代码

创建新 Comment 对象并设置作者和内容，调用原始批注的 ReplyToComment() 方法建立关系，然后将回复批注作为子对象添加到原批注所在段落。

提取批注内容
文档包含大量批注时，可通过遍历 Comments 集合一次性提取作者和内容。

2. from spire.doc import *
3. from spire.doc.common import *
5. doc = Document()
6. doc.LoadFromFile("Commented.docx")
8. for i in range(doc.Comments.Count):
9.     comment = doc.Comments.get_Item(i)
10.     author = comment.Format.Author
11.     for j in range(comment.Body.Paragraphs.Count):
12.         p = comment.Body.Paragraphs.get_Item(j)
13.         print(f"[{author}] {p.Text}")
15. doc.Close()

复制代码

遍历 doc.Comments，每条批注获取作者和正文。实际应用可将结果写入文件或数据库，便于批量分析和跟踪。

修改和删除批注
审阅过程中可能需要修改批注内容或删除不再需要的批注。

2. from spire.doc import *
3. from spire.doc.common import *
5. doc = Document()
6. doc.LoadFromFile("Commented.docx")
8. # 修改第一条批注的内容
9. doc.Comments[0].Body.Paragraphs[0].Replace("原始批注内容", "修改后的批注内容", False, False)
11. # 删除第二条批注
12. doc.Comments.RemoveAt(1)
14. doc.SaveToFile("ModifyComment.docx", FileFormat.Docx)
15. doc.Close()

复制代码

Replace() 用于在批注正文中查找并替换文本，RemoveAt() 根据索引移除指定批注。结合使用可灵活管理文档批注。

总结
以上代码覆盖了文档批注的核心操作：段落批注、特定文本批注、回复、提取、修改删除。在这些基础上还可探索在批注中插入图片、批量处理多个文档、导出批注报告等高级功能，有助于构建完善的文档自动化处理流程。

热心网友7

感谢楼主的详细分享！Spire.Doc 这个库处理 Word 批注确实方便，特别是 `AppendComment` 和 `ReplyToComment` 的组合，能轻松模拟多人协作的审阅流程。针对特定文本加批注那部分，通过 `CommentMark` 标记范围的做法很实用，我之前在处理类似需求时还苦恼于怎么精准定位，这下有思路了。另外，提取批注内容遍历 `Comments` 集合也很高效，收藏备用！

热心网友7

感谢分享，这个教程很详细，特别是针对特定文本添加批注和回复批注的部分，之前一直没找到清晰的实现思路。请问如果文档中有多处相同的“关键数据”，而我只想给其中某一段添加批注，应该如何定位到具体的那一次出现呢？

热心网友7

感谢分享！这个教程很实用，正好解决了我在批量处理Word审阅时的痛点。之前手动操作太繁琐，用Python自动添加和回复批注确实能省不少时间。请问文档里提到的Spire.Doc库对中文批注的兼容性怎么样？我试过其他库，有时中文会乱码。还有，如果需要在批注里插入图片，您有没有试过？另外，希望后续能补充一下“删除批注”的具体示例。再次感谢，准备拿您的代码试试效果。