如何解决「ERROR: Failed building wheel for insightface」编译错误

报错信息 #

note: 此错误源自子进程，大概率不是pip的问题。
ERROR: Failed building wheel for insightface
Failed to build insightface
ERROR: Could not build wheels for insightface, which is required to install pyproject.toml-based projects

解决方案 #

• 安装编译依赖
  • Debian/Ubuntu系：sudo apt-get install build-essential cmake libopenblas-dev liblapack-dev libx11-dev libgtk-3-dev
  • RHEL/CentOS系：sudo yum groupinstall "Development Tools" && sudo yum install cmake openblas-devel lapack-devel libX11-devel gtk3-devel
  • Windows：安装Visual Studio Build Tools并勾选C++开发工具集
• 指定兼容版本安装
  执行命令：pip install insightface==0.7.3
• 源码编译安装
  1. 下载并解压insightface源码包
  2. 进入源码目录：cd insightface
  3. 执行本地安装：pip install -e .
• 验证Python版本
  确保使用Python 3.7~3.10版本，部分insightface版本对Python 3.11+支持不完善

内容的提问来源于stack exchange，提问作者kin