【Python】已解决 ImportError: Missing optional dependency ‘xlrd‘. Install xlrd ＞= 1.0.0 for Excel support

一、分析问题背景

在数据分析和处理过程中，使用Pandas库读取Excel文件是一项常见的操作。然而，当尝试读取Excel文件时，可能会遇到以下错误：

ImportError: Missing optional dependency 'xlrd'. Install xlrd >= 1.0.0 for Excel support. Use pip or conda to install xlrd.

场景描述： 你正在开发一个数据分析项目，使用Pandas库读取Excel文件以处理和分析数据。当运行代码时，出现了上述错误提示，导致程序无法正常读取Excel文件。

二、可能出错的原因

导致此错误的原因主要有以下几种：

1. 缺少依赖库：Pandas库读取Excel文件依赖于xlrd库。如果系统中未安装该库，Pandas将无法读取Excel文件。
2. 版本不匹配：xlrd库的版本过低，Pandas要求的最低版本为1.0.0。如果安装的xlrd版本低于1.0.0，也会导致该错误。
3. 文件格式问题：从Pandas 1.2.0开始，xlrd库不再支持读取Excel 2007及以后的xlsx文件格式，若尝试使用旧版xlrd读取xlsx文件，也会报错。

三、错误代码示例

以下是一个可能导致该错误的代码示例：

import pandas as pd

# 尝试读取Excel文件
df = pd.read_excel("data.xlsx")
print(df.head())

解释错误之处：

• 当运行上述代码时，如果系统中未安装xlrd库，或者安装的xlrd版本低于1.0.0，将会抛出ImportError，提示缺少依赖库xlrd。

四、正确代码示例

为了解决此错误，我们需要安装或更新xlrd库。可以使用pip或conda来安装xlrd库。

使用pip安装或更新xlrd库：

pip install xlrd --upgrade

使用conda安装或更新xlrd库：

conda install -c anaconda xlrd

安装完成后，可以使用以下代码正确读取Excel文件：

import pandas as pd

# 读取Excel文件
df = pd.read_excel("data.xlsx")
print(df.head())

解释解决方法：

• 使用pip或conda安装或更新xlrd库，确保xlrd版本不低于1.0.0。
• 安装完成后，Pandas将能够正常调用xlrd库来读取Excel文件。

此外，从Pandas 1.2.0开始，推荐使用openpyxl库来读取Excel 2007及以后的xlsx文件格式。以下是使用openpyxl读取xlsx文件的示例：

安装openpyxl库：

pip install openpyxl

使用openpyxl读取Excel文件：

import pandas as pd

# 读取Excel文件，指定engine为openpyxl
df = pd.read_excel("data.xlsx", engine='openpyxl')
print(df.head())

五、注意事项

在编写代码时，需要注意以下事项，以避免类似错误：

1. 安装必要依赖库：确保安装了Pandas库读取Excel文件所需的依赖库，如xlrd和openpyxl。
2. 检查库版本：使用pip show xlrd命令检查已安装的xlrd版本，确保其版本不低于1.0.0。
3. 文件格式匹配：根据Excel文件的格式（xls或xlsx）选择合适的读取引擎。对于xlsx文件，推荐使用openpyxl库。
4. 处理异常：使用try-except块处理可能的异常，提供有意义的错误提示，便于调试和解决问题。
5. 代码风格：保持代码整洁，注释明确，便于维护和阅读。

通过遵循上述步骤和注意事项，您应该能够轻松解决“ImportError: Missing optional dependency ‘xlrd’”的问题，并成功使用Pandas读取Excel文件。以下是一个综合示例，展示如何正确安装依赖库并读取Excel文件：

import pandas as pd

try:
    # 尝试读取Excel文件
    df = pd.read_excel("data.xlsx", engine='openpyxl')
    print(df.head())
except ImportError as e:
    print(f"Error: {e}. Please install the required libraries using 'pip install openpyxl xlrd'.")
except FileNotFoundError:
    print("Error: The specified file was not found. Please check the file path.")
except Exception as e:
    print(f"An unexpected error occurred: {e}")

通过上述示例，读者可以清晰地理解如何安装依赖库并正确读取Excel文件，同时在代码中添加必要的错误处理，以提高代码的健壮性。