在团队协作处理 Excel 数据时，批注（Comment）是一种常用的沟通方式。它允许用户在单元格上附加说明、备注或审核意见，而不影响原始数据内容。通过编程方式管理 Excel 批注，可以实现批量添加说明、自动标注数据异常、统一格式风格等操作。本文将介绍如何使用 Python 在 Excel 文件中添加、编辑、格式化和删除批注。
环境准备
本文使用 Spire.XLS for Python 来操作 Excel 文件。通过以下命令安装：
bash
pip install Spire.XLS安装完成后，导入相关模块即可开始操作。
添加基础批注
最基础的批注操作是为指定单元格添加一段文本说明。通过访问单元格的 Comment 属性，可以直接设置批注内容。
python
from spire.xls import *
from spire.xls.common import *
workbook = Workbook()
sheet = workbook.Worksheets[0]
# 设置单元格文本
sheet.Range["A1"].Text = "产品A"
# 添加批注
sheet.Range["A1"].Comment.Text = "该产品已停产，数据仅供参考"
# 设置批注可见
sheet.Range["A1"].Comment.Visible = True
workbook.SaveToFile("BasicComment.xlsx", ExcelVersion.Version2013)
workbook.Dispose()Comment.Text 属性用于设置纯文本批注内容，Visible 属性控制批注是否默认可见。当 Visible 设为 False 时，批注仍然存在，但只有鼠标悬停在单元格上时才会显示。
添加带作者信息的批注
在多人协作场景中，区分批注的作者很有必要。可以通过 AddComment() 方法创建批注对象，然后手动拼接作者名和正文内容。
python
from spire.xls import *
from spire.xls.common import *
workbook = Workbook()
workbook.LoadFromFile("DataFile.xlsx")
sheet = workbook.Worksheets[0]
# 获取目标单元格
cell_range = sheet.Range["C1"]
# 添加批注并设置属性
comment = cell_range.AddComment()
comment.Width = 200
comment.Visible = True
# 拼接作者和正文
author = "张经理"
text = "本季度数据已核实，可以发布。"
comment.Text = author + ":\n" + text
# 对作者名加粗
font = workbook.CreateFont()
font.FontName = "Tahoma"
font.KnownColor = ExcelColors.Black
font.IsBold = True
comment.RichText.SetFont(0, len(author), font)
workbook.SaveToFile("CommentWithAuthor.xlsx", ExcelVersion.Version2013)
workbook.Dispose()这里使用了 RichText.SetFont() 方法来对批注中指定范围的文本应用字体格式。参数 0 和 len(author) 表示从第 0 个字符到作者名末尾的范围，这样作者名会以粗体显示，与正文明确区分。
创建富文本批注
当批注中需要不同颜色或样式来区分信息层级时，可以使用富文本（RichText）格式。
python
from spire.xls import *
from spire.xls.common import *
workbook = Workbook()
sheet = workbook.Worksheets[0]
# 创建不同颜色的字体
font_green = workbook.CreateFont()
font_green.FontName = "Arial"
font_green.Size = 11
font_green.KnownColor = ExcelColors.LightGreen
font_blue = workbook.CreateFont()
font_blue.FontName = "Arial"
font_blue.Size = 11
font_blue.KnownColor = ExcelColors.LightBlue
# 设置单元格和批注
cell_range = sheet.Range["B12"]
cell_range.Text = "销售数据"
cell_range.RichText.SetFont(0, 16, font_green)
# 设置富文本批注
cell_range.Comment.RichText.Text = "已审核: 数据正常"
cell_range.Comment.RichText.SetFont(0, 4, font_green)
cell_range.Comment.RichText.SetFont(5, 9, font_blue)
workbook.SaveToFile("RichTextComment.xlsx", ExcelVersion.Version2013)
workbook.Dispose()RichText.SetFont(start_index, end_index, font) 方法允许对批注文本的不同区段应用不同字体。这在需要区分状态标签和详细说明时很实用。
设置批注的背景颜色
通过修改批注的填充属性，可以为批注框设置背景颜色，使其更加醒目。
python
from spire.xls import *
from spire.xls.common import *
workbook = Workbook()
sheet = workbook.Worksheets[0]
# 添加批注
cell_range = sheet.Range["A1"]
cell_range.Comment.Text = "重要提示：此数据需要复核"
# 设置字体颜色
font = workbook.CreateFont()
font.FontName = "Arial"
font.Size = 11
font.KnownColor = ExcelColors.Orange
cell_range.Comment.RichText.SetFont(0, len(cell_range.Comment.Text) - 1, font)
# 设置批注背景色
cell_range.Comment.Fill.FillType = ShapeFillType.SolidColor
cell_range.Comment.Fill.ForeColor = Color.get_SkyBlue()
cell_range.Comment.Visible = True
workbook.SaveToFile("CommentFillColor.xlsx", ExcelVersion.Version2013)
workbook.Dispose()Fill.FillType 设为 ShapeFillType.SolidColor 后，通过 ForeColor 指定背景色。这种方式适合用颜色来标记批注的优先级或类别。
调整批注的位置、大小和对齐方式
批注框的位置和尺寸可以通过属性直接控制，文本对齐方式也可以单独设置。
python
from spire.xls import *
from spire.xls.common import *
workbook = Workbook()
sheet = workbook.Worksheets[0]
# 添加批注
sheet.Range["G5"].Text = "数据项"
comment = sheet.Range["G5"].Comment
comment.IsVisible = True
comment.Height = 150
comment.Width = 300
# 设置批注文本
comment.RichText.Text = "审核备注：\n此项数据来源于系统导出，已经过初步校验。"
# 设置文本旋转方向
comment.TextRotation = TextRotationType.LeftToRight
# 设置批注位置（相对于工作表）
comment.Top = 20
comment.Left = 40
# 设置文本对齐方式
comment.VAlignment = CommentVAlignType.Center
comment.HAlignment = CommentHAlignType.Justified
workbook.SaveToFile("CommentPosition.xlsx", ExcelVersion.Version2013)
workbook.Dispose()关键属性说明：
Height和Width：控制批注框的像素尺寸Top和Left：控制批注框在工作表中的位置坐标VAlignment：垂直对齐方式，可选Top、Center、BottomHAlignment：水平对齐方式，可选Left、Center、Right、Justified
为批注添加图片背景
除了纯色背景，还可以使用图片作为批注框的背景，例如嵌入公司 Logo 或状态图标。
python
from spire.xls import *
from spire.xls.common import *
workbook = Workbook()
sheet = workbook.Worksheets[0]
sheet.Range["C6"].Text = "负责人"
# 添加批注并设置图片背景
comment = sheet.Range["C6"].AddComment()
image = Stream("Logo.png")
comment.Fill.CustomPicture(image, "logo.png")
comment.Visible = True
workbook.SaveToFile("CommentWithImage.xlsx", ExcelVersion.Version2013)
workbook.Dispose()Fill.CustomPicture() 方法接受一个图片流和图片名称参数。加载的图片会作为批注框的背景填充。
读取和编辑已有批注
对于已有的 Excel 文件，可以遍历工作表中的批注集合来读取或修改批注内容。
python
from spire.xls import *
workbook = Workbook()
workbook.LoadFromFile("ExistingFile.xlsx")
sheet = workbook.Worksheets[0]
# 读取指定单元格的批注
comment_text = sheet.Range["A1"].Comment.Text
print("批注内容:", comment_text)
# 读取富文本批注的 RTF 格式
rtf_text = sheet.Range["A2"].Comment.RichText.RtfText
print("RTF 内容:", rtf_text)
workbook.Dispose()编辑已有批注同样简单，直接通过索引访问批注集合并修改属性：
python
# 获取第一个批注并修改内容
comment = sheet.Comments[0]
comment.Text = "批注内容已更新"控制批注的显示和隐藏
批注可以单独控制可见性，无需删除即可隐藏或重新显示。
python
from spire.xls import *
workbook = Workbook()
workbook.LoadFromFile("CommentFile.xlsx")
sheet = workbook.Worksheets[0]
# 隐藏指定批注
sheet.Comments[1].IsVisible = False
# 显示指定批注
sheet.Comments[2].IsVisible = True
workbook.SaveToFile("CommentVisibility.xlsx", ExcelVersion.Version2013)
workbook.Dispose()这在需要根据不同场景切换批注显示状态时很有用，例如在打印或演示时隐藏审核批注。
删除批注
当批注不再需要时，可以将其从工作表中移除。
python
from spire.xls import *
workbook = Workbook()
workbook.LoadFromFile("CommentFile.xlsx")
sheet = workbook.Worksheets[0]
# 删除第二个批注
sheet.Comments[1].Remove()
workbook.SaveToFile("CommentRemoved.xlsx", ExcelVersion.Version2013)
workbook.Dispose()Remove() 方法会将批注从工作表的批注集合中彻底删除。如果需要清除所有批注，可以遍历 sheet.Comments 集合并逐一调用 Remove()。
总结
本文介绍了使用 Python 管理 Excel 批注的常用操作，包括：
- 添加基础文本批注和带作者信息的批注
- 使用富文本格式设置不同颜色和样式的批注内容
- 设置批注背景颜色和图片背景
- 调整批注的位置、大小和文本对齐方式
- 读取、编辑、隐藏和删除已有批注
这些操作覆盖了批注管理的主要场景。在此基础上，可以进一步结合数据校验逻辑自动添加批注，或批量处理多个 Excel 文件中的批注内容，构建更完善的自动化工作流。