背景
安装 ChromaDB 时报错,本质原因是依赖 numpy 1.26.4,如下图。

想要解决这个问题,有以下几个方案。
方案一:使用 Conda
Conda 的 chromadb 和 numpy 都是预编译好的,Windows 兼容性较好。
方案二:安装 Microsoft C++ 构建工具
如果经常需要安装科学计算库(如 pandas, scikit-learn, torch 等),建议安装编译环境。
步骤:
- 下载并安装 Microsoft C++ Build Tools 官网:https://visualstudio.microsoft.com/visual-cpp-build-tools/
- 安装时勾选:
- C++ build tools
- Windows 10/11 SDK
- CMake tools for Visual Studio(可选)
方案三:降级 numpy(临时 workaround)
使用旧版 numpy(如 1.23.x)。
由于 Conda 的大名,这里重点总结安装 Conda 的核心用法以及安装过程。
一、Anaconda vs Miniconda:核心区别
| 项目 | Anaconda | Miniconda |
|---|---|---|
| 大小 | ~1.5GB(含 150+ 科学计算包) | ~100MB(仅 Conda 核心 + Python) |
| 适用场景 | 想开箱即用(适合新手) | 仅安装你需要的包(避免冗余) |
| 安装包 | 完整发行版 | 仅 Conda 环境管理工具 |
| 推荐指数 | 仅适合不想手动安装包的用户 | 开发者首选 |
为什么选 Miniconda?
之前安装 ChromaDB 时卡在 numpy 编译问题,Miniconda 通过预编译包解决!它自带 Windows 的预编译二进制包,无需 C++ 编译器。
二、Windows 下 Miniconda 安装与配置
步骤 1:下载 Miniconda
- 官网地址:https://docs.conda.io/en/latest/miniconda.html
- 选择:
Miniconda3 Windows 64-bit(Python 3.12 版本,当前主流)。不要选 Anaconda!选 Miniconda。


