conda环境下Could not build wheels for dlib解决方法

1 问题描述

在安装模型运行的conda环境时，出现如下问题：

Building wheels for collected packages: basicsr, face-alignment, dlib, ffmpy, filterpy, future
  Building wheel for basicsr (setup.py) ... done
  Created wheel for basicsr: filename=basicsr-1.4.2-py3-none-any.whl size=214848 sha256=a369da2f20c23d7f389b174f7fd3423377b4020022ff6234a98d21838d109e8e
  Stored in directory: c:\users\admin\appdata\local\pip\cache\wheels\b8\12\22\9e31eeca4e56e9ca769f4d3bf4bf0434dcb6aa3a669a719970
  Building wheel for face-alignment (setup.py) ... done
  Created wheel for face-alignment: filename=face_alignment-1.3.4-py2.py3-none-any.whl size=27875 sha256=feb3a8fe39f518c67f16510754de6fca2cffb9a98857586485f350f3564e18cb
  Stored in directory: c:\users\admin\appdata\local\pip\cache\wheels\de\68\f5\76db2e5ffbc882386a686244cb7058309a1cee25d6c1c54553
  Building wheel for dlib (setup.py) ... error
  error: subprocess-exited-with-error

  × python setup.py bdist_wheel did not run successfully.
  │ exit code: 1
  ╰─> [7 lines of output]
      running bdist_wheel
      running build
      running build_py
      running build_ext
     
      ERROR: CMake must be installed to build dlib
     
      [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
  Building wheel for ffmpy (setup.py) ... done
  Created wheel for ffmpy: filename=ffmpy-0.3.1-py3-none-any.whl size=5601 sha256=3b22c45083478e29b11dd535580a00a99fe3114695efdbda1375df2fc63aa84a
  Stored in directory: c:\users\admin\appdata\local\pip\cache\wheels\72\31\9f\d801db52ffc8fb7c94572f781112c98dad0ce7e4cef176d158
  Building wheel for filterpy (setup.py) ... done
  Created wheel for filterpy: filename=filterpy-1.4.5-py3-none-any.whl size=110542 sha256=c386ba7c32023a939fd157d57afa55df2050307f02511a6b6c7d1fb9ca4681c1
  Stored in directory: c:\users\admin\appdata\local\pip\cache\wheels\1f\a0\08\9388a0fe5337fbe2a814a3a8e2c63119ce722a2a42b5828c66
  Building wheel for future (setup.py) ... done
  Created wheel for future: filename=future-0.18.3-py3-none-any.whl size=492054 sha256=e2d3b5191bb4b8e063d508b0045b21e0057e7fa744127f7c414f65897f3e2577
  Stored in directory: c:\users\admin\appdata\local\pip\cache\wheels\d6\16\c3\446e86546ea4e6f218702c330e7e320575b71b597f95f78108
Successfully built basicsr face-alignment ffmpy filterpy future
Failed to build dlib
ERROR: Could not build wheels for dlib, which is required to install pyproject.toml-based projects

2 问题分析

从错误日志中分析得出，在使用pip安装依赖包时，构建dlib依赖包报错。

3 问题解决

使用conda命令安装dlib，命令如下：

conda install -c conda-forge dlib

命令执行完成后，查看pip模块：

pip list                         
Package           Version
----------------- ------------
dlib              19.24.2     
numpy             1.24.4      
Pillow            10.1.0      
pip               23.3.1      
setuptools        68.2.2      
torch             1.9.0+cu111 
torchvision       0.10.0+cu111
typing_extensions 4.9.0       
wheel             0.41.2

4 conda环境介绍

Conda是一个开源的包管理器和环境管理系统，用于安装、运行和更新包和其依赖项。它是由Anaconda, Inc.（以前称为Continuum Analytics）创建，用于支持Python程序开发，但它也可以用来管理来自其他语言的包。Conda使得包管理和环境隔离变得简单，对于处理多个项目中的依赖关系和版本控制尤其有用。

Conda是一个强大的工具，对于管理复杂的Python项目和环境至关重要。它简化了包管理和环境设置，使得Python开发更加容易和高效。通过使用Conda，开发者可以确保他们的项目在不同机器和操作系统上都能以相同的方式运行，大大提高了项目的可移植性和可复现性。

4.1 Conda的核心功能

包管理：Conda作为包管理器，可以安装、更新和移除Python包。它通过Conda仓库，如Anaconda Cloud或Conda Forge，来获取包。
环境管理：Conda允许用户创建隔离的环境，以便于不同项目可以拥有不同的库和/或Python版本。这在处理不兼容的依赖项或不同项目的需求时非常有用。
跨平台：Conda支持Linux、OS X和Windows，并允许创建跨平台的Python环境。
开源：Conda是开源的，允许用户查看源代码并对其进行改进。

4.2 使用Conda的优势

解决依赖性问题：Conda可以自动解决包之间的依赖关系，简化了安装过程。
环境隔离：创建独立的环境可以避免包之间的版本冲突，使得项目更稳定。
易于使用：Conda的命令行界面简单直观，易于学习和使用。
广泛的包支持：Conda支持Python的许多流行库和应用程序。
社区支持：作为一个流行的工具，Conda拥有一个活跃的社区，用户可以从中找到支持和资源。

4.3 Conda环境的创建和管理

创建新环境：使用conda create命令创建一个新环境，可以指定Python版本和所需的包。
激活环境：使用conda activate命令来激活环境。
安装包：在激活的环境中使用conda install命令来安装新的包。
环境列表：使用conda env list来查看所有可用的Conda环境。
移除环境：使用conda env remove命令来移除不再需要的环境。

4.4 应用场景

数据科学和机器学习：Conda非常适合于数据科学和机器学习项目，这些项目通常需要多个库和框架。
软件开发：软件开发者使用Conda来管理项目依赖，确保一致的开发环境。
教学和学术研究：教师和研究人员使用Conda来创建具有特定库和工具的环境，用于教学和研究。

4.5 常用命令

Conda 是一个开源的包管理器和环境管理器，广泛用于管理Python环境和包。以下是一些常用的 Conda 命令：

安装 Conda 包:
- conda install [package-name]: 安装指定的包。
创建和管理环境:
- conda create --name [env-name]: 创建一个新的环境。
- conda activate [env-name]: 激活指定环境。
- conda deactivate: 退出当前环境。
- conda env list: 列出所有可用的环境。
管理包:
- conda list: 在当前环境中列出所有已安装的包。
- conda update [package-name]: 更新指定的包。
- conda remove [package-name]: 移除指定的包。
搜索包:
- conda search [package-name]: 搜索可用的包版本。
环境导出和导入:
- conda env export > environment.yml: 导出当前环境的配置到一个YAML文件。
- conda env create -f environment.yml: 使用YAML文件创建一个新环境。
更新 Conda:
- conda update conda: 更新 Conda 到最新版本。
查看 Conda 信息:
- conda info: 显示关于 Conda 的信息。