如何在 Windows 上 20 分钟编译安装 pgvector:PGROOT 与 nmake 配置指南【免费下载链接】pgvectorOpen-source vector similarity search for Postgres项目地址: https://gitcode.com/GitHub_Trending/pg/pgvectorPGROOT 设了三遍,cl.exe依旧不是内部或外部命令,postgres.h死活找不到——这是 Windows 编译 pgvector 这个 PostgreSQL 向量搜索扩展时的典型第一现场。本文把环境检查、nmake 编译、安装验证和报错处理压成一条可照做的路径。前置准备:Windows 编译 pgvector 的环境清单所有问题都出在下表五项中的某一项,编译前逐项确认,可以省掉反复试错。准备项用途验证方法Visual Studio 2022,含使用 C 的桌面开发工作负载与 Windows SDK提供 MSVC 编译器与nmake在 VS 命令提示符中执行cl,能输出版本信息PostgreSQL 13(安装时勾选 Development Files)提供postgres.h头文件与postgres.libdir %PGROOT%\include\server\postgres.h能列出文件x64 Native Tools Command Prompt for VS 2022把 64 位编译器工具链注入 PATH在该窗口执行where cl能返回路径管理员权限install阶段需写入%PGROOT%\lib与share命令窗口标题含管理员PGROOT变量指向 PostgreSQL 安装根目录echo %PGROOT%显示预期路径编译主流程:PGROOT、nmake 与 install整个编译就是设变量 → 克隆源码 → 两条 nmake 命令,操作如下。以管理员身份打开x64 Native Tools Command Prompt for VS 2022,注意是 x64 版本,32 位提示符会在编译中期报架构不匹配错误。设置 PGROOT 并获取源码(路径按实际安装位置调整):set PGROOTC:\Program Files\PostgreSQL\18 git clone --branch v0.8.6 https://gitcode.com/GitHub_Trending/pg/pgvector.git进入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; -- 预期返回 id1-是 L2 距离算子,把它换成即余弦距离、#为内积;能按预期返回最近邻,说明 pgvector 向量扩展已可投入使用。nmake 编译常见报错速查PGROOT is not set根因:当前构建会话没有 PGROOT,变量只作用于设置它的那个窗口。修复:set PGROOTC:\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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考