公式中引用tblTest表格导致Excel文件无法正常打开

使用openpyxl给Excel单元格设置包含表格（tblTest）引用的公式后，生成的test.xlsx打开时提示文件损坏需要恢复；若仅设置=tblTest，文件可打开但单元格显示#NAME?，点击单元格回车后才正常生效。

代码示例 #

import openpyxl

wb = openpyxl.load_workbook("Planung.xlsx")
ws = wb["Zeitplan"]
ws["B6"].value = '=INDEX(FILTER(tblTest,tblTest[Packet]="A"),1)'

wb.save("test.xlsx")

重现步骤 #

• 创建Planung.xlsx文件
• 创建名为Zeitplan的工作表
• 创建第二个工作表，并在其中创建名为tblTest的表格，包含Packet列
• 运行上述代码
• 打开test.xlsx时出现错误提示

1. 修复文件损坏：使用Formula对象包装公式 #

openpyxl直接赋值公式字符串时，无法正确处理表格的结构化引用语法，改用openpyxl.formula.Formula对象封装公式，能让Excel按规范解析：

import openpyxl
from openpyxl.formula import Formula

wb = openpyxl.load_workbook("Planung.xlsx")
ws = wb["Zeitplan"]
# 用Formula对象包装公式
ws["B6"].value = Formula('=INDEX(FILTER(tblTest,tblTest[Packet]="A"),1)')

wb.save("test.xlsx")

2. 解决#NAME?错误：显式指定表格所在工作表 #

当表格不在当前操作的工作表时，需在引用中明确添加工作表名称（假设tblTest在名为Data的工作表中）：

ws["B6"].value = Formula('=INDEX(FILTER(Data!tblTest,Data!tblTest[Packet]="A"),1)')

3. 基础验证：确认表格定义合规 #

确保原文件中的tblTest是通过Ctrl+T创建的正式Excel表格（而非普通单元格区域），且Packet列确实属于该表格。

Excel的表格结构化引用有特定内部存储格式，直接赋值字符串公式时，openpyxl无法将公式与表格的内部ID关联，导致Excel无法识别；使用Formula对象能让openpyxl按Excel规范处理公式存储，显式指定工作表名称则消除了引用歧义，让Excel直接定位目标表格。

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