遍历目录时pd.ExcelWriter报xlsx引擎无效扩展名错误求助

核心错误分析 #

这个Invalid extension for engine...错误几乎都是ExcelWriter的引擎参数配置错误导致的——你大概率是在遍历代码里不小心把引擎参数设成了Python属性对象（而非预期的字符串值，比如'openpyxl'或'xlsxwriter'），或者遍历过程中变量名冲突覆盖了引擎参数。手动运行正常说明基础写入逻辑没问题，问题出在遍历环节的变量或路径处理上。

针对性排查与修复步骤 #

1. 检查ExcelWriter的引擎参数 #

• 绝对不要写engine=pd.ExcelWriter这类错误代码，必须传字符串类型的引擎名：

  # 正确写法（以openpyxl为例，支持.xlsx格式）
  with pd.ExcelWriter(output_file_path, engine='openpyxl') as writer:
      df.to_excel(writer, sheet_name='TargetSheet')
  

• 排查遍历代码中是否有变量名和engine重名，比如用engine作为循环变量，直接覆盖了原本的引擎参数值。

2. 规范遍历中的路径拼接 #

Windows路径斜杠问题本身不会触发这个错误，但可能导致文件找不到间接引发异常，建议用系统原生方法拼接路径：

import os

test_dir = "test"
# 遍历test目录下的子文件夹
for subdir_name in os.listdir(test_dir):
    subdir_path = os.path.join(test_dir, subdir_name)
    if not os.path.isdir(subdir_path):
        continue  # 跳过非目录文件
    
    # 按规则拼接csv文件路径
    csv_80_path = os.path.join(subdir_path, f"{subdir_name}80.csv")
    csv_80m_path = os.path.join(subdir_path, f"{subdir_name}80m.csv")
    
    # 先确认文件存在再处理
    if not (os.path.exists(csv_80_path) and os.path.exists(csv_80m_path)):
        print(f"跳过{subdir_name}: 缺少目标csv文件")
        continue
    
    # 调用你的处理函数
    df_80 = all_calc_80(csv_80_path)
    df_80m = all_calc_80m(csv_80m_path)
    
    # 写入Excel（示例）
    output_excel = os.path.join(subdir_path, f"{subdir_name}_result.xlsx")
    with pd.ExcelWriter(output_excel, engine='openpyxl') as writer:
        df_80.to_excel(writer, sheet_name='80数据', index=False)
        df_80m.to_excel(writer, sheet_name='80m数据', index=False)

3. 验证输出Excel的文件名 #

确保输出的Excel文件名后缀是.xlsx（对应openpyxl引擎）或.xls（对应xlwt引擎），不要出现拼写错误（比如.xlxs）或缺失后缀。

关键注意点 #

• 确保安装了对应的Excel引擎：pip install openpyxl（处理.xlsx）或pip install xlsxwriter
• 遍历过程中避免使用engine、writer这类关键字作为循环变量，防止变量污染
• 始终用os.path.join()或pathlib.Path处理路径，不要手动拼接斜杠

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