使用openpyxl插入Excel IMAGE函数时自动添加@符号的问题求助

问题背景 #

使用openpyxl向Excel单元格插入=IMAGE(AC2)公式时遇到异常：手动输入公式可正常加载图片，但代码插入时出现问题。已知openpyxl 3.1.2的内置函数列表不包含IMAGE：

>>> from openpyxl.utils import FORMULAE
>>> "IMAGE" in FORMULAE
False

尝试的三种脚本及对应结果：

• 脚本1

  for row in range(2, worksheet.max_row + 1):
      imgUrl_cell_reference = f"{get_column_letter(imgUrl_column_index)}{row}"
      formula = f'=IMAGE({imgUrl_cell_reference})'
      worksheet.cell(row=row, column=post_overview_column_index).value = formula
  

  结果：C2单元格显示=@IMAGE(AC2)

• 脚本2

  for row in range(2, worksheet.max_row + 1):
      imgUrl_cell_reference = f"{get_column_letter(imgUrl_column_index)}{row}"
      formula = '=_xlfn.IMAGE({imgUrl_cell_reference})'
      worksheet.cell(row=row, column=post_overview_column_index).value = formula
  

  结果：打开Excel文件时弹出错误提示

• 脚本3

  for row in range(2, worksheet.max_row + 1):
      imgUrl_cell_reference = f"{get_column_letter(imgUrl_column_index)}{row}"
      formula = '=_xludf.IMAGE({imgUrl_cell_reference})'
      worksheet.cell(row=row, column=post_overview_column_index).value = formula
  

  结果：打开Excel文件时弹出错误提示

环境：Python 3.11、openpyxl 3.1.2、Microsoft 365最新版Excel

解决方案 #

原因分析 #

1. IMAGE是Excel 365新增的内置函数，openpyxl 3.1.2未将其纳入内置函数列表，需用_xlfn.前缀标记这是Excel的新内置函数。
2. 脚本1出现@是因为openpyxl将未识别的函数判定为用户定义函数，自动添加隐式交集运算符@，导致Excel解析异常。
3. 脚本2的错误在于字符串格式化未使用f-string替换变量，且未明确指定单元格数据类型为公式；脚本3误用了用户定义函数的前缀_xludf.，IMAGE属于内置函数，不应使用该前缀。

正确代码示例 #

from openpyxl.utils import get_column_letter

for row in range(2, worksheet.max_row + 1):
    imgUrl_cell_reference = f"{get_column_letter(imgUrl_column_index)}{row}"
    # 用_xlfn前缀标识Excel新内置函数，正确格式化公式字符串
    formula = f'=_xlfn.IMAGE({imgUrl_cell_reference})'
    cell = worksheet.cell(row=row, column=post_overview_column_index)
    cell.value = formula
    # 明确指定单元格数据类型为公式，避免被当作普通文本处理
    cell.data_type = "f"

验证说明 #

保存文件后打开Excel，公式会自动解析为=IMAGE(AC2)并正常加载图片。若仍有异常，可尝试关闭并重新打开Excel，确保文件未处于只读模式。

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