使用 pip 快速安装 OpenCV

使用 pip 在 Ubuntu,macOS 上快速安装 OpenCV。
Ubuntu 版本:Ubuntu 20.04.2 LTS;
macOS 版本:macOS Big Sur 11.4。

对于 Python 应用而言,可以使用 pip 安装软件包[1],本文就以 Ubuntu 和 macOS 为例,展示安装 OpenCV 的过程。

需要首先说明的是,用 pip 安装的 OpenCV 包不影响日常使用,但并不是 OpenCV.org 官方发布的。

1. pip 的两种 OpenCV 安装包

在 PyPI 仓库中,共有 4 种 OpenCV 包可用于 pip 安装,安装时仅能选择其中一个

对于桌面环境(如 Windows,macOS 和 Linux 系统),可以使用下面两个版本:

  1. opencv-python:这个版本仅包括了 OpenCV 的主模块
  2. opencv-contrib-python:这个版本包括了 OpenCV 的主模块和发布版/附加模块

对于服务器/非 GUI 环境,可以使用下面两个 Headless 版本,不包括任何 GUI 功能,不能直接使用 cv2.imshow 等函数:

  1. opencv-python-headless:这个版本仅包括了 OpenCV 的 headless 主模块
  2. opencv-contrib-python-headless:这个版本包括了 OpenCV 的 headless 主模块和发布版/附加模块

再次强调,不要同时安装多个版本,只可以安装其中一个版本。

2. 在 Ubuntu 上使用 pip 安装 OpenCV

2.1 安装 pip

对于 Ubuntu 的发行版而言,一般预装了 Python 2 和 Python 3,两个版本可谓天差万别。

而两个版本的 Python 都包括了不同的 pip。一般使用 pip 时默认指 Python 2,pip3 则指 Python 3 中的 pip。

可以通过如下命令检查 Python 的版本:

python3 --version

比如我的电脑显示为:

Python 3.8.5

表示 Ubuntu 中安装了 3.8.5 版本的 Python。

我们现在一般使用的是 Python 3,因此使用以下命令安装 pip3

sudo apt install python3-pip

在按要求输入账户密码后,将安装 pip3 和它的依赖项。

注意: 我在输入上述命令后,产生了 Waiting for cache lock: Could not get lock... 的错误,排除错误可参考本文

安装完成后,输入以下命令来检查安装是否正确:

pip3 --version

结果将显示 pip3 的版本号:

pip 20.0.2 from /usr/lib/python3/dist-packages/pip (python 3.8)

类似显示意味着已成功安装 pip3

2.2 安装 OpenCV

对于 Python 而言,可以构建一个虚拟环境(Virtual Environment),并在虚拟环境中安装不同的软件包。
我们这里不使用虚拟环境,直接将 opencv-contrib-python 安装到系统中(在下面的 macOS 中再演示虚拟环境安装):

sudo pip install opencv-contrib-python

经过一段时间后,显示安装了 opencv-contrib-python 及其他依赖包(如 numpy):

image

默认情况下 pip 使用的是国外镜像,国内的同学可能下载速度过慢,此时可以考虑将 pip 使用的源修改为国内的镜像源

3. 在 macOS 上使用 pip 安装 OpenCV

由于 macOS 上自带的是 Python 2,需要自行安装 Python 3。同时,部分同学 (包括我!!)=可能安装过 Anaconda 或者 Pycharm 等软件,使得 macOS 下 Python 的版本管理混乱。我后面会专门写一篇文章介绍躲开这些坑的方法。

这里介绍使用 pip 将 OpenCV 安装到虚拟环境下的过程(重点是 macOS 上虚拟环境的配置)。

3.1 安装虚拟环境所需软件

安装 virtualenvvirtualenvwrapper 到电脑中[2]

pip3 install virtualenv virtualenvwrapper

之后,需要在系统配置文件 ~/.bash_profile 中添加配置内容。使用 vim (或 nano 等应用)打开该文件:

vim ~/.bash_profile

将下列内容添加到文件末尾:

# virtualenv and virtualenvwrapper
export WORKON_HOME=$HOME/.virtualenvs
export VIRTUALENVWRAPPER_PYTHON=/usr/local/bin/python3
source /usr/local/bin/virtualenvwrapper.sh

保存文件后,在终端中运行下面命令:

source ~/.bash_profile

注意: 由于我之前乱七八糟安装/卸载过多次相关软件包,使得出现了 /Users/XXX/.bash_profile:source:11: no such file or directory: /usr/local/bin/virtualenvwrapper.sh 的错误,此时需要通过在终端中运行 which virtualenvwrapper.sh 的命令,确定其地址并对添加内容的第二行进行修改。

3.2 配置所需虚拟环境

virtualenvwrapper 提供了一些常见的命令,可以用于配置虚拟环境。

  • mkvirtualenv:创建一个新的虚拟环境;
  • workon:激活/转换到一个虚拟环境中;
  • deactivate:退出虚拟环境,回到自己的系统中;
  • rmvirtualenv:删除虚拟环境。

我们这里创建一个名为 cv_test 的 Python3 的虚拟环境:

mkvirtualenv cv_test -p python3

可以看到,此时命令行的最前面增加了一个括号,显示为(cv_test),表示此时已在此虚拟环境下工作了。

3.3 安装 OpenCV 到虚拟环境中

下面将 opencv-contrib-python 安装到系统中:

pip3 install opencv-contrib-python

静候片刻,即完成了 OpenCV 的安装。

4. 测试安装结果

无论 Ubuntu 还是 macOS,安装完成后,可以测试是否安装成功。

以 macOS 为例,首先进入对应的虚拟环境中:

workon cv_test

然后在终端中运行 python3,进入 Python 3 的交互环境,通过导入 OpenCV 包,即可显示版本:

% python3
Python 3.7.0 (v3.7.0:1bf9cc5093, Jun 26 2018, 23:26:24) 
[Clang 6.0 (clang-600.0.57)] on darwin
Type "help", "copyright", "credits" or "license" for more information.
>>> import cv2
>>> cv2.__version__
'4.5.2'

说明我们使用 pip 安装成功了 OpenCV,可供后续使用。


  1. pip 是 Python 中的标准库管理器,可以用于对 Python 包的查找、下载、安装、卸载其他软件包,入门知识可参考本文

  2. virtualenvvirtualenvwrapper 是用于对 Python 进行虚拟环境配置/管理的软件包,入门知识可参考本文

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 221,820评论 6 515
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 94,648评论 3 399
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 168,324评论 0 360
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 59,714评论 1 297
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 68,724评论 6 397
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 52,328评论 1 310
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,897评论 3 421
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,804评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 46,345评论 1 318
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 38,431评论 3 340
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 40,561评论 1 352
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 36,238评论 5 350
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,928评论 3 334
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 32,417评论 0 24
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 33,528评论 1 272
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,983评论 3 376
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 45,573评论 2 359

推荐阅读更多精彩内容