llama-cpp-python安装失败求助：CMake构建出错及Python库未找到

问题重现 #

执行命令pip install llama-cpp-python时触发CMake构建失败，关键错误日志片段：

pip install llama-cpp-python
Collecting llama-cpp-python
  Using cached llama_cpp_python-0.2.20.tar.gz (8.7 MB)
...
2023-12-01 16:56:53,129 - scikit_build_core - WARNING - Can't find a Python library, got libdir=None, ldlibrary=None, multiarch=None, masd=None
...
*** CMake build failed
ERROR: Failed building wheel for llama-cpp-python
Failed to build llama-cpp-python
ERROR: Could not build wheels for llama-cpp-python, which is required to install pyproject.toml-based projects

可行解决方案 #

方案1：直接安装预编译轮子（最简便） #

跳过本地编译，直接使用官方预编译的二进制包：

pip install llama-cpp-python --only-binary :all:

如果需要指定目标版本（比如你尝试的0.2.20）：

pip install llama-cpp-python==0.2.20 --only-binary :all:

方案2：升级编译工具链 #

你的环境使用Visual Studio 2017 Build Tools，版本较旧可能存在兼容性问题：

• 卸载Visual Studio 2017 Build Tools
• 下载安装Visual Studio 2022 Build Tools，安装时务必勾选「C++构建工具」组件，同时确保安装最新的Windows SDK
• 安装完成后，打开「x64 Native Tools Command Prompt for VS 2022」，激活你的Python虚拟环境，再重新执行pip install llama-cpp-python

方案3：指定Python库路径修复CMake警告 #

针对日志中「找不到Python库」的警告，手动指定Python库路径：

1. 找到你的虚拟环境下的libs文件夹，比如你的路径是C:\mydata\installations\ai\envs\privategpt\libs，里面存在pythonXX.lib（XX为你的Python版本号，比如3.10对应python310.lib）
2. 在命令行执行：

set CMAKE_ARGS="-DPYTHON_LIBRARY=C:\mydata\installations\ai\envs\privategpt\libs\python310.lib"
set FORCE_CMAKE=1
pip install llama-cpp-python

方案4：启用CPU优化（适配你的硬件） #

从日志看你的CPU支持AVX2和FMA，可以在安装时启用对应优化，提升后续运行性能：

set CMAKE_ARGS="-DLLAMA_AVX2=ON -DLLAMA_FMA=ON"
pip install llama-cpp-python

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