CMake安装路径选择及pip安装dlib报错的问题咨询

我之前在装dlib的时候也踩过这个坑！别慌，咱们一步步把CMake的问题搞定：

先搞懂错误原因 #

你碰到的 RuntimeError: CMake must be installed to build the following extensions: dlib，本质是因为pip编译dlib的时候需要调用CMake工具，但系统找不到它的可执行文件——要么是CMake没安装到位，要么是它的路径没加到系统环境变量里。

不同系统的CMake正确安装&配置方法 #

Windows系统 #

• 如果你下载的是压缩包（zip格式）：
  • 解压后建议放到C:\Program Files\CMake这个标准的系统程序目录，方便后续管理和查找。
  • 关键步骤：找到解压文件夹里的bin目录（比如C:\Program Files\CMake\bin），把这个路径添加到系统环境变量的PATH中。
  • 验证：一定要打开新的命令提示符（旧窗口的环境变量不会更新），输入 cmake --version，能显示CMake的版本号就说明配置成功了。
• 更省心的方式：直接下载CMake的官方安装程序（.msi格式），安装过程中勾选「Add CMake to the system PATH for all users」，系统会自动完成环境变量配置，不用手动操作。

macOS系统 #

• 首推用Homebrew安装：终端里执行 brew install cmake 即可，它会自动把CMake放到/usr/local/bin（Apple Silicon机型是/opt/homebrew/bin），这个路径默认就在系统的PATH里，无需额外配置。
• 如果是手动下载的压缩包：
  • 解压后建议放到/usr/local/cmake目录（这是macOS下第三方工具的常规放置位置）。
  • 打开终端，编辑你的shell配置文件（比如~/.zshrc或者~/.bash_profile），添加一行：export PATH="/usr/local/cmake/bin:$PATH"。
  • 执行 source ~/.zshrc（对应你使用的配置文件）让更改生效。
• 验证：终端输入 cmake --version，能显示版本信息就没问题。

Linux系统（以Ubuntu/Debian为例） #

• 最简单的方式：用系统包管理器安装，终端执行 sudo apt-get update && sudo apt-get install cmake，它会自动把CMake放到/usr/bin，这个路径默认在系统PATH中，直接就能使用。
• 手动安装压缩包的话：
  • 解压后放到/opt/cmake目录（Linux下第三方程序的标准放置路径）。
  • 编辑~/.bashrc文件，添加一行：export PATH="/opt/cmake/bin:$PATH"，然后执行 source ~/.bashrc 让配置生效。
• 验证：终端输入 cmake --version 确认配置成功。

最后一步：重新安装dlib #

等CMake配置完成后，打开新的终端/命令提示符，重新运行 pip install dlib，应该就能正常编译安装了。如果还是遇到问题，可以先升级pip试试：pip install --upgrade pip，或者尝试安装社区维护的预编译dlib包：pip install dlib-bin（不过官方更推荐自行编译的版本）。

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