Windows 10系统下安装dlib时出现Setup.py错误【PYTHON】
2026-8-3
解决dlib安装失败的实用方案
方案1：直接用预编译wheel包安装
源码编译dlib很容易踩依赖坑，优先用现成的预编译包：
- 先确认你的Python版本，执行
python --version查看 - 执行命令安装兼容版本：
pip install dlib==19.22.0（这个版本对多数Python版本都有预编译包，成功率高） - 如果还是不行，手动下载对应系统和Python版本的wheel文件，然后运行
pip install 下载的文件名.whl
方案2：补全编译依赖（针对必须源码编译的场景）
如果预编译包不匹配你的环境，得补全编译所需的工具：
- Windows：安装Visual Studio，安装时必须勾选“C++桌面开发”组件；或者安装MinGW-w64，把它的bin目录添加到系统环境变量
- macOS：打开终端执行
xcode-select --install，安装Xcode命令行工具 - Linux（Debian/Ubuntu系）：执行
sudo apt-get update && sudo apt-get install gcc g++ python3-dev
方案3：直接安装face_recognition
既然你的目标是用face_recognition，试试直接安装它，部分版本会自动处理dlib的依赖问题：
- 执行
pip install face_recognition - 若安装失败，加上清除缓存参数：
pip install face_recognition --no-cache-dir
额外注意事项
- 先把pip升级到最新版：
pip install --upgrade pip - 建议在虚拟环境中安装，避免系统全局依赖冲突：
- 创建虚拟环境：
python -m venv myenv - 激活虚拟环境：Windows下
myenv\Scripts\activate，macOS/Linux下source myenv/bin/activate - 再执行安装命令
- 创建虚拟环境：
内容的提问来源于stack exchange，提问作者joazeiro
相关产品推荐
相关产品推荐
