使用XlsxWriter创建Excel表格时，结构化引用公式导致文件需修复且公式失效的问题求助

阿华AIGC实验室

2026-4-14

XlsxWriter创建Excel表格时，结构化引用公式导致文件需修复且公式失效的问题求助

Hey there! I’ve faced this exact issue with XlsxWriter and Excel structured references before—let’s get it sorted out for you.

问题根源

XlsxWriter自带的公式解析器并不支持Excel的结构化引用语法（比如orderTable[@[SOH]]这种格式）。当你直接写入这类公式时，解析器会错误地处理它们，导致生成的Excel文件包含无效公式，触发修复提示并清空公式内容。

解决方案1：创建表格时直接定义列公式（推荐）

最简洁的方法是在创建表格的同时，为Total列指定公式。这样XlsxWriter会自动将公式嵌入表格定义中，Excel能完美识别结构化引用，而且不需要单独循环写入公式。

修改后的代码如下：

import xlsxwriter

workbook = xlsxwriter.Workbook('example.xlsx')
worksheet = workbook.add_worksheet()

data = [
    ['SOH', 'SOO', 'Actual Order', 'Total'],  # Headers
    [10, 5, 3, None],
    [20, 10, 7, None],
    [15, 8, 6, None]
]

for row, row_data in enumerate(data):
    worksheet.write_row(row, 0, row_data)

# 创建表格时直接为Total列设置公式
worksheet.add_table('A1:D4', {
    'name': 'orderTable',
    'columns': [
        {'header': 'SOH'},
        {'header': 'SOO'},
        {'header': 'Actual Order'},
        # 这里的公式会自动应用到表格的每一行，Excel会自动处理@行上下文
        {'header': 'Total', 'formula': '[SOH] + [SOO] + [Actual Order]'}
    ]
})

workbook.close()

解决方案2：使用原始公式写入（适合需动态生成公式的场景）

如果你确实需要在创建表格后单独写入公式，可以通过raw_formula选项绕过XlsxWriter的公式解析器，直接将公式原封不动写入Excel文件。

只需修改你写入公式的那一行代码：

for row in range(1, 4):
    formula = '=orderTable[@[SOH]] + orderTable[@[SOO]] + orderTable[@[Actual Order]]'
    # 添加options参数，让XlsxWriter直接写入原始公式
    worksheet.write_formula(row, 3, formula, options={'raw_formula': True})