使用Python处理Excel文件的过程中,常会遇到ImportError: Missing optional dependency 'openpyxl'. Use pip or conda to install openpyxl.的报错提示,这个问题的核心原因是Python环境中缺少了操作Excel所需的openpyxl依赖包,只需通过对应的包管理工具安装该依赖,就能解决这个报错,恢复Excel文件的正常操作。
openpyxl是Python中专门用于读写Excel 2007及以上版本.xlsx格式文件的第三方库,像pandas这类常用的数据处理库,在操作xlsx文件时,也会依赖openpyxl来实现相关功能。当Python环境中未安装这个库,却执行了读取、写入xlsx文件的代码时,解释器就会抛出上述导入错误,提示缺少该可选依赖。
两种解决方法
方法一:使用pip安装openpyxl
这是最常用的安装方式,适用于使用pip作为包管理工具的Python环境,操作步骤如下:
1、打开电脑的命令提示符(CMD)、终端(Mac/Linux)或Anaconda Prompt;
2、输入以下安装命令,回车执行:
pip install openpyxl
3、等待安装进度完成,提示“Successfully installed openpyxl-xxx”即代表安装成功。
若存在多Python版本/虚拟环境,可使用指定pip版本安装,避免安装到错误环境,示例命令:
# Python3/pip3指定安装
pip3 install openpyxl
# 虚拟环境或指定路径的pip
python -m pip install openpyxl
方法二:使用conda安装openpyxl
适用于使用Anaconda/Miniconda管理Python环境的用户,操作步骤如下:
1、打开Anaconda Prompt终端;
2、若需安装到指定虚拟环境,先激活环境(无需指定环境则跳过此步):
conda activate 你的环境名
3、输入以下安装命令,回车执行:
conda install openpyxl
4、安装过程中出现确认提示时,输入y并回车,等待安装完成即可。
验证安装结果
安装完成后,可通过简单步骤验证openpyxl是否成功安装:
1、打开Python交互式环境(命令行输入python/python3回车);
2、输入import openpyxl,回车后若没有出现任何报错,说明库已成功导入,依赖安装完成;
3、此时再执行原本操作Excel的代码,就不会再出现Missing optional dependency 'openpyxl'的报错。
