找不到满足 cv2 OpenCV 要求的版本

作者

找不到满足 cv2 OpenCV 要求的版本

Could not find version that satisfies requirement cv2 OpenCV

出现“Could not find a version that satisfy the requirement cv2 OpenCV”的错误有多种原因：

  • pip 安装错误的包。包的名称是opencv-python.
  • opencv-python使用包不支持的 Python 版本进行安装。
  • 使用 Python 2 的过时版本pip或使用pipPython 2 而不是
    pip3.

找不到满足 cv2 opencv 要求的版本

壳
ERROR: Could not find a version that satisfies the requirement cv2 (from versions: none)
ERROR: No matching distribution found for cv2

ERROR: Could not find a version that satisfies the requirement opencv-python
ERROR: No matching distribution found for opencv-python

尝试运行该pip install opencv-python包，因为它是导出 cv2 和其他 OpenCV 包的包的名称。

安装opencv-python包

在项目的根目录中打开终端并安装
opencv-python 模块。

壳
# 👇️ in a virtual environment or using Python 2
pip install opencv-python

# 👇️ for python 3 (could also be pip3.10 depending on your version)
pip3 install opencv-python

# 👇️ if you get permissions error
sudo pip3 install opencv-python

# 👇️ if you don't have pip in your PATH environment variable
python -m pip install opencv-python

# 👇️ for python 3 (could also be pip3.10 depending on your version)
python3 -m pip install opencv-python

# 👇️ for Anaconda
conda install -c conda-forge opencv

如果您仍然无法安装
opencv-python包，请尝试升级pip.

升级你的版本pip

pip以下是在所有操作系统上升级的命令。

哪个命令有效取决于您的操作系统和 Python 版本。

壳
# 👇️ if you have pip already installed
pip install --upgrade pip

# 👇️ if your pip is aliased as pip3 (Python 3)
pip3 install --upgrade pip

# 👇️ if you don't have pip in your PATH environment variable
python -m pip install --upgrade pip

# 👇️ if you don't have pip in your PATH environment variable
python3 -m pip install --upgrade pip

# 👇️ if you have easy_install
easy_install --upgrade pip

# 👇️ if you get a permissions error
sudo easy_install --upgrade pip

# 👇️ if you get a permissions error when upgrading pip
pip install --upgrade pip --user

# 👇️ upgrade pip scoped to the current user (if you get permissions error)
python -m pip install --user --upgrade pip
python3 -m pip install --user --upgrade pip

# 👇️ Installing directly from get-pip.py (MacOS and Linux)
curl https://bootstrap.pypa.io/get-pip.py | python

# 👇️ if you get permissions issues
curl https://bootstrap.pypa.io/get-pip.py | sudo python

# 👇️ alternative for Ubuntu/Debian
sudo apt-get update && apt-get upgrade python-pip

# 👇️ alternative for Red Hat / CentOS / Fedora
sudo yum install epel-release
sudo yum install python-pip
sudo yum update python-pip

如果您无法更新pip，请查看以下
文章，其中包含有关如何安装和升级的说明pip。

pip install opencv-python现在尝试运行pip已升级的命令。

壳
pip install opencv-python
pip3 install opencv-python

python -m pip install opencv-python
python3 -m pip install opencv-python

拥有不受支持的 Python 版本opencv-python

该错误的另一个常见原因是 Python 版本不受opencv-python.

该opencv-python软件包支持 Python 3.6+ 版本。

您可以打开
opencv-python 的 pypi 页面，在左侧边栏Meta>
下查看支持的 Python 版本Requires。

opencv-python 支持的 python 版本

您可以使用python --version命令检查您的 Python 版本。

壳
python --version

python3 --version

获取 python 版本

如果您的 Python 版本低于 3.6，请从官方 python.org 网站下载最新版本并运行安装程序。

如果出现提示，请确保勾选以下选项：

  • 为所有用户安装启动器（推荐）
  • 将 Python 添加到 PATH（这会将 Python 添加到您的 PATH 环境变量）

如果这没有帮助，请尝试在范围为 Python 3 的虚拟环境中安装该包。

尝试在虚拟环境中安装包

另一件可能有帮助的事情是创建一个虚拟环境（如果您还没有的话）。

壳
# 👇️ use correct version of Python when creating VENV
python3 -m venv venv

# 👇️ activate on Unix or MacOS
source venv/bin/activate

# 👇️ activate on Windows (cmd.exe)
venv\Scripts\activate.bat

# 👇️ activate on Windows (PowerShell)
venv\Scripts\Activate.ps1

# 👇️ Upgrade pip
pip install --upgrade pip

# 👇️ install opencv-python in virtual environment
pip install opencv-python

确保根据您的操作系统使用正确的激活命令。

您的虚拟环境将使用用于创建它的 Python 版本。

您也可以尝试pip install使用该--upgrade选项运行命令。

壳
pip install opencv-python --upgrade

pip3 install opencv-python --upgrade

python3 -m pip install opencv-python --upgrade

如果这没有帮助，请尝试将命令的范围限定为特定用户。

使用 –user 选项安装包

该错误通常是由于没有必要的权限为机器上的所有用户安装软件包而引起的。

要解决该错误，请使用该选项安装适用于特定用户的软件包
--user。

壳
pip install opencv-python --user

pip3 install opencv-python --user

python3 -m pip install opencv-python --user

该--user选项将包安装在用户的主目录中。

该命令基本上安装范围为特定用户的包，而不是整个系统。这有助于解决权限问题。

--user如果出现权限错误，请尝试使用标志或使用运行命令sudo。

壳
sudo pip install opencv-python

sudo pip3 install opencv-python

sudo python3 -m pip install opencv-python

如果这没有帮助，请尝试在详细模式下运行命令。

尝试在详细模式下运行 pip install opencv-python

如果这些建议都没有帮助，请尝试pip install在详细模式下运行命令。

壳
pip install opencv-python -vvv

pip3 install opencv-python -vvv

python -m pip install opencv-python -vvv

该-v选项代表详细模式，最多可以使用 3 次。

当pip install命令以详细模式运行时，命令会显示更多输出以及错误发生的方式。

如果错误仍然存​​在，请按照我的
Could not find a version that satisfy the requirement X
一文中的说明操作。

结论

要解决错误“找不到满足 cv2 OpenCV 要求的版本”，请确保：

  • 通过运行安装正确的包pip install opencv-python。
  • 您没有过时的版本pip。
  • 您正在使用版本支持范围内的 Python 版本
    opencv-python。