WSL环境下pip安装dlib失败：Failed Building Wheel for Dlib错误

问题描述 #

在Windows 10的WSL Ubuntu环境中搭建人脸识别机器学习项目，需安装cmake、python-git、imutils、opencv-python、face-recognition等依赖。安装opencv-python的子依赖dlib时，反复出现Failed Building Wheel for Dlib错误。

已尝试以下操作但未解决：

• 在WSL中执行sudo apt-get install cmake和sudo apt install cmake
• 在WSL中执行pip install cmake和sudo pip install cmake
• 卸载并重装pip
• 通过pip卸载并重装cmake
• 从cmake官网手动安装Windows x64版本并添加至Windows PATH
• 在Ubuntu中手动修改PYTHONPATH指向cmake所在目录

重装WSL后，先安装pip再执行pip install cmake，将/home/dydro/.local/bin添加至PATH后，运行pip install dlib仍报错，提示ModuleNotFoundError: No module named 'cmake'及“ERROR: CMake must be installed to build dlib”。推测问题可能源于Windows与WSL环境的cmake路径冲突，或是cmake安装位置错误。

解决方案 #

完全重装WSL后，在新的Ubuntu环境中按顺序执行以下命令：

1. sudo apt install cmake
2. pip install dlib

执行后成功解决问题。

问题根源 #

使用pip安装cmake是导致故障的核心原因。系统级工具（如cmake）应通过系统包管理器（apt）安装，Python库则优先使用pip安装，需注意区分两者的使用场景，避免环境冲突。

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