Windows 因为环境配置相对复杂,网络上有很多社区编译好的.whl直接安装包;而 macOS(尤其是搭载 Apple Silicon M系列芯片的最新系统)通常需要我们在本地编译安装。
在 Mac 上编译安装dlib其实非常简单,只要配齐基础的编译工具(如cmake),系统就能自动完成编译。以下是针对最新 macOS 系统的完整安装指南:
🛠️ 第一步:安装基础编译工具
在编译dlib之前,需要确保你的 Mac 拥有 C++ 编译环境和cmake工具。
安装 Xcode Command Line Tools(如果你还没有安装过): 打开终端(Terminal),运行以下命令:
xcode-select --install弹窗提示时点击“安装”即可。
安装 Homebrew(Mac 的包管理器,已安装请跳过):
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"使用 Homebrew 安装 cmake:
dlib强依赖cmake来进行构建。brew install cmake
🐍 第二步:在 Python 环境中安装 dlib
为了避免系统 Python 环境冲突,强烈建议你在虚拟环境(如venv或Conda)中进行操作。
方法 A:直接通过 pip 安装(最推荐)
在最新版本的pip中,直接运行安装命令,系统会自动下载源码并在本地调用cmake进行编译。
# 确保升级了 pip、setuptools 和 wheel pip install --upgrade pip setuptools wheel # 直接安装 dlib(这一步会自动进行本地编译,可能需要 2~5 分钟) pip install dlib💡M系列芯片加速提示:最新版的
dlib已经能较好地支持 Apple Silicon。在编译时,它会自动检测并利用 Mac 的硬件加速。
方法 B:从源码编译安装(若 pip 报错时使用)
如果pip install dlib报错,手动下载源码编译是最稳妥的方法:
克隆 dlib 官方仓库:
git clone https://github.com/davisking/dlib.git cd dlib创建并进入构建目录:
mkdir build cd build配置并编译:
cmake .. cmake --build .回到根目录并安装到 Python 环境中:
cd .. python setup.py install
✅ 第三步:验证安装
安装完成后,可以在终端进入 Python 交互模式验证是否成功:
import dlib print(dlib.__version__)如果成功输出了版本号(例如19.24.x),说明dlib已经完美躺在你的 Mac 里了!
⚠️ 常见坑点排查
报错:CMAKE_CXX_COMPILER 相关错误
CMAKE_CXX_COMPILER通常是因为 Xcode 命令行工具没有正确连接。可以尝试运行sudo xcode-select --switch /Library/Developer/CommandLineTools重置路径。权限问题如果你没有使用虚拟环境,使用
pip时可能会报权限错误。切记不要轻易使用sudo pip install,强烈建议用python -m venv venv起一个虚拟环境,或者加--user参数:pip install dlib --user。