为什么使用xlsxwriter替换Excel占位符时Pandas dataframe未更新

1. DataFrame未更新的核心原因 #

你当前的代码仅将替换后的值写入了xlsxwriter的工作表对象，全程没有修改原DataFrame的内容：你从df中读取单元格值存入临时变量cell_value，对临时变量做替换后只调用了worksheet.write()写入Excel，没有将替换后的值赋值回df的对应位置，所以df本身不会发生变化。
如果需要同步更新df，在替换逻辑结束后添加赋值语句即可：

if isinstance(cell_value, str):
    # 写入Excel
    worksheet.write(row.Index, col_num, cell_value)
    # 同步更新DataFrame
    df.iloc[row.Index, col_num] = cell_value

2. 若输出的Excel文件也未更新的排查点 #

如果你的问题是最终生成的Excel文件也没有替换成功，大概率是writer的使用顺序错误：

• 需保证先调用df.to_excel(writer, sheet_name=sheet_name)将原df写入writer对象，再获取writer.sheets[sheet_name]做单元格修改
• 最终需调用writer.save()完成文件写入，不要直接调用workbook.close()，避免缓存内容未写入文件

3. 更简洁的批量替换方案 #

不需要逐行逐单元格遍历，Pandas支持批量正则替换，几行代码就能完成需求，性能也远高于手动遍历：

# 构建替换规则：键是匹配{{变量名}}的正则，值是替换内容
replace_rules = {rf'{{{{var_name}}}}': replace_val for var_name, replace_val in variables.items()}
# 批量替换整个DataFrame的所有单元格
df = df.replace(replace_rules, regex=True)
# 替换完成后直接写入Excel即可
with pd.ExcelWriter('输出文件路径.xlsx', engine='xlsxwriter') as writer:
    df.to_excel(writer, sheet_name=sheet_name, index=False)

额外的代码优化建议 #

• 字符串类型判断用isinstance(cell_value, str)代替type(cell_value) == str，兼容性更好
• 你当前的if str(replacement):判断会把数字0、布尔值False这类合法值判定为无效，如果你的替换值允许这类内容，建议修改为if replacement is not None:更合理

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