小泉水前几篇用LangChain写向量库的时候，我一直在等一个“回看数据”的入口。写进去的文档到底长什么样、metadata有没有存对、哪些集合占了多少数据，这些信息不能每次靠猜。这篇集中把两件高频又容易绕弯的事讲透：从ChromaDB本地库获取已有记录，以及删除一张“表”——也就是Collection。
这两件事在LangChain封装里都没有正面暴露，但底层无非是客户端连接、集合读写那点事。只要理解了ChromaDB在本地持久化时的目录结构和数据模型，再用对chromadb自身的API，读和删都能很顺手。文章里所有代码我都跑过，版本基于chromadb 0.5.x和langchain-chroma 0.1.x，不同版本可能存在细微差异，遇到问题我会在每个坑里补充说明。
1. 先搞清楚本地库的三层结构，才不会把“记录”“集合”“数据库”搞混
1.1 一个持久化目录，就是一个小型数据库
ChromaDB本地模式的核心是一个文件夹，官方叫persist_directory。这个文件夹里有一个chroma.sqlite3文件，所有集合、向量、文档、元数据都落在里面。你可以把它理解成一整个MySQL实例的数据目录，而不是一张表。
平时启动时你写的代码是：
python复制import chromadb
client = chromadb.PersistentClient(path="./chroma_data")
这个client就是数据库级连接。它下面可以有多个Collection，Collection就是标题里说的“表”。每个Collection由三部分组成：
- id：内部唯一标识。
- embedding：向量数据。
- document + metadata：原始文本和附加属性。
所以“获取本地库记录”本质上就是：拿到某个持久化目录下的某个Collection，然后调用get()去读它。“删除表”则是调用client.delete_collection("集合名")，把整个Collection连同里面的向量记录一起删掉。
1.2 LangChain的Chroma封装到底管了什么
LangChain里Chroma类的主要用途是“把文档向量化后写入集合，并对外提供相似度检索接口”。它做了三件事：初始化embedding、连接持久化目录、封装add/similarity_search/delete等操作。但它没有把“列出所有collection”“获取某collection全部记录”“删除collection”这类运维操作暴露出来。
这导致很多人卡在同一个地方：用Chroma(persist_directory=...)创建了对象，却不知道怎么遍历已有数据。其实LangChain对象内部藏着两个关键属性：
vectorstore._client：chromadb的PersistentClient对象。vectorstore._collection：当前绑定的Collection对象。
这两个属性虽然带下划线，属于“私有属性”，但社区普遍在这样用。如果你不喜欢依赖私有属性，也可以绕过LangChain，直接用chromadb.PersistentClient去连同一个目录，效果完全一样。我在后面的示例里会两种都写。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 环境准备：版本搭配和“backend init failed”的真实原因
2.1 一套能省心的安装组合
我建议直接装这几个包：
bash复制pip install chromadb langchain langchain-community langchain-chroma langchain-openai
其中langchain-chroma是LangChain官方拆出来的Chroma集成包，早期语言里大家会写from langchain_community.vectorstores import Chroma。如果你的LangChain版本比较新，这样导入依然能用，但底层会自动依赖langchain_chroma。为了少踩导入冲突，我基本都是：
python复制from langchain_chroma import Chroma
from langchain_openai import OpenAIEmbeddings
如果你不用OpenAI向量模型，也可以用HuggingFaceEmbeddings或任意本地embedding函数。本文后面示例里我用OpenAIEmbeddings占位，实际替换成你环境的embedding即可。
2.2 chromadb启动时报“backend init failed, falling back”的原因和解决
很多人在连接ChromaDB时会遇到类似这样一段日志：
code复制chromadb: error setting up onnxruntime backend, falling back to default embedding function.
这句话看着吓人，其实不一定会让程序崩溃。它说的是ChromaDB尝试加