Python终端安装face_recognition模块遇dlib遗留安装失败错误

错误含义解释 #

legacy-install-failure是pip针对传统源码包的报错，这类包（比如旧版dlib）未遵循PEP 517/518现代打包规范，pip在构建隔离环境安装时易出现编译或依赖冲突问题。哪怕你单独安装过dlib，face_recognition的安装脚本仍可能尝试重新编译dlib，触发该错误。

解决步骤 #

• 验证dlib是否真的可用
  运行以下命令确认dlib是否正确安装并能导入：

  python -c "import dlib; print(dlib.__version__)"
  

  如果报错，说明之前的dlib安装未真正成功，需重新安装。

• 使用预编译dlib包，跳过源码编译
  直接安装预编译版本的dlib，再安装face_recognition：

  # 安装预编译dlib
  pip install dlib --only-binary :all:
  # 安装face_recognition
  pip install face_recognition
  

  若指定兼容性较好的版本（如19.22.0）：

  pip install dlib==19.22.0 --only-binary :all:
  

• 让face_recognition复用已安装的dlib
  确认dlib在当前环境可用后，安装face_recognition时关闭pip的构建隔离，强制使用现有依赖：

  pip install face_recognition --no-build-isolation
  

  使用pipenv时添加对应参数：

  pipenv install face_recognition --no-build-isolation
  

• 更新pip/pipenv到最新版本
  旧版pip对传统包的支持存在缺陷，先更新工具：

  # 更新pip
  pip install --upgrade pip
  # 更新pipenv
  pip install --upgrade pipenv
  

  之后再尝试安装face_recognition。

• 不同系统的额外依赖处理

  • Linux：若必须源码编译，先安装依赖：

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

  • macOS：确保安装Xcode命令行工具：

    xcode-select --install
    

  • Windows：需安装Visual Studio Build Tools（勾选"C++开发工具"），或直接使用预编译包方法。

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