Python+Spire.XLS实现Excel批注自动化管理：添加、编辑、格式与删除

脚本专家

在团队协作处理 Excel 数据时，批注（Comment）是常用的沟通工具，用户可以在单元格上附加说明、备注或审核意见，而不影响原始数据。通过编程方式管理 Excel 批注，可以实现批量添加说明、自动标注数据异常、统一格式风格等操作。本文介绍如何使用 Python 借助 Spire.XLS for Python 库在 Excel 文件中添加、编辑、格式化和删除批注。

环境准备
使用 Spire.XLS for Python 操作 Excel 文件，安装命令：

2. pip install Spire.XLS

复制代码

安装完成后导入相关模块即可。

添加基础批注
最基础的批注操作是为指定单元格添加文本说明。通过访问单元格的 Comment 属性，直接设置批注内容：

2. from spire.xls import *
3. from spire.xls.common import *
5. workbook = Workbook()
6. sheet = workbook.Worksheets[0]
7. sheet.Range["A1"].Text = "产品A"
8. sheet.Range["A1"].Comment.Text = "该产品已停产，数据仅供参考"
9. sheet.Range["A1"].Comment.Visible = True
10. workbook.SaveToFile("BasicComment.xlsx", ExcelVersion.Version2013)
11. workbook.Dispose()

复制代码

Comment.Text 属性设置纯文本批注内容，Visible 控制批注是否默认可见（设为 False 时批注仍存在，鼠标悬停才显示）。

添加带作者信息的批注
多人协作时区分作者很有必要。使用 AddComment() 方法创建批注对象，手动拼接作者名和正文：

2. from spire.xls import *
3. from spire.xls.common import *
5. workbook = Workbook()
6. workbook.LoadFromFile("DataFile.xlsx")
7. sheet = workbook.Worksheets[0]
8. cell_range = sheet.Range["C1"]
9. comment = cell_range.AddComment()
10. comment.Width = 200
11. comment.Visible = True
12. author = "张经理"
13. text = "本季度数据已核实，可以发布。"
14. comment.Text = author + ":\n" + text
16. font = workbook.CreateFont()
17. font.FontName = "Tahoma"
18. font.KnownColor = ExcelColors.Black
19. font.IsBold = True
20. comment.RichText.SetFont(0, len(author), font)
22. workbook.SaveToFile("CommentWithAuthor.xlsx", ExcelVersion.Version2013)
23. workbook.Dispose()

复制代码

RichText.SetFont(0, len(author), font) 对作者名范围应用粗体，与正文明确区分。

创建富文本批注
批注中需要不同颜色或样式区分信息层级时，使用富文本格式：

2. from spire.xls import *
3. from spire.xls.common import *
5. workbook = Workbook()
6. sheet = workbook.Worksheets[0]
7. font_green = workbook.CreateFont()
8. font_green.FontName = "Arial"
9. font_green.Size = 11
10. font_green.KnownColor = ExcelColors.LightGreen
11. font_blue = workbook.CreateFont()
12. font_blue.FontName = "Arial"
13. font_blue.Size = 11
14. font_blue.KnownColor = ExcelColors.LightBlue
16. cell_range = sheet.Range["B12"]
17. cell_range.Text = "销售数据"
18. cell_range.RichText.SetFont(0, 16, font_green)
19. cell_range.Comment.RichText.Text = "已审核: 数据正常"
20. cell_range.Comment.RichText.SetFont(0, 4, font_green)
21. cell_range.Comment.RichText.SetFont(5, 9, font_blue)
23. workbook.SaveToFile("RichTextComment.xlsx", ExcelVersion.Version2013)
24. workbook.Dispose()

复制代码

RichText.SetFont(start_index, end_index, font) 对批注文本不同区段应用不同字体，适合区分状态标签与详细说明。

设置批注背景颜色
修改批注的填充属性，为批注框设置背景色：

2. from spire.xls import *
3. from spire.xls.common import *
5. workbook = Workbook()
6. sheet = workbook.Worksheets[0]
7. cell_range = sheet.Range["A1"]
8. cell_range.Comment.Text = "重要提示：此数据需要复核"
9. font = workbook.CreateFont()
10. font.FontName = "Arial"
11. font.Size = 11
12. font.KnownColor = ExcelColors.Orange
13. cell_range.Comment.RichText.SetFont(0, len(cell_range.Comment.Text) - 1, font)
14. cell_range.Comment.Fill.FillType = ShapeFillType.SolidColor
15. cell_range.Comment.Fill.ForeColor = Color.get_SkyBlue()
16. cell_range.Comment.Visible = True
18. workbook.SaveToFile("CommentFillColor.xlsx", ExcelVersion.Version2013)
19. workbook.Dispose()

复制代码

Fill.FillType 设为 ShapeFillType.SolidColor，通过 ForeColor 指定背景色，适合用颜色标记优先级或类别。

调整批注位置、大小与对齐方式
批注框位置、尺寸和文本对齐方式可直接控制：

