使用Pandas与XlsxWriter生成Excel报表时文件为空的问题求助

核心问题分析 #

你遇到的空文件问题，并非return writer操作导致——Python中对象是引用传递，函数内操作的是同一个ExcelWriter实例，返回并重新赋值只是冗余操作，不会破坏原有对象。真正的原因通常集中在以下几点：

排查与修复步骤 #

• 检查文件路径与权限
  确保filename是有效路径，当前用户有写入权限，且目标文件没有被Excel等程序占用（被占用会导致写入失败，生成空文件）。

• 确认工作表操作的有效性
  直接通过workbook.add_worksheet创建的工作表，必须用XlsxWriter原生API写入数据，否则工作表会是空的。比如你需要替换*Do something with the worksheet*为实际的写入逻辑：

  # 示例：写入文本与数据
  worksheet.write('A1', '表头')
  worksheet.write('A2', 100)
  worksheet.write('B2', '测试内容')
  
  # 示例：添加单元格格式
  bold_format = workbook.add_format({'bold': True, 'font_color': 'red'})
  worksheet.write('A1', '加粗表头', bold_format)
  

• 简化代码逻辑（可选）
  由于是引用传递，你不需要重新赋值writer，直接调用函数即可：

  # 替换 writer = test_func(writer)
  test_func(writer)
  

完整可运行示例代码 #

import pandas as pd

# 构造测试DataFrame
df = pd.DataFrame({'销售额': [15000, 22000, 18000], '区域': ['华东', '华北', '华南']})
filename = 'sales_report.xlsx'

# 初始化ExcelWriter
writer = pd.ExcelWriter(filename, engine="xlsxwriter")
# 写入第一个工作表
df.to_excel(writer, sheet_name='销售数据', index=False)

def add_summary_sheet(excel_writer):
    workbook = excel_writer.book
    worksheet = workbook.add_worksheet('销售汇总')
    
    # 写入汇总内容
    worksheet.write('A1', '销售报表汇总', workbook.add_format({'bold': True, 'font_size': 14}))
    worksheet.write('A3', '总销售额')
    worksheet.write('B3', df['销售额'].sum())
    worksheet.write('A4', '区域数量')
    worksheet.write('B4', df['区域'].nunique())
    
    return excel_writer

# 调用函数添加工作表
add_summary_sheet(writer)

# 保存并关闭（close()会自动触发save()）
writer.close()

额外注意事项 #

• 确保Pandas和XlsxWriter版本为最新，旧版本可能存在兼容性问题，可通过pip install --upgrade pandas xlsxwriter升级。
• 不要在函数内调用workbook.close()或excel_writer.close()，否则后续的全局writer.close()会失效。

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