Windows环境下安装dlib失败求助：已安装cmake仍报错

错误含义解释 #

你遇到的subprocess.CalledProcessError错误，本质是CMake无法完成dlib Python扩展的编译配置流程，返回错误码1导致安装中断。结合你的环境（Python2.7 32位Windows），主要原因大概率是：

• 缺少Windows编译C/C++扩展必需的工具链
• pip安装的CMake存在版本兼容性或环境变量配置问题
• Python2.7作为已停止维护的老旧版本，对新版dlib的支持有限

一步步解决方法 #

1. 优先使用预编译包（最适合新手）

源码编译需要处理大量依赖问题，直接用现成的预编译wheel包能避开大部分坑：

• 先清理之前安装失败的残留：

  pip uninstall -y dlib cmake
  

• 找到匹配Python2.7 32位版本的dlib wheel文件（比如dlib-19.8.1是最后几个支持Python2.7的版本之一，对应的wheel文件名类似dlib-19.8.1-cp27-none-win32.whl）
• 执行安装命令：

  pip install dlib-19.8.1-cp27-none-win32.whl
  

2. 补全编译工具链（如果坚持源码编译）

Windows下编译dlib这类C库需要对应的Visual C编译工具：

• 对于Python2.7，必须安装Microsoft Visual C++ 9.0（可以直接下载单独的「Microsoft Visual C++ Compiler for Python 2.7」，无需安装完整Visual Studio）
• 安装完成后重启命令提示符，确保工具链生效

3. 修复CMake环境

pip安装的CMake可能存在路径或版本问题：

• 卸载pip安装的cmake：pip uninstall -y cmake
• 从CMake官方下载Windows 32位安装包，安装时勾选「Add CMake to the system PATH for all users」选项
• 重启命令提示符，执行cmake --version确认能正常输出版本号，再重新尝试安装：

  pip install dlib==19.8.1
  

4. 推荐升级Python版本（长期解决方案）

Python2.7已停止官方维护超过4年，包括dlib在内的主流库都不再更新对它的支持。如果项目允许，建议升级到Python3.6+的64位版本：

• 64位Python兼容性更好，预编译wheel包资源更丰富
• 新版Python生态支持更完善，后续安装其他库也会少很多麻烦

附：你遇到的完整错误日志 #

-- Configuring incomplete, errors occurred! See also "C:/Users/Jehad/AppData/Local/Temp/pip-build-uz9hgn/dlib/build/temp.win32-2.7/Release/CMakeFiles/CMakeOutput.log". See also "C:/Users/Jehad/AppData/Local/Temp/pip-build-uz9hgn/dlib/build/temp.win32-2.7/Release/CMakeFiles/CMakeError.log".
Traceback (most recent call last):
File "", line 1, in
File "c:\users\jehad\appdata\local\temp\pip-build-uz9hgn\dlib\setup.py", line 238, in
'Topic :: Software Development',
File "c:\python27\lib\distutils\core.py", line 151, in setup
dist.run_commands()
File "c:\python27\lib\distutils\dist.py", line 953, in run_commands
self.run_command(cmd)
File "c:\python27\lib\distutils\dist.py", line 972, in run_command
cmd_obj.run()
File "c:\python27\lib\site-packages\setuptools\command\install.py", line 61, in run
return orig.install.run(self)
File "c:\python27\lib\distutils\command\install.py", line 563, in run
self.run_command('build')
File "c:\python27\lib\distutils\cmd.py", line 326, in run_command
self.distribution.run_command(command)
File "c:\python27\lib\distutils\dist.py", line 972, in run_command
cmd_obj.run()
File "c:\python27\lib\distutils\command\build.py", line 127, in run
self.run_command(cmd_name)
File "c:\python27\lib\distutils\cmd.py", line 326, in run_command
self.distribution.run_command(command)
File "c:\python27\lib\distutils\dist.py", line 972, in run_command
cmd_obj.run()
File "c:\users\jehad\appdata\local\temp\pip-build-uz9hgn\dlib\setup.py", line 119, in run
self.build_extension(ext)
File "c:\users\jehad\appdata\local\temp\pip-build-uz9hgn\dlib\setup.py", line 153, in build_extension
subprocess.check_call(cmake_setup, cwd=build_folder)
File "c:\python27\lib\subprocess.py", line 186, in check_call
raise CalledProcessError(retcode, cmd)
subprocess.CalledProcessError: Command '["cmake", "c:\users\jehad\appdata\local\temp\pip-build-uz9hgn\dlib\tools\python", "-DCMAKE_LIBRARY_OUTPUT_DIRECTORY=c:\users\jehad\appdata\local\temp\pip-build-uz9hgn\dlib\build\lib.win32-2.7", "-DPYTHON_EXECUTABLE=c:\python27\python.exe", "-DCMAKE_LIBRARY_OUTPUT_DIRECTORY_RELEASE=c:\users\jehad\appdata\local\temp\pip-build-uz9hgn\dlib\build\lib.win32-2.7"]' returned non-zero exit status 1 #

Command "c:\python27\python.exe -u -c "import setuptools, tokenize;file='c:\users\jehad\appdata\local\temp\pip-build-uz9hgn\dlib\setup.py';f=getattr(tokenize, 'open', open)(file);code=f.read().replace('\r\n', '\n');f.close();exec(compile(code, file, 'exec'))" install --record c:\users\jehad\appdata\local\temp\pip-xb26oy-record\install-record.txt --single-version-externally-managed --compile" failed with error code 1 in c:\users\jehad\appdata\local\temp\pip-build-uz9hgn\dlib\

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