使用 pandas 读取 Excel 文件时报错的常见问题及解决方法

在使用 Python 的 pandas 库读取 Excel 文件时，很多用户可能会遇到各种错误。这些错误可能源自文件路径问题、依赖库缺失、文件格式不兼容等原因。本文将总结常见的报错及其解决方法，帮助你高效地排查问题。

1. 常见的错误信息

1.1 FileNotFoundError

python FileNotFoundError: [Errno 2] No such file or directory: 'your_file.xlsx'

错误原因：

这个错误通常出现在文件路径不正确的情况下。可能是文件不存在、路径拼写错误或文件没有正确传递。

解决方法：

1. 确认文件路径是否正确。

2. 使用绝对路径而不是相对路径。例如： python df = pd.read_excel(r'C:\Users\Username\Documents\your_file.xlsx')

3. 确保文件没有被其他程序占用，导致无法读取。

1.2 ValueError: Excel file format cannot be determined

python ValueError: Excel file format cannot be determined, you must specify an engine manually.

错误原因：

当 pandas 无法自动识别 Excel 文件的格式时，通常会发生此错误。例如，文件可能没有正确的 .xls 或 .xlsx 扩展名，或者文件损坏。

解决方法：

1. 确认文件扩展名是否为 .xls 或 .xlsx。
2. 如果文件是旧版 Excel 格式（如 .xls），你可以手动指定读取引擎： python df = pd.read_excel('your_file.xls', engine='xlrd')
3. 如果文件是 .xlsx 格式，则应确保已安装 openpyxl 库： bash pip install openpyxl

1.3 ImportError: Missing optional dependency 'xlrd'

python ImportError: Missing optional dependency 'xlrd'. Use pip or conda to install xlrd.

错误原因：

这个错误通常发生在尝试读取 .xls 文件时，pandas 依赖的 xlrd 库没有安装。

解决方法：

1. 安装 xlrd 库： bash pip install xlrd

2. 如果你读取的是 .xlsx 文件，而不希望安装 xlrd，可以使用 openpyxl： bash pip install openpyxl 然后指定引擎： python df = pd.read_excel('your_file.xlsx', engine='openpyxl')

1.4 xlrd.biffh.XLRDError: Excel xlsx file; not supported

python xlrd.biffh.XLRDError: Excel xlsx file; not supported

错误原因：

这是因为 xlrd 版本更新后不再支持读取 .xlsx 格式的文件。它只支持 .xls 格式。

解决方法：

1. 如果你的文件是 .xlsx 格式，使用 openpyxl 代替 xlrd： bash pip install openpyxl 并在读取时指定引擎： python df = pd.read_excel('your_file.xlsx', engine='openpyxl')

1.5 TypeError: 'NoneType' object is not callable

python TypeError: 'NoneType' object is not callable

错误原因：

该错误通常是因为 pandas 库本身未正确安装，或者存在安装冲突。

解决方法：

1. 重新安装 pandas 库： bash pip install --upgrade pandas

2. 确保没有与 pandas 冲突的其他库。

2. 其他常见问题

2.1 读取多表单 Excel 文件

如果 Excel 文件中包含多个工作表，可以通过指定 sheet_name 参数来读取特定的工作表：

python df = pd.read_excel('your_file.xlsx', sheet_name='Sheet1')

如果你想读取所有工作表，可以将 sheet_name 设置为 None，返回一个字典：

python dfs = pd.read_excel('your_file.xlsx', sheet_name=None)

2.2 设置列名和索引

如果 Excel 文件中没有列名，或者你希望自定义列名和索引，可以使用 header 和 index_col 参数：

python df = pd.read_excel('your_file.xlsx', header=None, index_col=0)

3. 总结

在使用 pandas.read_excel() 读取 Excel 文件时，最常见的错误通常与文件路径、缺少依赖库或文件格式不兼容有关。通过检查文件路径、安装正确的依赖库（如 openpyxl、xlrd），以及确保文件格式正确，可以有效解决大部分问题。如果遇到更复杂的错误，可以查看报错信息并参考相关文档进行排查。

希望本文的解决方法能帮助你顺利读取 Excel 文件！