写入Pandas DataFrame至XLSM文件报错：workbook无add_vba_project属性

1. 确认依赖库版本与正确导入 #

• 确保安装支持VBA操作的openpyxl版本（需2.4.0及以上，建议用最新稳定版），执行升级命令：

  pip install --upgrade openpyxl pandas
  

• 代码中必须明确使用openpyxl作为引擎，且操作的是openpyxl原生Workbook对象，而非Pandas封装后的对象。

2. 正确提取VbaProject.bin文件 #

从正常可打开的XLSM模板文件中提取：

• 将XLSM文件后缀改为.zip，解压后找到xl/vbaProject.bin文件
• 将该文件保存到本地项目目录中

3. 修正写入XLSM的代码逻辑 #

方案一：基于带宏模板写入数据（推荐） #

直接加载已有宏的XLSM模板，写入数据后保留宏：

import pandas as pd
from openpyxl import load_workbook

# 加载带宏的XLSM模板
wb = load_workbook("your_template.xlsm", keep_vba=True)
ws = wb["Sheet1"]  # 指定要写入的工作表

# 将DataFrame写入工作表
df = pd.DataFrame({"col1": [1,2,3], "col2": ["a","b","c"]})
for row_idx, row in enumerate(df.itertuples(index=False), start=2):  # 从第2行开始，跳过表头
    for col_idx, val in enumerate(row, start=1):
        ws.cell(row=row_idx, column=col_idx, value=val)

# 保存时必须保留VBA
wb.save("output_with_macro.xlsm")

方案二：新建文件后添加宏 #

若需从零创建文件再插入宏，确保操作openpyxl原生Workbook：

import pandas as pd
from openpyxl import Workbook

# 创建支持VBA的Workbook
wb = Workbook()
wb.vba_archive = True

# 将DataFrame写入工作表
df = pd.DataFrame({"col1": [1,2,3], "col2": ["a","b","c"]})
with pd.ExcelWriter("temp.xlsx", engine="openpyxl") as writer:
    writer.book = wb
    df.to_excel(writer, sheet_name="Sheet1", index=False)

# 插入提取的VBA项目文件
wb.add_vba_project("vbaProject.bin")

# 保存为XLSM格式
wb.save("final_output.xlsm")

4. 排查常见错误点 #

• 不要用pd.ExcelWriter直接创建XLSM后尝试添加宏，Pandas封装的writer.book并非完整的openpyxl Workbook对象
• 确保vbaProject.bin来自同版本Excel生成的XLSM文件，避免版本不兼容
• 检查是否误使用xlsxwriter引擎，该引擎不支持VBA操作

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