企业官网建设流程全解析

pgvector Windows部署：源码编译装好PostgreSQL向量扩展，20分钟跑通HNSW相似查询

【免费下载链接】pgvectorOpen-source vector similarity search for Postgres项目地址: https://gitcode.com/GitHub_Trending/pg/pgvector

pgvector 是 PostgreSQL 的向量搜索扩展，装好后 embedding 直接存在普通表里，不用另起一套向量库。本文在 Windows 10/11 上完成 pgvector 安装与编译，装好扩展、建出 HNSW 索引，跑通第一条相似性查询。

先看装好之后的样子

装好之后的样子很具体：一张普通表存放 embedding，配一个 HNSW 索引，相似检索就是一条 SQL。

CREATE TABLE docs ( id int, title text, embedding vector(384) ); CREATE INDEX ON docs USING hnsw (embedding); SELECT title FROM docs ORDER BY embedding <-> '[0.01, 0.02, 0.03, ...]'::vector LIMIT 10;

最后这条语句按距离排序取前 10 行，返回的就是最相似的结果，全程无需维护独立的向量数据库，查询直接写在业务 SQL 里。

开工前四项核对

四样东西占齐再动手，缺任何一项，后面的编译环节都会卡住：

从克隆源码到编译完成

拉取 v0.8.1 分支源码

源码放在临时目录即可，装完之后不用再管它：

cd %TEMP% git clone --branch v0.8.1 https://gitcode.com/GitHub_Trending/pg/pgvector.git cd pgvector

设置 PGROOT 与 PATH 环境变量

把 PGROOT 指向你的 PostgreSQL 安装目录。Makefile.win 靠这个变量定位头文件、库文件和安装目标，没设置的话 nmake 会直接报错。同一会话里顺手把 bin 目录也加进 PATH：

set PGROOT=C:\Program Files\PostgreSQL\16 set PATH=%PGROOT%\bin;%PATH%

在 x64 Native Tools 命令行执行 nmake 编译

终端换成 VS 的"x64 Native Tools Command Prompt"，用别的 shell 会缺 SDK 依赖。然后跑两条命令，一条编译、一条安装：

nmake /F Makefile.win nmake /F Makefile.win install

第二条命令负责把 vector.dll 和 SQL 文件拷贝进 PGROOT 的对应目录。编译本身不慢，顺利的话端到端大约 20 分钟。

两句话验证，一轮回归

连上数据库，依次执行两句：

CREATE EXTENSION vector; SELECT vector_version();

第二条能返回版本号，说明 pgvector 安装已经生效。✅

想跑完整回归的话，命令行再补一行 pgvector installcheck，它会把 test/sql 下的全部用例过一遍，类型转换、索引构建、距离函数都有覆盖：

nmake /F Makefile.win installcheck

编译报错时按这个顺序查

⚠️ 常见的 pgvector 编译报错基本集中在下面三种情况，从上往下排查：

三类高频报错对照

装完能干什么，怎么让它更快

向量类型与维度上限

距离算子

四个算子都能建索引加速查询。

索引选型：HNSW 还是 IVFFlat

调优清单

• 数据灌完再建索引
• 调大maintenance_work_mem
• 大表建索引时开启并行 worker
• HNSW 调ef_search，IVFFlat 调probes：调高换召回，调低换速度
• 召回不达标先查索引选型，小表走顺序扫描往往更稳

想深入看编译规则可以打开 Makefile.win，回归测试用例都在 test/sql/ 目录下。

【免费下载链接】pgvectorOpen-source vector similarity search for Postgres项目地址: https://gitcode.com/GitHub_Trending/pg/pgvector