Windows环境Jupyter Notebook安装dlib报错：No module named 'cmake'

问题推测 #

• 环境变量未生效：手动配置CMake环境变量后，Jupyter Notebook进程未加载最新环境变量，导致Python无法识别CMake路径
• 虚拟环境隔离：若使用虚拟环境，CMake可能仅安装在全局环境，Jupyter使用的虚拟环境未关联到CMake
• 编译依赖不匹配：直接用pip install dlib需本地编译，CMake版本、路径配置不符合dlib编译要求，导致调用失败
• CMake版本兼容问题：安装的CMake版本与dlib所需版本不匹配，引发识别错误

解决方案 #

• 验证并修复环境变量

  1. 关闭所有Jupyter、CMD窗口，重新打开CMD执行cmake --version，确认能正常输出版本信息
  2. 在Jupyter中执行以下代码，检查系统路径是否包含CMake安装目录（通常为C:\Program Files\CMake\bin）：

     import os
     print(os.environ['PATH'])
     

  3. 若路径中无CMake目录，手动添加后重启电脑，再重新尝试安装

• 虚拟环境适配处理

  1. 若使用conda虚拟环境，先激活目标环境：

     conda activate your_env_name
     

  2. 在激活的环境内安装cmake：

     conda install cmake
     

  3. 继续在该环境内安装dlib：

     pip install dlib
     

• 使用预编译包跳过编译

  1. 下载与你的Python版本、系统架构匹配的dlib wheel包（如dlib-19.24.0-cp310-cp310-win_amd64.whl对应Python3.10 64位系统）
  2. 执行本地安装命令，替换为实际下载的文件名：

     pip install dlib-19.24.0-cp310-cp310-win_amd64.whl
     

• 重新安装CMake

  1. 卸载现有CMake，从官方渠道下载最新稳定版Windows安装程序
  2. 安装时勾选"Add CMake to the system PATH for all users"选项
  3. 安装完成后重启电脑，在CMD和Jupyter中分别验证cmake --version是否正常输出

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