PyInstaller 打包后 Excel 转 CSV 报错解决方案:“excel file format cannot be determined“
一、问题背景
在使用 Python 开发 Excel 转 CSV 工具时,直接运行脚本(python script.py)可以正常工作,但通过 PyInstaller 打包成可执行文件后,出现以下报错:
excel file format cannot be determined, you must specify an engine manually
该问题通常发生在使用pandas.read_excel()读取 Excel 文件时,打包后的程序无法自动识别文件格式所需的解析引擎。
二、问题原因分析
- Pandas 引擎自动检测失效
Pandas 处理 Excel 文件时依赖外部库:
.xlsx格式需openpyxl
.xls格式需xlrd直接运行时 Pandas 会自动检测扩展名并调用对应引擎,但打包后依赖库可能未正确包含,导致引擎检测失败。 - 打包工具未包含依赖
PyInstaller 默认不会自动识别openpyxl/xlrd等非核心依赖,导致打包后的程序缺少必要模块。
三、分步解决方案
方案 1:显式指定 Excel 解析引擎(核心修复)
修改代码,根据文件扩展名强制指定解析引擎,避免 Pandas 自动检测:
import pandas as pd
读取Excel时增加引擎判断逻辑
if excel_path.lower().endswith(‘.xlsx’):
df = pd.read_excel(excel_path, sheet_name=sheet, engine=‘openpyxl’)
elif excel_path.lower().endswith(‘.xls’):
df
本文地址:https://www.vps345.com/10444.html