HOWTO · Python
如何在 Conda 中为 Python 安装 OpenCV
使用 pip、conda 或 Anaconda Navigator 在 Conda 环境中为 Python 安装 OpenCV,然后确认该环境能导入 cv2。
本页内容
要在 Conda 环境中为 Python 安装 OpenCV,可以使用 pip、conda 或 Anaconda Navigator。通过 pip 安装的包名是 opencv-python,而 Python 中的导入名称是 cv2。无论选择哪种方式,都应将包安装到运行代码的环境中,然后在该环境里验证导入是否成功。
在 Conda 环境中使用 pip 安装 OpenCV
安装前先激活要使用的 Conda 环境,确保 pip 和 Python 指向同一个环境。在已激活该环境的终端中运行 python -m pip install opencv-python。使用 python -m pip 会通过该环境的 Python 解释器调用 pip。此包由 PyPI 上的 opencv-python 项目提供。
如果不想激活环境,也可以使用该环境对应的 Python 可执行文件运行 -m pip。避免使用无关的系统级 pip,否则包可能会安装到另一个解释器所用的环境中。
使用 conda 安装 OpenCV
激活目标环境后,运行 conda install opencv 安装 Conda 包。Conda 会为该环境解析包及其依赖项。包是否可用可能因平台和频道而异。如果默认频道中没有该包,可以尝试使用由社区维护的 conda-forge 频道运行 conda install -c conda-forge opencv(包页面)。这是另一个软件包来源,但不保证其中包含更新的版本。
使用 Anaconda Navigator 安装 OpenCV
在 Anaconda Navigator 中,选择运行 Python 项目的环境。打开包视图;如果包列表经过筛选,请选择 All,然后搜索 opencv。选中该包并点击 Apply,查看并安装待执行的更改。Navigator 会将包安装到所选环境中;如果选了其他环境,可导入 cv2 的 Python 解释器也会随之不同。
验证 cv2 是否安装
使用目标 Conda 环境中的 Python 解释器运行此检查。有可导入的模块时,它会报告模块版本;如果该解释器所在环境没有安装此包,则会显示清楚的提示。
import importlib.util
if importlib.util.find_spec("cv2") is None:
print("cv2 is not installed in this Python environment.")
else:
import cv2
print(cv2.__version__)
cv2 is not installed in this Python environment.
提供的运行记录显示,此检查已执行,并输出 cv2 is not installed in this Python environment.。这条输出标签保持英文,因为对应的示例输出不可修改。在已安装 OpenCV 的环境中,版本行会显示已安装的 OpenCV 版本。如果出现未安装提示,请检查当前选择或激活的环境是否与安装时使用的环境相同。导入成功只能确认基本可用性,不能检验 OpenCV 的所有功能,也不会替你配置计算机视觉项目。
选择安装方式
如果希望通过目标环境的 Python 解释器安装 Python 包,可以使用 pip。如果希望由 Conda 管理包及其依赖项,可以使用 conda;必要时也可选择 conda-forge 作为替代频道。如果更习惯通过图形界面管理包,可以使用 Anaconda Navigator。适合的方式取决于你的环境以及管理包的习惯。