PyCharm运行人脸识别项目时Dlib与face-recognition安装报错求解决方案

常规编译安装方案 #

• 先配置基础编译依赖：
  • Windows系统：安装Visual Studio，勾选「使用C++的桌面开发」组件，再安装CMake并将其添加到系统环境变量
  • macOS系统：执行xcode-select --install安装Xcode命令行工具，再通过Homebrew执行brew install cmake
  • Linux（Debian/Ubuntu系列）：执行sudo apt-get install build-essential cmake libopenblas-dev liblapack-dev libx11-dev libgtk-3-dev python3-dev
• 依赖配置完成后，单独执行安装命令：
  1. 先执行pip install dlib==19.24.2
  2. 确认Dlib安装成功后，执行pip install face-recognition

注意：建议使用Python 3.10/3.11版本运行项目，Dlib目前对Python 3.12及以上版本适配不完善，容易出现安装报错。

免编译快速安装方案（新手优先选择） #

无需配置本地编译环境，直接安装预编译的二进制包即可：
下载对应你系统、Python版本、CPU架构的Dlib预编译whl文件，下载完成后执行pip install 本地whl文件路径，Dlib安装完成后再安装face-recognition即可。

功能替代方案 #

如果多次尝试安装失败，可以直接替换为以下无编译依赖的人脸识别库：

• insightface：百度开源的人脸识别工具库，精度和运行速度均优于face-recognition，支持人脸检测、关键点识别、特征比对全流程，仅需执行pip install insightface onnxruntime即可完成安装
• MTCNN+OpenCV组合：适合仅需要人脸检测功能的场景，安装命令为pip install mtcnn opencv-python
• 深度学习框架自带人脸检测接口：如PyTorch、TensorFlow官方提供的预训练人脸检测模型，无需额外安装第三方识别库即可使用

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