Windows下pip安装face-recognition时dlib安装失败问题求助

问题说明 #

在Windows系统使用pip安装face-recognition库时出现错误，导致依赖的dlib包无法成功安装，安装过程的中文翻译输出如下：

C:\Users\Poornima>pip install face-recognition
警告：忽略无效的包 -make (c:\users\poornima\appdata\local\packages\pythonsoftwarefoundation.python.3.11_qbz5n2kfra8p0\localcache\local-packages\python311\site-packages)
警告：忽略无效的包 -make (c:\users\poornima\appdata\local\packages\pythonsoftwarefoundation.python.3.11_qbz5n2kfra8p0\localcache\local-packages\python311\site-packages)
正在收集face-recognition
  使用缓存的face_recognition-1.3.0-py2.py3-none-any.whl (15 kB)
已满足依赖：numpy (来自face-recognition) (版本1.23.5，位于c:\users\poornima\appdata\local\packages\pythonsoftwarefoundation.python.3.11_qbz5n2kfra8p0\localcache\local-packages\python311\site-packages)
正在收集face-recognition-models>=0.3.0
  使用缓存的face_recognition_models-0.3.0-py2.py3-none-any.whl
正在收集Click>=6.0
  使用缓存的click-8.1.3-py3-none-any.whl (96 kB)
已满足依赖：Pillow (来自face-recognition) (版本9.5.0，位于c:\users\poornima\appdata\local\packages\pythonsoftwarefoundation.python.3.11_qbz5n2kfra8p0\localcache\local-packages\python311\site-packages)
正在收集dlib>=19.7
  使用缓存的dlib-19.24.2.tar.gz (11.8 MB)
正在安装构建依赖... 完成
正在获取构建wheel的需求... 完成
正在准备元数据(pyproject.toml)... 完成
已满足依赖：colorama (位于c:\users\poornima\appdata\local\packages\pythonsoftwarefoundation.python.3.11_qbz5n

解决步骤 #

1. 修复无效包警告 #

• 找到警告中指定的路径：c:\users\poornima\appdata\local\packages\pythonsoftwarefoundation.python.3.11_qbz5n2kfra8p0\localcache\local-packages\python311\site-packages
• 删除该路径下名称异常的-make相关文件夹（通常是类似make-xxx.dist-info的损坏包目录）
• 或者执行pip install --upgrade pip更新pip，再运行pip install --force-reinstall make强制修复该包

2. 解决dlib安装失败问题 #

方法一：安装预编译wheel包（推荐）

Windows下编译dlib需要复杂环境配置，直接用预编译包更快捷：

• 确认你的Python版本（此处为3.11）和系统位数（64位）
• 找到对应版本的dlib wheel包，执行类似命令安装：

  pip install dlib-19.24.2-cp311-cp311-win_amd64.whl
  

• 安装完dlib后，重新运行pip install face-recognition

方法二：配置编译环境

若需源码编译：

• 安装Visual Studio Community版，勾选「使用C++的桌面开发」组件
• 安装CMake并将其添加到系统环境变量PATH中
• 重启命令行，重新运行pip install face-recognition

方法三：降级Python版本

dlib对高版本Python兼容性可能不足，可将Python降级到3.9或3.10版本，再尝试安装face-recognition

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