You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

VS Code安装dlib报Failed building wheel for dlib错误求助

问题背景

正在开发名为压力检测器的项目,需要使用face_recognition模块实现人脸相关功能。目前安装依赖时遇到问题:已经安装了cmake,但每次安装dlib(face_recognition的核心依赖)都会抛出构建错误,作为Python新手需要排查问题方向。

完整报错输出
b9d\build\lib.win-amd64-3.10', '-A', 'x64']' returned non-zero exit status 1.
  [end of output]

note: This error originates from a subprocess, and is likely not a problem with pip.
ERROR: Failed building wheel for dlib
Running setup.py clean for dlib
Failed to build dlib
Installing collected packages: dlib
  Running setup.py install for dlib ... error
  error: subprocess-exited-with-error
  
  × Running setup.py install for dlib did not run successfully.
  │ exit code: 1
  ╰─> [61 lines of output]

报错核心含义:pip在本地编译dlib的C++扩展时失败,无法生成可安装的wheel包,最终导致安装流程中断。

排查&解决步骤

按优先级从高到低操作即可:

  • 补全Windows下C编译环境:只装cmake没用,必须安装Visual Studio的C桌面开发组件。打开Visual Studio Installer,勾选「使用C++的桌面开发」工作负载,确认勾选了对应版本的MSVC编译器、Windows 10/11 SDK,安装完成后必须重启电脑,再重新开终端执行安装命令。
  • 验证cmake环境是否生效:安装cmake时要勾选「Add CMake to the system PATH for all users」选项,装完开新终端执行cmake --version,能正常输出版本号才是配置正确,旧终端不会加载新配置的环境变量,必须重开。
  • 升级基础构建工具:执行下面的命令把pip、setuptools、wheel升到最新,避免旧版本构建逻辑兼容问题:
    pip install --upgrade pip setuptools wheel
    
  • 避开本地编译:如果自己编译一直失败,可以直接下载和你Python版本、系统位数匹配的dlib预编译whl包,执行pip install 你下载的whl文件本地路径安装,不需要本地编译,成功率高。注意核对版本:比如你是Python3.10、64位系统,就要选cp310、win_amd64后缀的包。
  • 确认环境一致性:不要混用全局Python和虚拟环境,安装前先执行pip --version看一下当前pip对应的Python路径是不是你项目在用的环境,避免包装错位置。

内容的提问来源于stack exchange,提问作者Princy

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.26 12:45:42