附录D:Python 添加 opencv-python库:win
时间:2018-10-10
作者:魏文应
一、说 明
在 win10 上,安装其实是非常简单的,只需:
pip install opencv-python
或者,使用 conda 方式安装:
conda install opencv
这样就可以正常添加 opencv 库了。很可惜,win7 上不行,会出现以下问题:
>>> import cv2
Traceback (most recent call last):
File "<stdin>", line 1, in <module>
ImportError: DLL load failed: 找不到指定的模块。
>>>
提示找不到相应的 DLL 动态库。事实上,这可以说是 pip 官方或者 anaconda 官方没有解决的 bug ,导致给添加 opencv 带来困难。网上给出了一些方案,但不太可行(后面我会分析相应方案)。下面是本次测试的安装环境:
-
windows 操作系统版本:
windows 7 旗舰版 SP1 64位
。 -
anaconda 版本:
anaconda5.3
支持python3.x.x
。 -
conda 版本:
conda4.5.11
。 -
python 版本:
python3.6.6
windows 64位
。 -
opencv 版本:
opencv3.4.1
。
安装之前,应确保电脑安装有以下软件:
- 保持较新版本的
.NET Framework
。 - 安装有
Microsoft Visual C++ 2015 Redistributable(x64)
。 - 安装有补丁
KB2999226
(点击此处下载)。
官方参考文档
下面,给出 pip 官方参考和 conda 官方参考(但 win7 上直接安装不一定可行,仅供参考):
- pypi.org 官方说明: https://pypi.org/project/opencv-python/ 。
- conda 官方说明: https://anaconda.org/conda-forge/opencv 。
这两个官方文档,在 win10 上安装是没有问题的,在 win7 上安装目前(2018-10-10)是不行的。
二、安装 opencv-python
成功的方案
这里,先给出我测试成功的方案步骤。你可以先创建一个环境进行测试,如果这个环境 测试通过 了,再在你的目标环境中添加 opencv-python 库:
conda create -n mytest pip python=3.6
进入这个环境中:
activate mytest
执行下面命令,添加 opencv-python
库(可用版本3.4.1
、3.3.0
、3.2.0
,点击这查看相关版本):
conda install -c conda-forge opencv=3.4.1
-c
指定远程仓库地址,默认是 anaconda 官网 。opencv=3.4.1
指定了版本是 3.4.1
,如果不知道版本,就使用最新版本,目前(2018-10-10)最新版本是 3.4.3
。注意:必须指定版本,最新版本在win7不可用。然后测试是否添加 opencv-python成功了:
python
进入 python 交互环境以后,导入 opencv :
import cv2
如果没有错误提示,说明添加 opencv-python 成功了:
这里是 tensorlfow2 环境测试(和 test 起名不一样而已)有问题的方案
如果直接使用官方给出的命令:
conda install -c conda-forge opencv
或者是
conda install -c conda-forge/label/broken opencv
在 anaconda 的 base 环境中没有问题,但是,在我们自己通过 conda creat
命令创建的环境中,同样会出现 ImportError: DLL load failed: 找不到指定的模块。
的问题。
三、网上相应方案
注意:这些都是不可行的方案。 这些是网上提及比较多的方法,但 都不可行,我测试的结果是,依然出错。
使用 depends.exe 工具
这个工具,可用来查 windows 程序 DLL 动态库的依赖关系的。到 depends.exe 的 官网 下载这个工具:
下载之后,解压下载的压缩包,直接打开 depends.exe
这个软件。打开之后,依次点击 file -> open
,并找到 opencv-python 的 .pyd
文件。我这里的环境名称为 tensorflow ,那么这个文件就在下面目录中(根据你自己 anaconda 的安装目录而定):
找到 cv2 的 .pyd 文件 自动需找依赖关系D:\ProgramData\Anaconda3\envs\tensorflow\Lib\site-packages
这样,就显示缺了哪些包,但是,这样并不可靠。(比如这里,我的 opencv 是正常的,但从图中你可以看出,它给我报了一大堆错误)。将缺的 DLL 包,下载下来,放到 C:\Windows\SysWOW64
中。注意:事实上,这种做法不可取,你想啊,每次都这么搞,岂不是很麻烦?版本更新了呢?显然不科学。
升级补丁
操作系统补丁是要的,最重要的是补丁 KB2999226
,不过这个补丁一般都有。
移动 DLL 文件
有很多人说,把 cv2 文件移到 Lib 文件夹下,那都是扯淡。
安装 opencv-contrib-python
有人说将 pip install opencv-python
换成 pip install opencv-contrib-python
,说什么自动安装依赖,那是扯淡。opencv-contrib-python
这个库,是在 opencv 的基础上,加了其它库,比如 脸部识别等。
四、总 结
在 windows 上使用 opencv-python 库的用户,win10 用户目前问题不大。win7 用户主要是提示缺少 DLL 动态库的问题,根本问题 是:
pip install opencv-python 或者 conda install -c conda-forge opencv ,默认安装的是最新版本的opencv。但是,最新版本的 opencv ,在 win7 上往往出现 DLL 动态库缺失的错误。
规避这个错误的根本方法是:
回退到前面的稳定版本
比如,如果 conda install -c conda-forge opencv=3.4.3
不行,那么可以使用 conda install -c conda-forge opencv=3.4.1
版本,直到退到可用为止。怎么知道有哪些版本呢?去 anaconda 官网搜索 opencv ,上面的 -c
参数后面可以加一个远程仓库地址,如果后面没有相关网址,则默认使用 anaconda 官方地址。 conda-forge
是用户名,这个用户上传了相应的 opencv 版本到 anaconda 这个网站上:
- 找到你认为合适的版本
在这上面找到你认为合适的版本,并使用 conda install -c conda-forge opencv=3.4.1
命令安装它即可。一般新版本会有问题,老版本的问题会少得多。