我经常碰到开发者在装face_recognition时踩坑，大多都是因为依赖项没配置好——毕竟这个模块依赖的dlib需要编译环境，很容易出问题。下面分步骤给你排查和解决：

一、先做基础检查 #

• 确保你的pip是最新版本：

  python -m pip install --upgrade pip
  

• 确认Python版本兼容：face_recognition支持Python 3.6-3.9（尽量用主流稳定版，版本太新可能存在兼容问题）

二、针对不同系统的解决方案 #

Windows系统 #

Windows下最容易因为缺少编译工具和依赖失败，推荐两种省心的方法：

1. 用预编译的dlib包（优先选这个）
   先下载适配你Python版本和系统位数的dlib预编译包（比如对应Python3.9+64位的版本），然后执行安装：

   # 替换成你下载的实际文件名
   pip install dlib-19.22.99-cp39-cp39-win_amd64.whl
   

   成功装完dlib后，再安装face_recognition：

   pip install face_recognition
   

2. 手动配置编译环境
   安装Visual Studio Build Tools，勾选“C++开发工具”和对应版本的Windows SDK，安装完成后重启终端再尝试安装命令。

macOS系统 #

macOS需要先配置编译依赖和系统工具：

• 安装Xcode命令行工具：

  xcode-select --install
  

• 用Homebrew安装dlib的核心依赖：

  brew install cmake dlib
  

• 最后安装face_recognition：

  pip install face_recognition
  

Linux系统（以Ubuntu/Debian为例） #

先安装系统级的编译依赖库：

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

然后依次安装dlib和face_recognition：

pip install dlib
pip install face_recognition

三、如果还是失败？试试这些替代方案 #

• 用conda安装（如果你用Anaconda/Miniconda环境）：

  conda install -c conda-forge dlib
  conda install -c conda-forge face_recognition
  

• 克隆源码手动安装：

  git clone https://github.com/ageitgey/face_recognition.git
  cd face_recognition
  pip install -e .
  

四、常见错误排查 #

如果安装时提示error: command 'gcc' failed或类似编译错误，基本是系统缺少编译依赖，回到对应系统的步骤补全依赖即可；如果提示Python版本不兼容，就切换到符合要求的Python版本重试。

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