PyCharm虚拟环境安装langchain-chroma/hnswlib编译错误求助

问题根源 #

hnswlib是依赖C扩展的库，编译它需要Microsoft Visual C 14.0或更高版本的构建工具，你的环境缺少该组件导致编译失败。

解决步骤 #

1. 安装Visual C++构建工具 #

• 下载并启动Visual Studio Installer，选择「Desktop development with C++」工作负载，必须勾选以下核心组件：
  • MSVC v143 - VS 2022 C++ x64/x86 build tools（或对应版本的v14+编译工具集）
  • Windows 10/11 SDK（根据你的操作系统版本选择）
  • C++ CMake tools for Windows
• 完成安装后重启电脑，确保环境变量生效。

2. 重新在虚拟环境中安装依赖 #

• 在PyCharm中打开项目对应的终端，激活虚拟环境（执行虚拟环境目录下的Scripts/activate命令）
• 先更新pip到最新版本：

  pip install --upgrade pip
  

• 重新安装langchain_chroma：

  pip install langchain_chroma
  

3. 备选方案：使用预编译wheel包 #

如果不想安装构建工具，可以直接下载匹配你Python版本和系统架构的hnswlib预编译wheel文件，手动安装：

• 找到对应版本（如Python 3.10、win_amd64架构）的wheel包
• 执行以下命令安装（替换为你的wheel文件路径）：

  pip install ./hnswlib-0.8.0-cp310-cp310-win_amd64.whl
  

• 安装完成后再执行pip install langchain_chroma即可。

验证安装成功 #

打开Python终端执行以下代码，无报错则说明安装成功：

import hnswlib
from langchain_chroma import Chroma
print("依赖安装成功")

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