# ChromaDB教程 **Repository Path**: hxstrive/tutorial_chromadb ## Basic Information - **Project Name**: ChromaDB教程 - **Description**: ChromaDB 教程源码 - **Primary Language**: Python - **License**: Not specified - **Default Branch**: master - **Homepage**: https://www.hxstrive.com/subject/chroma.htm - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-16 - **Last Updated**: 2026-11-16 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # ChromaDB 教程 该教程是我照着 Chroma 官方文档(docs.trychroma.com)加上自己平时搭检索服务时踩过的坑整理的,代码全部在 `chromadb 1.5.9` 上跑通过。 Chroma 这两年变化挺大:1.0.0 之后服务端前端用 Rust 重写了,鉴权那套老配置(`CHROMA_SERVER_AUTHN_PROVIDER` 之类)不再生效,客户端也明确了 `EphemeralClient` / `PersistentClient` / `HttpClient` / `CloudClient` 几种形态。网上很多教程还停在 0.4/0.5 时代,照着抄经常报错,所以这份笔记统一按 **1.x** 写,遇到版本相关的坑我会单独标出来。 教程访问地址: https://www.hxstrive.com/subject/chroma.htm ## venv 基础(官方内置,优先用) ### 1. 创建虚拟环境 ``` # 在当前目录创建名为 .venv 的虚拟环境文件夹 python -m venv .venv ``` > > 会生成文件夹 `.venv/`,里面是独立 Python 解释器 + 独立 pip。 ### 2. 激活虚拟环境 #### Windows(CMD) ``` .venv\Scripts\activate.bat ``` #### Windows(PowerShell) ``` .venv\Scripts\Activate.ps1 ``` > > PowerShell 报错:执行策略限制,可以管理员执行一次: > `Set-ExecutionPolicy RemoteSigned` #### Mac / Linux ``` source .venv/bin/activate ``` 激活成功:命令行前缀出现 `(.venv)`,此时`pip install`只会装到这个虚拟环境,不影响全局。 ### 3. 退出虚拟环境 ``` deactivate ``` ### 4. 导出 / 导入依赖(项目协作必备) ``` # 导出当前环境所有包版本到 requirements.txt pip freeze > requirements.txt # 新机器新建虚拟环境后,一键安装全部依赖 pip install -r requirements.txt ``` ### 5. 删除虚拟环境 直接删除整个 `.venv` 文件夹即可,不需要特殊命令。 ## 环境 - Python 3.9+(我这边是 3.13) - `pip install chromadb`(写这篇时是 1.5.9) > 注意:其他第三方库,会在使用的时候介绍安装方法。 ## 代码约定 笔记里的示例默认 `import chromadb`,为了省事大量用 `EphemeralClient()`(内存模式,进程一关数据就没了)。你要是想让数据留下来,把这一行换成 `PersistentClient(path="./chroma_data")` 就行,其余代码不用动。 凡是我在本机跑出过真实输出的地方,都会把输出贴在代码下面,方便你对照。 ## 参考 - 官方文档: - GitHub: - 集成列表: ## 最后 笔记里凡是写 “注意”、“踩坑” 的地方,基本都是我真金白银换来的教训,别跳过。