如何用OpenPyXL通过行列号为Excel单元格添加批注？

需求场景：打开启用宏的Excel模板（.xltm），将包含字符串和字典类型数据的pandas DataFrame写入指定位置，最终保存为启用宏的工作簿（.xlsm）。其中字典类型的单元格需要提取status作为单元格值，若存在comment则为单元格添加批注。

用户原代码（批注添加失败）：

import openpyxl
from openpyxl.utils.dataframe import dataframe_to_rows

wb = openpyxl.load_workbook(stemplatepath, keep_vba=True)
ws = wb['Health']
rows = dataframe_to_rows(dflower, index=False, header=False)
for r_idx, row in enumerate(rows, 1):
    for c_idx, value in enumerate(row, 1):
        if isinstance(value, dict):
            ws.cell(row=r_idx+10, column=c_idx, value=value['status'])
            if value['comment']:
                ws.cell(row=r_idx+10, column=c_idx).comment = value['comment'] # 该行代码无法运行
        else:
            ws.cell(row=r_idx+10, column=c_idx, value=value)
wb.template = False
wb.save(soutputpath)

问题原因：OpenPyXL的单元格批注不能直接赋值字符串，必须创建Comment类实例后，再绑定到单元格的comment属性上。

解决方案 #

1. 导入Comment类（来自openpyxl.comments模块）
2. 在循环中，针对需要添加批注的单元格，创建Comment实例（传入批注文本和作者信息），再赋值给目标单元格的comment属性

修改后的完整代码：

import openpyxl
from openpyxl.utils.dataframe import dataframe_to_rows
from openpyxl.comments import Comment  # 导入Comment类

wb = openpyxl.load_workbook(stemplatepath, keep_vba=True)
ws = wb['Health']
rows = dataframe_to_rows(dflower, index=False, header=False)

# 自定义批注作者，可按需修改
COMMENT_AUTHOR = "DataImporter"

for r_idx, row in enumerate(rows, 1):
    for c_idx, value in enumerate(row, 1):
        target_row = r_idx + 10
        target_col = c_idx
        cell = ws.cell(row=target_row, column=target_col)
        
        if isinstance(value, dict):
            cell.value = value['status']
            # 安全判断comment是否存在且非空
            if value.get('comment'):
                cell.comment = Comment(value['comment'], COMMENT_AUTHOR)
        else:
            cell.value = value

wb.template = False
wb.save(soutputpath)

说明：

• 通过ws.cell(row=行号, column=列号)获取单元格对象后，直接操作其value和comment属性，避免重复调用ws.cell
• 使用value.get('comment')可避免字典中无comment键时触发KeyError
• 批注作者可根据实际场景自定义

内容的提问来源于stack exchange，提问作者Kes Perron