Windows 因为环境配置相对复杂网络上有很多社区编译好的.whl直接安装包而 macOS尤其是搭载 Apple Silicon M系列芯片的最新系统通常需要我们在本地编译安装。在 Mac 上编译安装dlib其实非常简单只要配齐基础的编译工具如cmake系统就能自动完成编译。以下是针对最新 macOS 系统的完整安装指南️ 第一步安装基础编译工具在编译dlib之前需要确保你的 Mac 拥有 C 编译环境和cmake工具。安装 Xcode Command Line Tools如果你还没有安装过 打开终端Terminal运行以下命令xcode-select --install弹窗提示时点击“安装”即可。安装 HomebrewMac 的包管理器已安装请跳过/bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)使用 Homebrew 安装 cmakedlib强依赖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 dlibM系列芯片加速提示最新版的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。
在macos python中安装dlib
Windows 因为环境配置相对复杂网络上有很多社区编译好的.whl直接安装包而 macOS尤其是搭载 Apple Silicon M系列芯片的最新系统通常需要我们在本地编译安装。在 Mac 上编译安装dlib其实非常简单只要配齐基础的编译工具如cmake系统就能自动完成编译。以下是针对最新 macOS 系统的完整安装指南️ 第一步安装基础编译工具在编译dlib之前需要确保你的 Mac 拥有 C 编译环境和cmake工具。安装 Xcode Command Line Tools如果你还没有安装过 打开终端Terminal运行以下命令xcode-select --install弹窗提示时点击“安装”即可。安装 HomebrewMac 的包管理器已安装请跳过/bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)使用 Homebrew 安装 cmakedlib强依赖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 dlibM系列芯片加速提示最新版的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。