企业官网建设流程全解析

如何在 Windows 上 20 分钟编译安装 pgvector:PGROOT 与 nmake 配置指南

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

PGROOT 设了三遍,cl.exe依旧"不是内部或外部命令",postgres.h死活找不到——这是 Windows 编译 pgvector 这个 PostgreSQL 向量搜索扩展时的典型第一现场。本文把环境检查、nmake 编译、安装验证和报错处理压成一条可照做的路径。

前置准备:Windows 编译 pgvector 的环境清单

所有问题都出在下表五项中的某一项,编译前逐项确认,可以省掉反复试错。

编译主流程:PGROOT、nmake 与 install

整个编译就是"设变量 → 克隆源码 → 两条 nmake 命令",操作如下。

1. 以管理员身份打开x64 Native Tools Command Prompt for VS 2022,注意是 x64 版本,32 位提示符会在编译中期报架构不匹配错误。
2. 设置 PGROOT 并获取源码(路径按实际安装位置调整):

set "PGROOT=C:\Program Files\PostgreSQL\18" git clone --branch v0.8.6 https://gitcode.com/GitHub_Trending/pg/pgvector.git

3. 进入pgvector源码目录,执行编译与安装:

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

第一条命令把src下 18 个 C 源文件编译、链接成vector.dll;第二条把vector.dll复制进%PGROOT%\lib,将vector.control和全部升级 SQL 脚本拷入%PGROOT%\share\extension,并落地三个头文件。

Makefile.win默认已通过PG_CFLAGS加入/O2 /fp:fast开启 MSVC 自动向量化;若目标 CPU 支持 AVX2,可在OPTFLAGS行追加/arch:AVX2进一步提速,不支持的机型请去掉该参数。

⚠️set设置的 PGROOT 只在当前窗口有效,关掉窗口或新开窗口后必须重设;nmake报PGROOT is not set几乎都源于此。

一键验证:文件检查与最小可运行 SQL

先在命令行确认产物落位:

dir %PGROOT%\lib\vector.dll dir %PGROOT%\share\extension\vector.control

再连接数据库,用下面这段最精简的 SQL 完成端到端验证:

CREATE EXTENSION vector; CREATE TABLE items (id bigserial PRIMARY KEY, embedding vector(3)); INSERT INTO items (embedding) VALUES ('[1,2,3]'), ('[4,5,6]'), ('[7,8,9]'); SELECT id FROM items ORDER BY embedding <-> '[3,1,2]' LIMIT 1; -- 预期返回 id=1

<->是 L2 距离算子,把它换成<=>即余弦距离、<#>为内积;能按预期返回最近邻,说明 pgvector 向量扩展已可投入使用。

nmake 编译常见报错速查

PGROOT is not set

• 根因:当前构建会话没有 PGROOT,变量只作用于设置它的那个窗口。
• 修复:set "PGROOT=C:\Program Files\PostgreSQL\18"后重跑nmake /F Makefile.win。

Cannot open include file: 'postgres.h': No such file or directory

• 根因:PGROOT 指错目录,或安装 PostgreSQL 时未带 Development Files。
• 修复:执行dir %PGROOT%\include\server\postgres.h核对;文件不存在则重装 PostgreSQL 并勾选 Development Files。

error C2196: case value '4' already used

• 根因:使用了非 x64 的提示符,编译目标架构与 MSVC 默认值冲突。
• 修复:换到 x64 Native Tools Command Prompt,先执行nmake /F Makefile.win clean再重新编译。

Access is denied(install 阶段)

• 根因:向%PGROOT%\lib复制文件需要管理员权限。
• 修复:以管理员身份重开提示符,重新执行nmake /F Makefile.win install。

另:PostgreSQL 17.0–17.2 在链接期报unresolved external symbol float_to_shortest_decimal_bufn时,把 PostgreSQL 升级到 17.3+ 即可。

写在最后

pgvector 的价值在于近似最近邻索引(HNSW、IVFFlat)与精确 KNN 查询直接跑在 PostgreSQL 内部,向量过滤、聚合、事务和传统 SQL 在同一实例内完成,不必为向量数据单独维护一套检索服务。下一步建议执行nmake /F Makefile.win installcheck跑一遍项目自带的回归套件,或阅读 README.md 的 Getting Started 章节,把示例中的vector(3)换成你业务的真实维度开始实测。

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