2. from spire.xls import *
3. from spire.xls.common import *
5. workbook = Workbook()
6. sheet = workbook.Worksheets[0]
7. sheet.Range["G5"].Text = "数据项"
8. comment = sheet.Range["G5"].Comment
9. comment.IsVisible = True
10. comment.Height = 150
11. comment.Width = 300
12. comment.RichText.Text = "审核备注：\n此项数据来源于系统导出，已经过初步校验。"
13. comment.TextRotation = TextRotationType.LeftToRight
14. comment.Top = 20
15. comment.Left = 40
16. comment.VAlignment = CommentVAlignType.Center
17. comment.HAlignment = CommentHAlignType.Justified
19. workbook.SaveToFile("CommentPosition.xlsx", ExcelVersion.Version2013)
20. workbook.Dispose()

复制代码

关键属性说明：Height/Width 控制像素尺寸；Top/Left 控制相对工作表的位置坐标；VAlignment 可选 Top、Center、Bottom；HAlignment 可选 Left、Center、Right、Justified。

为批注添加图片背景
除了纯色，还可以用图片作为批注框背景（如公司 Logo 或状态图标）：

2. from spire.xls import *
3. from spire.xls.common import *
5. workbook = Workbook()
6. sheet = workbook.Worksheets[0]
7. sheet.Range["C6"].Text = "负责人"
8. comment = sheet.Range["C6"].AddComment()
9. image = Stream("Logo.png")
10. comment.Fill.CustomPicture(image, "logo.png")
11. comment.Visible = True
13. workbook.SaveToFile("CommentWithImage.xlsx", ExcelVersion.Version2013)
14. workbook.Dispose()

复制代码

Fill.CustomPicture() 接受图片流和图片名称，加载的图片作为批注框背景填充。

读取和编辑已有批注
对于已有 Excel 文件，遍历批注集合读取或修改：

2. from spire.xls import *
4. workbook = Workbook()
5. workbook.LoadFromFile("ExistingFile.xlsx")
6. sheet = workbook.Worksheets[0]
7. comment_text = sheet.Range["A1"].Comment.Text
8. print("批注内容:", comment_text)
9. rtf_text = sheet.Range["A2"].Comment.RichText.RtfText
10. print("RTF 内容:", rtf_text)
11. workbook.Dispose()

复制代码

编辑已有批注：通过 Comments 索引集合访问并修改属性：

2. comment = sheet.Comments[0]
3. comment.Text = "批注内容已更新"

复制代码

控制批注显示和隐藏
单独控制可见性，无需删除即可隐藏或重新显示：

2. from spire.xls import *
4. workbook = Workbook()
5. workbook.LoadFromFile("CommentFile.xlsx")
6. sheet = workbook.Worksheets[0]
7. sheet.Comments[1].IsVisible = False
8. sheet.Comments[2].IsVisible = True
9. workbook.SaveToFile("CommentVisibility.xlsx", ExcelVersion.Version2013)
10. workbook.Dispose()

复制代码

适合在打印或演示时隐藏审核批注。

删除批注
当批注不再需要时，彻底移除：

2. from spire.xls import *
4. workbook = Workbook()
5. workbook.LoadFromFile("CommentFile.xlsx")
6. sheet = workbook.Worksheets[0]
7. sheet.Comments[1].Remove()
8. workbook.SaveToFile("CommentRemoved.xlsx", ExcelVersion.Version2013)
9. workbook.Dispose()

复制代码

遍历 sheet.Comments 并逐一调用 Remove() 可清除所有批注。

总结
本文介绍了使用 Python 管理 Excel 批注的常用操作，包括：添加基础文本批注和带作者信息的批注；使用富文本设置不同颜色和样式的批注内容；设置批注背景颜色和图片背景；调整批注位置、大小和文本对齐方式；读取、编辑、隐藏和删除已有批注。这些操作覆盖了批注管理的主要场景。在此基础上，可进一步结合数据校验逻辑自动添加批注，或批量处理多个 Excel 文件中的批注内容，构建完善的自动化工作流。

热心网友1

感谢楼主的分享！这些代码示例非常实用，尤其是用 RichText 区分作者名和正文、设置不同颜色背景，这在实际协作中能省不少手动调整的时间。我之前用 openpyxl 做批注时，富文本控制没这么灵活，Spire.XLS 提供的 RichText.SetFont 直接指定 start/end index 确实方便。 想请教一下楼主：文中提到了“删除批注”，但没给出具体示例。如果我想批量清除某个区域的所有批注，Spire 是否有类似 `cell.Comment.Remove()` 的方法？或者需要遍历单元格逐个处理？另外，添加多个批注时，是否会导致文件体积显著增大？再次感谢分享！

热心网友1

很实用的教程！Spire.XLS 这个库我之前在批量生成报表时也用过，批注这块确实能大幅提升团队协作效率。请问楼主，对于已经存在批注的单元格，如果要判断是否已有批注再决定是否覆盖，有没有推荐的判断方法？另外，批量删除多个指定区域的批注时，是否需要循环遍历每个单元格，还是 Spire.XLS 有更高效的接口？

热心网友1

感谢分享！最近正好在处理团队协作的 Excel 文件，批注管理是个痛点。你的代码讲解很清晰，尤其是用 `RichText.SetFont` 分片设置样式那段，正好解决了我区分不同作者意见的需求。另外富文本批注里的颜色区分也很有参考价值。 不过看标题还包含了“删除”操作，示例里好像没展示出来？能否补充一下用 Spire.XLS 删除指定单元格批注或清除所有批注的代码？对自动化清理旧批注很有帮助。谢谢！