zvec 是什么?

Zvec 是 Alibaba 开源的进程内向量数据库,以本地库形式嵌入应用,无需单独启动服务。它支持稠密与稀疏向量、全文检索、混合查询、标量过滤、多种内存/磁盘索引以及写前日志。

⭐ 14,781 Stars 🍴 918 Forks C++ Apache-2.0 作者: alibaba
来源:github.com/alibaba/zvec/blob/main/README.md;https://zvec.org/en/docs/… 查看 GitHub 仓库 → 📘 使用教程 →

为什么值得关注

保留它的依据是官方在 2026-08-24 发布 v0.7.0,并新增 zvec-grep、DiskANN 平台与 I/O 支持、新索引/量化器、DocIterator 和 N-gram 全文检索。

来源:github.com/alibaba/zvec/releases/tag/v0.7.0

核心功能

进程内持久化检索

应用直接打开本地 collection;WAL 提供持久性,不需要另起向量数据库服务。

来源:github.com/alibaba/zvec/blob/main/README.md
混合检索

同一查询可以组合稠密向量、稀疏向量、全文检索和结构化过滤,并提供 HNSW、DiskANN、IVF 等索引路线。

来源:github.com/alibaba/zvec/blob/main/README.md;https://zvec.org/en/docs/…
多语言 SDK

官方提供 Python、Node.js、Go、Rust 和 Dart/Flutter 入口,v0.7.0 扩展了预编译 SDK 平台。

来源:github.com/alibaba/zvec/blob/main/README.md;https://github.com/alibab…

技术架构

Zvec 的 C++ 引擎与语言绑定运行在宿主应用进程中。collection 由 schema 定义向量和字段,数据与索引写入指定本地路径;应用插入 Doc,再用 Query 指定字段、查询向量和 top-k。多个进程可读同一 collection,但写入由单进程独占。

来源:github.com/alibaba/zvec/blob/main/README.md;https://zvec.org/en/docs/…

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) 64 位 Python 3.10–3.14(Python wheel)64 位 Python 3… 宿主应用自己提供 embedding宿主应用自己提供… 本地持久化目录 进程内持久化检索 混合检索 多语言 SDK zvec 项目本体 核心功能 关键依赖

技术栈

语言C++ 核心;Python、Node.js、Go、Rust、Dart/Flutter SDK框架进程内 collection、WAL、HNSW/DiskANN/IVF、全文与稀疏索引
64 位 Python 3.10–3.14(Python wheel)宿主应用自己提供 embedding本地持久化目录
Linux x86_64/ARM64(glibc/musl)、macOS ARM64/x86_64、Windows x86_64
来源:github.com/alibaba/zvec/blob/main/README.md;https://github.com/alibab…

快速上手

为项目建立 64 位 Python 3.10–3.14 虚拟环境并固定 zvec==0.7.0。先用四维测试向量定义一个临时 collection schema,create_and_open 到测试目录,插入两条带固定 id 的 Doc,再用同维度 Query 检查 top-k 顺序。确认数据目录、备份和单写者规则后,再接入真实 embedding;Zvec 不替你生成向量。
来源:github.com/alibaba/zvec/blob/main/README.md;https://github.com/alibab…

使用场景

适合桌面工具、CLI、Notebook、单机 RAG、Agent 记忆和边缘应用,把向量检索直接嵌进进程。需要多租户权限、网络 API、独立扩缩容或多写者协调时,应在应用层补服务边界,或选择原生服务型数据库。

来源:github.com/alibaba/zvec/blob/main/README.md;https://zvec.org/en/docs/…

优势与局限

优势

  • 无需部署独立服务,接入路径短
  • 同时支持向量、全文和结构化过滤
  • WAL 与磁盘索引覆盖持久化和较大数据集
  • 多个官方语言 SDK 和预编译平台

局限

  • 写入是单进程独占,不适合多个写者直接共享同一 collection
  • 库本身不提供网络认证、多租户或 API 网关
  • embedding 的生成、版本与维度一致性由应用管理
  • 平台和 Python 必须匹配官方 64 位 wheel 范围
  • 官方性能数据依赖其测试方法和硬件,本文未复测
  • 本轮没有安装 wheel 或执行查询
来源:github.com/alibaba/zvec/blob/main/README.md;https://zvec.org/en/docs/…

最新版本

最新正式版为 v0.7.0,发布于 2026-08-24。主要变化包括本地搜索 CLI zvec-grep、ReMe 后端集成、DiskANN 的 ARM64 与 io_uring 支持、IVF-RaBitQ/PQ-INT8、更多预编译 SDK、DocIterator 和 N-gram 全文 tokenizer。

来源:github.com/alibaba/zvec/releases/tag/v0.7.0;https://github.com/alibab…

实测与证据

status: official_docs_checked_not_run  |  checked_at: 2026-09-23  |  environment: 核对官方 README/中文 README、pyproject.toml、Quickstart、Benchmarks 与 v0.7.0 Release  |  limitations: 未安装 zvec、未创建 collection、未执行插入/查询、未测崩溃恢复、并发、索引构建、召回率或官方性能数字  |  observed_output: README 标注 v0.7.0 发布于 2026-08-24;Python 安装指导要求 64 位 Python 3.10–3.14,并列出 Linux、macOS、Windows 支持;写入为单进程独占

来源:github.com/alibaba/zvec/releases/tag/v0.7.0;https://github.com/alibab…

同类项目对比

LanceDB 官方项目同样提供本地开源检索库,建立在 Lance 列式格式上,突出多模态数据、SQL、自动版本管理、Python/Node/Rust/REST 和云/企业路径。Zvec 更强调直接嵌入进程、稠密/稀疏/全文混合检索、多种 ANN 索引及本地 WAL。需要多模态列式数据和版本管理可评估 LanceDB;需要轻量本地 collection 与多类索引组合,可评估 Zvec。

来源:github.com/lancedb/lancedb;https://github.com/alibaba/zvec/blob/main/…

总结评价

Zvec 适合希望把混合检索放进单机进程、又不想维护独立数据库服务的项目。先在临时目录用固定小向量验证 schema、写入、查询和重开,再测试自己的数据规模、召回率、索引时间、磁盘占用和单写者安排。

来源:github.com/alibaba/zvec/blob/main/README.md;https://zvec.org/en/docs/…

常见问题

Zvec v0.7.0 是什么时候发布的?

官方 README 与 Release 记录的日期是 2026-08-24;该版加入 zvec-grep、更多 DiskANN 平台支持、新索引与量化器、DocIterator 和 N-gram tokenizer。

使用 Zvec 需要先启动数据库服务器吗?

不需要。Zvec 是进程内数据库,应用直接打开本地 collection 路径;网络 API、认证和多租户需要应用自行提供。

多个进程可以同时写一个 Zvec collection 吗?

不可以。官方 README 说明多个进程可以并发读取,但写入为单进程独占,需要在应用层安排单写者。

Zvec 会自动把文本转换成 embedding 吗?

README 的基础接口接收用户提供的向量。应用需要自行选择 embedding 模型,并保持写入与查询的模型、维度和归一化方式一致。

资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新,请以所列来源和项目当前版本为准。 资料核对时间: 2026-09-23 13:55.

参考材料:README、GitHub API、依赖文件