15 分钟跑通 pgvectorWindows 下从源码到首次向量查询的完整安装实操【免费下载链接】pgvectorOpen-source vector similarity search for Postgres项目地址: https://gitcode.com/GitHub_Trending/pg/pgvectorpgvector 是 Postgres 的开源向量相似度搜索扩展装上之后 embedding 向量直接存在普通表里建个 HNSW 索引一条 SQL 就能跑相似性查询不用另外维护一套向量数据库。本文覆盖 pgvector 在 Windows 10/11 上的完整流程前置依赖核对、源码编译、装完验证、高频报错处理从敲第一条命令到返回版本号15 分钟内跑通。开工前pgvector Windows 安装需要核对的 4 样东西缺任何一样后面都会卡在编译或安装环节组件要求缺了会卡在哪PostgreSQL14推荐 1617 请用 17.317.0–17.2 有个已知 bug链接阶段直接报错Visual Studio 2019安装时勾选C 桌面开发工作负载没有 MSVC 工具链nmake 直接失败Windows SDK 10.0.19041随 VS 一起装别漏找不到 crtdefs.h 等系统头文件Git任意较新版本拉不下来源码四步完成 pgvector 安装从拉源码到首次查询第 1 步拉源码。源码只有几十个文件放临时目录就行装完不用管它。cd %TEMP% git clone --branch v0.8.6 https://gitcode.com/GitHub_Trending/pg/pgvector cd pgvector预期看到 pgvector 目录里面有 Makefile.win、src/ 和 sql/ 三个关键项。第 2 步把 PGROOT 指向 PostgreSQL 安装目录。Makefile.win 靠这个变量定位头文件、库文件和安装目标没设的话 nmake 当场报错。同一会话里顺手把 bin 加进 PATHset PGROOTC:\Program Files\PostgreSQL\16 set PATH%PGROOT%\bin;%PATH%预期没有任何报错输出后续命令可以直接调用 PG 的可执行文件。第 3 步编译并安装。先打开 VS 的 x64 Native Tools Command Prompt——只有这个 shell 带全 SDK 环境换别的终端必挂。然后敲两行nmake /F Makefile.win nmake /F Makefile.win install第一条编出 vector.dll第二条把 DLL、.control 和全部 .sql 文件拷进 PGROOT 对应目录。第二条跑完编译安装就闭环了。第 4 步启用扩展验证。装没装好连上数据库跑两句才算数CREATE EXTENSION vector; SELECT vector_version();预期第二条返回 0.8.6 版本号。想多跑一轮完整回归命令行再补一行test/sql 下的全部用例——类型转换、索引构建、距离函数——会一遍过完nmake /F Makefile.win installcheck预期每一行都是 ok最后 all tests pass。pgvector 编译报错对照表终端变红先查这里 ⚠️九成翻车都在这四种里按现象对号入座现象原因解法打不开postgres.hPGROOT 没设或指错目录当前会话重新 set别指望新开的终端error C2196: case value 4 already used没在 VS 原生环境里编译换 x64 Native Tools Command Prompt先nmake /F Makefile.win clean再重编unresolved external symbol float_to_shortest_decimal_bufnPostgreSQL 17.0–17.2 已知问题把 PG 升到 17.3 及以上Access is denied安装目录没有写权限用管理员身份重跑安装那一步pgvector 装完之后类型、算子和调优参数速查四个向量类型按需选类型上限适用vector2000 维默认选择halfvec4000 维省一半内存bit64000 维二值量化sparsevec1000 个非零元素高维稀疏场景四种距离算子都能建索引加速-L2 欧氏、#内积取负、余弦、L1。索引就两类HNSW 查询快、IVFFlat 构建快多数场景选 HNSW。调召回时 HNSW 调ef_search、IVFFlat 调probes调高换精度、调低换速度建索引记得数据灌完再建大表顺手调大maintenance_work_mem。更多细节看仓库自带的 README.mdHNSW 核心实现在 src/ 目录。一句话收尾pgvector 在 Windows 上没有玄学核对依赖、四步装完、两句验证向量搜索就在你手边。下一步复制这三句把第一条查询跑起来CREATE TABLE items (id bigserial PRIMARY KEY, embedding vector(3)); CREATE INDEX ON items USING hnsw (embedding vector_l2_ops); SELECT * FROM items ORDER BY embedding - [1,2,3] LIMIT 5;【免费下载链接】pgvectorOpen-source vector similarity search for Postgres项目地址: https://gitcode.com/GitHub_Trending/pg/pgvector创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
