pip安装dlib库失败求助：CMake执行返回非零退出状态1

针对你提供的pip安装dlib时出现的subprocess.CalledProcessError错误（cmake命令返回非零状态1），常见原因如下：

• CMake未配置到位：系统中未安装CMake，或者安装后未将其可执行文件路径添加到系统环境变量PATH中，导致pip调用cmake命令时无法找到对应程序。
• Python版本适配问题：你使用的是Python 3.12，部分旧版本的dlib尚未适配该较新的Python版本，编译过程中会出现兼容性报错。
• 缺少C++编译工具链：Windows环境下编译dlib需要Visual Studio Build Tools（需勾选"C++桌面开发"组件，包含MSVC编译器、Windows SDK等），若未安装或组件不全，cmake无法完成编译。
• 路径含特殊字符干扰：你的用户目录名称MUHAMMAD USMAN包含空格，部分编译工具对带空格的路径解析存在问题，导致cmake处理临时文件路径时出错。

附你遇到的错误信息：

raise CalledProcessError(retcode, cmd)
subprocess.CalledProcessError: Command '['cmake', 'C:\Users\MUHAMMAD USMAN\AppData\Local\Temp\pip-install-8lhbgb6j\dlib_38bf52dcd86d47d4bfa0708f58a51173\tools\python', '-DCMAKE_LIBRARY_OUTPUT_DIRECTORY=C:\Users\MUHAMMAD USMAN\AppData\Local\Temp\pip-install-8lhbgb6j\dlib_38bf52dcd86d47d4bfa0708f58a51173\build\lib.win-amd64-cpython-312', '-DPYTHON_EXECUTABLE=C:\Users\MUHAMMAD USMAN\AppData\Local\Programs\Python\Python312\python.exe', '-DCMAKE_LIBRARY_OUTPUT_DIRECTORY_RELEASE=C:\Users\MUHAMMAD USMAN\AppData\Local\Temp\pip-install-8lhbgb6j\dlib_38bf52dcd86d47d4bfa0708f58a51173\build\lib.win-amd64-cpython-312', '-A', 'x64']' returned non-zero exit status 1.
[end of output]
note: This error originates from a subprocess, and is likely not not a problem with pip.
ERROR: Failed building wheel for dlib
Failed to build dlib
ERROR: Could not build wheels for dlib, which is required to install pyproject.toml-based projects

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