如何运用 Python 添加和管理 Excel 批注（完整示例）

作者：袖梨 2026-06-27

img_6a3f17dd4d0bb30.webp

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

环境准备

本文使用 Spire.XLS for Python 来操作 Excel 文件。通过以下命令安装：

 复制代码pip install Spire.XLS

安装完成后，导入相关模块即可开始操作。

添加基础批注

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

 复制代码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 = Trueworkbook.SaveToFile("BasicComment.xlsx", ExcelVersion.Version2013)
workbook.Dispose()

Comment.Text 属性用于设置纯文本批注内容，Visible 属性控制批注是否默认可见。当 Visible 设为 False 时，批注仍然存在，但只有鼠标悬停在单元格上时才会显示。

添加带作者信息的批注

在多人协作场景中，区分批注的作者很有必要。可以通过 AddComment() 方法创建批注对象，然后手动拼接作者名和正文内容。

 复制代码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）格式。

 复制代码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.LightGreenfont_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) 方法允许对批注文本的不同区段应用不同字体。这在需要区分状态标签和详细说明时很实用。

设置批注的背景颜色

通过修改批注的填充属性，可以为批注框设置背景颜色，使其更加醒目。

 复制代码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 = Trueworkbook.SaveToFile("CommentFillColor.xlsx", ExcelVersion.Version2013)
workbook.Dispose()

Fill.FillType 设为 ShapeFillType.SolidColor 后，通过 ForeColor 指定背景色。这种方式适合用颜色来标记批注的优先级或类别。

调整批注的位置、大小和对齐方式

批注框的位置和尺寸可以通过属性直接控制，文本对齐方式也可以单独设置。

 复制代码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.Justifiedworkbook.SaveToFile("CommentPosition.xlsx", ExcelVersion.Version2013)
workbook.Dispose()

关键属性说明：

  • Height 和 Width：控制批注框的像素尺寸
  • Top 和 Left：控制批注框在工作表中的位置坐标
  • VAlignment：垂直对齐方式，可选 Top、Center、Bottom
  • HAlignment：水平对齐方式，可选 Left、Center、Right、Justified

为批注添加图片背景

除了纯色背景，还可以使用图片作为批注框的背景，例如嵌入公司 Logo 或状态图标。

 复制代码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 = Trueworkbook.SaveToFile("CommentWithImage.xlsx", ExcelVersion.Version2013)
workbook.Dispose()

Fill.CustomPicture() 方法接受一个图片流和图片名称参数。加载的图片会作为批注框的背景填充。

读取和编辑已有批注

对于已有的 Excel 文件，可以遍历工作表中的批注集合来读取或修改批注内容。

 复制代码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()

编辑已有批注同样简单，直接通过索引访问批注集合并修改属性：

 复制代码# 获取第一个批注并修改内容
comment = sheet.Comments[0]
comment.Text = "批注内容已更新"

控制批注的显示和隐藏

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

 复制代码from spire.xls import *workbook = Workbook()
workbook.LoadFromFile("CommentFile.xlsx")
sheet = workbook.Worksheets[0]# 隐藏指定批注
sheet.Comments[1].IsVisible = False# 显示指定批注
sheet.Comments[2].IsVisible = Trueworkbook.SaveToFile("CommentVisibility.xlsx", ExcelVersion.Version2013)
workbook.Dispose()

这在需要根据不同场景切换批注显示状态时很有用，例如在打印或演示时隐藏审核批注。

删除批注

当批注不再需要时，可以将其从工作表中移除。

 复制代码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 批注的常用操作，包括：

  1. 添加基础文本批注和带作者信息的批注
  2. 使用富文本格式设置不同颜色和样式的批注内容
  3. 设置批注背景颜色和图片背景
  4. 调整批注的位置、大小和文本对齐方式
  5. 读取、编辑、隐藏和删除已有批注

这些操作覆盖了批注管理的主要场景。在此基础上，可以进一步结合数据校验逻辑自动添加批注，或批量处理多个 Excel 文件中的批注内容，构建更完善的自动化工作流。

相关文章

精彩推荐