在多人协作处理 Excel 数据时批注是常用的标记方式但手工添加、编辑和清理批注往往会出现以下痛点：

• 批注数量激增后手动定位和删除非常费时。
• 不同协作者的批注格式不统一，导致审阅时难以快速辨识作者。
• 批注隐藏后容易被遗漏，影响数据完整性检查。怎么说呢，
• 缺乏统一的样式控制。使得关键意见难以突出显示。怎么说呢，

通过 Python 自动化操作 Excel 批注。可以一次性解决上述问题，实现精准定位、统一样式、批量增删，从而明显提高审核效率和文档管理规范性。话说回来，

环境准备

这篇文章采用 Spire.XLS for Python 库来操作 Excel 文件。按理说，该库提供了 CellRange.Comment 属性和 Comments 集合。可便捷地读写单元格级别的批注。

pip install Spire.XLS

安装完成后在脚本中导入必要模块：

from spire.xls import *
from spire.xls.common import *

添加带作者信息的批注

需要在批注前标记作者，以便快速分辨不同人的反馈。Excel 默认将“作者名 + 冒号 + 换行 + 正文”的格式识别为作者并加粗显示。下面示例演示如何在单元格 C1 添加带作者信息且可编辑的批注，并自定义作者字体样式。

from spire.xls import *
from spire.xls.common import *
input_file = "/示例.xlsx"
output_file = "/AddCommentWithAuthor.xlsx"
# 创建 Workbook 并加载文件
workbook = Workbook
workbook.LoadFromFile
# 获取第一个工作表
sheet = workbook.Worksheets
# 定位目标单元格
cell = sheet.Range
author = "E-iceblue"
text = "这是一个演示如何添加带有可编辑作者属性的批注示例。"
# 添加批注
comment = cell.AddComment
comment.Width = 200
comment.Visible = True
comment.Text = f"{author}:
{text}"
# 为作者名设置粗体字体
font = workbook.CreateFont
font.FontName = "Tahoma"
font.KnownColor = ExcelColors.Black
font.IsBold = True
# 起始索引 0。结束索引为作者长度
comment.RichText.SetFont,font)
# 保存文件
workbook.SaveToFile
workbook.Dispose

添加富文本批注

当需要在同一条批注中突出关键字或区分不同信息时可使用富文本为字符区间分别设定颜色、大小等样式。以下代码展示了如何在 B12 单元格创建包含多色文字的批注。

from spire.xls import *
from spire.xls.common import *
input_file = "示例.xlsx"
output_file = "RichTextComment.xlsx"
workbook = Workbook
workbook.LoadFromFile
sheet = workbook.Worksheets
# 创建三种颜色的字体对象
font_orange = workbook.CreateFont
font_orange.FontName = "Arial"
font_orange.Size = 10
font_orange.KnownColor = ExcelColors.Orange
font_blue = workbook.CreateFont
font_blue.KnownColor = ExcelColors.LightBlue
font_green = workbook.CreateFont
font_green.KnownColor = ExcelColors.LightGreen
# 在 B12 添加富文本批注
cell = sheet.Range
cell.Text = "富文本批注示例"
cell.Comment.RichText.Text = "Rich text comment"
# 将前 5 个字符设为绿色
cell.Comment.RichText.SetFont
# 将第 6 到第 11 个字符设为蓝色
cell.Comment.RichText.SetFont
workbook.SaveToFile
workbook.Dispose

设置批注外观

除了内容本身。还可以自定义批注框的背景色、边框还有默认可见性，以便在审核阶段突出主要信息。

from spire.xls import *
from spire.xls.common import *
input_file = "示例.xlsx"
output_file = "/SetCommentFillColor.xlsx"
workbook = Workbook
workbook.LoadFromFile
sheet = workbook.Worksheets
# 创建用于高亮作者名的字体
highlight_font = workbook.CreateFont
highlight_font.FontName = "Arial"
highlight_font.Size = 10
highlight_font.KnownColor= ExcelColors.Orange
highlight_font.IsBold = True
# 在 A1 添加普通批注并加粗全部文字
cell = sheet.Range
cell.Comment.Text ="这是一个批注"
cell.Comment.RichText.SetFont,highlight_font)
# 设置填充颜色为天蓝色
cell.Comment.Fill.FillType = ShapeFillType.SolidColor
cell.Comment.Fill.ForeColor = Color.get_SkyBlue
# 默认显示该关键批注
cell.Comment.Visible = True
workbook.SaveToFile
workbook.Dispose

编辑和删除批注

审阅过程中经常需要修改已存在的意见或清理已完成的标记。不过，Spire.XLS 提供了统一访问 Worksheet.Comments 集合的方法。可一次遍历全部批注进行更新或删除。话说回来，

修改指定批注内容

from spire.xls import *
from spire.xls.common import *
input_file ="./Data/CommentSample.xlsx"
output_file ="EditAndRemoveComment.xlsx"
wb = Workbook
wb.LoadFromFile
sheet = wb.Worksheets
comments= sheet.Comments
# 更新第一条评论文本
comments.Text ="该批注内容已被更新。"
wb.SaveToFile
wb.Dispose

删除单条或多条评论

# 删除第二条评论
comments.Remove
# 批量删除时建议倒序遍历，以避免索引错位：
for i in range-1,-1。-1):
if should_remove: # 自定义过滤条件函数
comments.Remove

直接定位单元格删除其评论

sheet.Range.Comment.Remove # 无需遍历集合，仅针对 D5 单元格操作

实用方法

读取所有批注内容并导出

在审计或数据抽取阶段，经常需要将工作表中的所有备注导出为文本报告。

sheet = wb.Worksheets
with open as f:
for idx,comment in enumerate:
f.write

动态控制显示/隐藏状态

大量隐藏式评论会占用内存且影响打开速度；关键评论则应保持可见，

# 隐藏除第0条外全部评论：
for i in range):
sheet.Comments.IsVisible=False
# 临时显示第5条进行复核：
sheet.Comments.IsVisible=True

封装通用“添加带格式评论”函数，实现一次性对多个单元格进行统一标记

def add_comment:
cell= = = "{author}:
{text}"
comment.Width= if :
comment.Fill.FillType= = return