要在 Python 3.12 中安装 `face_recognition` 库，需要注意该库依赖于一些底层的 C/C++ 库以及操作系统特定的支持工具。以下是详细的说明： ### 安装前准备 #### Windows 平台 在 Windows 上，`face_recognition` 需要先安装 Microsoft Visual C++ Build Tools 或者确保系统已经支持这些编译器环境[^1]。此外还需要安装 dlib 的二进制版本，因为它是 `face_recognition` 的核心依赖之一。 可以运行以下命令来安装必要的组件： ```bash pip install cmake pip install dlib ``` 如果遇到错误提示找不到预构建的轮子文件，则可能需要手动下载适合您系统的 dlib 轮子 (whl 文件)，可以从 [Unofficial Windows Binaries for Python Extension Packages](https://www.lfd.uci.edu/~gohlke/pythonlibs/#dlib) 下载并按照对应版本安装[^2]。 完成上述操作之后再继续执行下面这一步骤即可成功加载所需的模块。 ```bash pip install face_recognition ``` #### macOS 和 Linux 平台 对于 macOS 用户来说，推荐通过 Homebrew 来简化开发流程中的依赖管理过程；而对于大多数主流发行版下的 GNU/Linux 发行板而言，可以直接利用包管理系统获取所需软件包或者源码自行编译链接动态共享对象(.so). 具体做法如下所示: ##### 在macOS上: 更新homebrew,然后添加科学计算tap仓库. ```bash brew update && brew tap homebrew/science ``` 接着就可以正常地用pip来进行后续处理了: ```bash brew install cmake boost python3 pip3 install --upgrade pip setuptools wheel pip3 install dlib pip3 install face_recognition ``` ##### 对于基于Debian/Ubuntu系列Linux: 首先确认已启用 universe multiverse repository, ```bash sudo apt-get update sudo apt-get upgrade -y sudo apt-get dist-upgrade -y ``` 现在应该能够顺利安装下列项目了: ```bash sudo apt-get install build-essential cmake git libgtk2.0-dev pkg-config \ python3-pip python3-numpy python3-scipy cython3 ffmpeg libavcodec-extra \ v4l-utils imagemagick graphviz doxygen zlib1g-dev libjpeg-dev \ xvidcore libxvidcore-dev libswscale-dev libtbb2 libtbb-dev libdc1394-22-dev ``` 最后也是最重要的部分就是实际调用pip指令啦~ ```bash pip3 install dlib==19.24.2 # 特定稳定版本号可选 pip3 install face-recognition ``` ### 测试安装是否成功 无论在哪种平台上完成了以上全部步骤以后都可以尝试简单验证一下功能是否可用: ```python import face_recognition print(face_recognition.__version__) ``` 如果没有报错并且打印出了版本信息就代表一切OK! --- ###