opencv-python安装卡滞于Building wheel步骤的技术求助

• 使用国内PyPI镜像源加速安装
  网络延迟或不稳定是导致编译卡住的常见原因，切换国内镜像源可大幅提升下载效率。执行以下命令：

  pip install opencv-python -i https://pypi.tuna.tsinghua.edu.cn/simple
  

  若需清除缓存，可搭配--no-cache-dir参数：

  pip install --no-cache-dir opencv-python -i https://pypi.tuna.tsinghua.edu.cn/simple
  

• 安装预编译二进制包，跳过本地编译
  避免编译环节可直接解决卡住问题：

  • 若已安装Anaconda/Miniconda，用conda安装：

    conda install -c conda-forge opencv
    

  • 手动下载对应系统和Python版本的.whl预编译包，执行本地安装：

    pip install 下载的包文件名.whl
    

• 升级pip、setuptools和wheel工具
  旧版本工具可能存在编译兼容性问题，先升级依赖工具：

  pip install --upgrade pip setuptools wheel
  

  升级完成后重新尝试安装opencv-python。

• 补充系统编译依赖（Linux/macOS）
  缺少编译依赖会导致编译过程停滞，按需安装：

  • Ubuntu/Debian系：

    sudo apt-get update && sudo apt-get install build-essential cmake libgtk2.0-dev pkg-config libavcodec-dev libavformat-dev libswscale-dev
    

  • macOS（需先安装Homebrew）：

    brew install cmake pkg-config numpy
    

  依赖安装完成后重新执行pip安装命令。

• 降级到稳定版本安装
  最新版本可能存在编译适配问题，尝试安装经过验证的稳定旧版本：

  pip install opencv-python==4.5.5.62
  

内容的提问来源于stack exchange，提问作者Uche Samuel Madumere