Pandas中xlsx与XLSX的差异及文件写入报错问题求助

这个问题我之前帮同事排查过，本质是pandas的Excel文件类型识别逻辑是严格区分大小写的——它预定义的引擎映射表里只有小写的xlsx，没有大写的XLSX，所以当你用大写后缀时，它找不到对应的处理引擎，就抛出了这个错误。下面给你几个实用的解决方案：

方案1：强制指定Excel引擎 #

直接在ExcelWriter里通过engine参数指定处理xlsx格式的引擎，不管后缀是大写还是小写都能正常工作。常用的引擎有两个：

• xlsxwriter：适合生成新的xlsx文件，支持图表、格式设置等功能
• openpyxl：适合读写已存在的xlsx文件（比如需要追加数据时）

示例代码：

# 先确保安装了对应的引擎库，比如执行 pip install xlsxwriter
import pandas as pd
writer = pd.ExcelWriter('myFile.XLSX', engine='xlsxwriter')
# 后续写入数据的代码...
df.to_excel(writer, sheet_name='Sheet1')
writer.close()

方案2：统一使用小写后缀（最简单省心） #

这就是你已经验证有效的方法，把输出文件名改成myFile.xlsx，pandas会自动识别后缀并匹配对应的引擎，不需要额外配置。这个方法最稳妥，也不容易出其他兼容问题。

方案3：手动添加大写后缀的引擎映射（进阶） #

如果业务上必须使用大写的XLSX后缀，可以手动修改pandas的文件类型映射表，把XLSX关联到对应的引擎。不过这个方法属于“hack”式操作，可能会随pandas版本更新失效，谨慎使用：

import pandas as pd
# 把大写的XLSX添加到xlsxwriter的映射中
pd.io.excel._XLSX_WRITERS['XLSX'] = 'xlsxwriter'
# 之后就可以正常使用大写后缀了
writer = pd.ExcelWriter('myFile.XLSX')

补充说明 #

为什么Windows系统下文件名不区分大小写，但pandas还会报错？因为pandas的文件类型判断是基于字符串的精确匹配，它不会自动把大写后缀转换成小写去匹配，所以即使系统本身不区分大小写，pandas的逻辑还是会严格检查后缀的大小写。

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