安装face_recognition库时遇CMake错误：如何解决？

嘿，我经常碰到开发者在安装face_recognition时碰到CMake相关的报错，这类问题基本都和编译环境配置不全或者依赖版本不兼容有关，给你一步步排查解决的方案：

1. 检查并升级CMake版本 #

face_recognition依赖的dlib库对CMake版本有要求（至少需要3.10以上），先确认你当前的版本：

cmake --version

如果版本低于要求，按你的系统类型升级：

• Ubuntu/Debian系统：
  先试试系统包管理器升级：

  sudo apt-get update && sudo apt-get install --upgrade cmake
  

  如果还是拿不到新版本，就手动编译安装：

  wget https://cmake.org/files/v3.26/cmake-3.26.0.tar.gz
  tar -xzvf cmake-3.26.0.tar.gz
  cd cmake-3.26.0
  ./bootstrap
  make -j$(nproc)
  sudo make install
  

• Anaconda环境：
  直接用conda安装适配的版本，这是最稳妥的方式：

  conda activate your_env_name  # 替换成你的conda环境名
  conda install cmake
  

2. 安装编译所需的系统依赖库 #

dlib编译需要一些底层库支持，缺了这些就会触发CMake报错，按系统安装：

• Ubuntu/Debian：

  sudo apt-get install build-essential libopenblas-dev liblapack-dev libx11-dev libgtk-3-dev python3-dev
  

• macOS（用Homebrew）：

  brew install cmake pkg-config openblas
  

• Windows：
  推荐用Anaconda环境，或者安装Visual Studio并勾选「桌面开发C++」组件（包含CMake和编译工具链）。

3. 先单独安装dlib再装face_recognition #

有时候直接pip装face_recognition会因为dlib编译失败卡壳，我们可以先手动装dlib，再装face_recognition：

# 激活你的conda环境
conda activate your_env_name
# 从conda-forge安装预编译的dlib，避免编译报错
conda install -c conda-forge dlib
# 再安装face_recognition
pip install face_recognition

4. 清理缓存后重新安装 #

如果之前的安装缓存有问题，试试清理后重新安装：

pip cache purge
pip install face_recognition --no-cache-dir

另外，你用的是Python3.6，虽然face_recognition 1.2.1支持这个版本，但dlib在旧Python版本上的编译可能更容易出问题，如果条件允许，升级到Python3.7+会减少不少兼容性问题~

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