pgvector 在 Windows 上编不过从一条 PGROOT 报错到 CREATE EXTENSION 跑通的完整路径【免费下载链接】pgvectorOpen-source vector similarity search for Postgres项目地址: https://gitcode.com/GitHub_Trending/pg/pgvector你在 x64 Native Tools 命令行里敲下nmake /F Makefile.win回车后等来的却是一串红字PGROOT is not set、Cannot open include file: postgres.h换台机器又是别的报错文档里说的步骤和自己看到的现象对不上号。看完本文你能按 4 个动作单元走完全流程把 pgvector 编成 vector.dll 并装进 PostgreSQL 的扩展目录。工具链装什么、装哪里每个报错为什么发生编译产物落在哪几个目录跑通后如何验证扩展真的能查先建立全局认知这次构建到底在干什么在动手之前先用一张图理清输入、过程和产出后面遇到报错你才知道它卡在哪一环。构建的输入是 pgvector 源码树加上 PostgreSQL 的开发文件头文件与postgres.libnmake按 Makefile.win 里的规则把 19 个.c文件编译成.obj再链接出vector.dll并把 vector.sql 复制成带版本号的vector--0.8.6.sql。安装动作则把三样东西复制进%PGROOT%产物安装位置用途vector.dll%PGROOT%\lib扩展的动态库vector.control及vector--*.sql%PGROOT%\share\extension元数据与建扩展脚本halfvec.h等 3 个头文件%PGROOT%\include\server\extension\vector供其他扩展引用所以编译成功的标志是源码目录里多出一个vector.dll安装成功的标志是%PGROOT%下对应目录多出了这三个产物。动手前需要备好的清单只列清单不展开Visual Studio 2022勾选使用 C 的桌面开发工作负载含 C CMake 工具、Windows SDKPostgreSQL 13以 18 为例安装时勾选 Development Files记住安装路径管理员权限安装步骤要往%PGROOT%写文件版本对应关系见 CHANGELOG.md当前源码版本为 0.8.6支持到 Postgres 18主线实操四个动作单元把构建走通装对工具链并用正确的命令行窗口启动这一步最容易翻车且错得无声无息——装错了窗口编译会报一个和 pgvector 本身毫无关系的错误。安装 Visual Studio 2022 时工作负载选使用 C 的桌面开发即可PostgreSQL 从官网下载安装器里勾选 Development Files。装完不要直接开普通 cmd从开始菜单启动x64 Native Tools Command Prompt以管理员身份运行它会自动把cl.exe和nmake放进 PATH。验证方法在这个窗口输入where cl应返回C:\Program Files (x86)\Microsoft Visual Studio\...\cl.exe。如果提示找不到说明你打开的窗口不对回到开始菜单重新进。设置 PGROOT 并确认开发文件在位Makefile.win 的前几行就是强制检查PGROOT未设置直接!error终止所以这个变量必须先于编译存在。set PGROOTC:\Program Files\PostgreSQL\18 dir %PGROOT%\include\server\postgres.h dir %PGROOT%\lib\postgres.lib执行后你应该看到两条dir都列出了对应文件。postgres.h是编译器要用的头文件postgres.lib是链接期要用的库缺一不可。注意set只对当前窗口生效。每个新的命令行窗口都要重新设置一次这是昨天能编今天不能编的常见原因。克隆源码并执行 nmake 构建到这里编译器已就位、PGROOT 已就位接下来是真正的构建。cd %TEMP% git clone --branch v0.8.6 https://gitcode.com/GitHub_Trending/pg/pgvector cd pgvector nmake /F Makefile.win执行后你应该看到依次输出的 19 行src\xxx.c编译日志最后链接出vector.dll且没有error字样。坑点提示如果中途 CtrlC 或报错后直接重跑残留的.obj可能让链接行为诡异。遇到怪错先执行nmake /F Makefile.win clean再重来这条规则后面对应一个具体报错。落盘安装并验证扩展加载构建成功后一条命令把产物复制进%PGROOT%nmake /F Makefile.win install执行后你会看到几行copy的输出。然后停掉 PostgreSQL 服务再装避免 DLL 被占用或装完再启动最后用 psql 验证dir %PGROOT%\lib\vector.dll dir %PGROOT%\share\extension\vector.controlCREATE EXTENSION vector; CREATE TABLE test (id int, embedding vector(3)); INSERT INTO test VALUES (1, [1,2,3]); SELECT * FROM test ORDER BY embedding - [3,2,1] LIMIT 1;最后一条查询应返回1 | [1,2,3]说明扩展不仅装上了距离计算也能正常工作。故障诊断五个高频报错的根因与修复PGROOT is not set还没开编就被拒现象PGROOT is not setnmake一行代码没编就退出根因Makefile.win 用!ifndef PGROOT做了前置检查环境变量在当前窗口不存在或你换过窗口导致失效修复set PGROOTC:\Program Files\PostgreSQL\18 echo %PGROOT%\include\server第二条命令应回显出postgres.h所在的完整路径。Cannot open include file: postgres.h现象Cannot open include file: postgres.h: No such file or directory根因PGROOT 指向了一个没有开发文件的安装比如只装了运行时组件或版本目录写错修复重装 PostgreSQL 并勾选 Development Files然后验证文件真实存在dir %PGROOT%\include\server\postgres.herror C2196: case value 4 already used现象error C2196: case value 4 already used集中在halfvec.c这类做浮点转换的文件根因没有使用 x64 Native Tools 窗口32 位工具链处理某些位级 switch 会冲突旧.obj残留也会叠加这个问题修复换到正确的 x64 Native Tools 窗口清掉残留再编nmake /F Makefile.win clean nmake /F Makefile.wincl 不是内部或外部命令现象cl 不是内部或外部命令也不是可运行的程序根因普通 cmd 里没有 MSVC 的环境变量nmake找不到编译器修复用管理员打开x64 Native Tools Command Prompt或在当前窗口手动加载环境call C:\Program Files\Microsoft Visual Studio\2022\Community\VC\Auxiliary\Build\vcvars64.batLNK2019postgres.lib 解析失败现象LNK2019: 无法解析的外部符号发生在所有.obj都编译完、只剩最后链接时根因Makefile.win 固定链接%PGROOT%\lib\postgres.lib该文件不存在只装了 client 工具或 PGROOT 指错了版本目录修复dir %PGROOT%\lib\postgres.lib文件缺失就重装 PostgreSQL 补上 Development Files确认文件存在后重新执行nmake /F Makefile.win。以上都没解决带着完整报错输出尤其是最后 20 行去项目 Issue 区搜一下再提问PGROOT、postgres.h、LNK2019都是高频检索词。进阶调优默认行为之外的三个选择要不要在 OPTFLAGS 里追加 /arch:AVX2Makefile.win 中OPTFLAGS默认为空编译已带/O2 /fp:fast开启 MSVC 自动向量化若你的 CPU 支持 AVX2可以追加目标架构指令配置行为收益默认空 OPTFLAGS自动向量化兼容所有 x64任何机器可编译OPTFLAGS /arch:AVX2距离计算用 AVX2 指令向量运算明显提速但 DLL 只能在 AVX2 CPU 上运行限制条件仅适用于确认支持 AVX2 的 CPU/arch会改变 DLL 的最低硬件要求分发场景慎用。用 installcheck 回归套件确认正确性nmake /F Makefile.win只保证能链出来不保证结果对。项目自带回归测试test/sql/ 下的 15 组用例可以替你验证nmake /F Makefile.win installcheck执行后你应该看到每个测试输出ok结尾汇总无failed。 限制条件需要一个可连接的 PostgreSQL 实例且该实例里已执行过 install。选对版本Windows 修复都写在哪CHANGELOG.md 里有两条与 Windows 直接相关的记录0.8.2 改进了 Windows 下的install目标0.7.3 修复了 MSVC 与 Postgres 16 的编译警告。如果你的源码树停在旧 tag 上又遇到奇怪的 install 行为或警告先确认版本再怀疑环境。收尾核对产物确认跑通你现在应该已经有了三样东西源码目录里的vector.dll、%PGROOT%\lib\vector.dll、以及psql里一条返回了[1,2,3]的-查询。如果少了任何一个回到主线实操对应的小节没有 dll 查构建窗口最后几行查询报错查 install 是否成功。最后跑一遍这段全绿即成功dir %PGROOT%\lib\vector.dll dir %PGROOT%\share\extension\vector.controlSELECT extversion FROM pg_extension WHERE extname vector;延伸参考README.md 的 Windows 安装说明与 CHANGELOG.md 的版本记录。如果这篇文章帮到了你转发给正在踩坑的同事就好。【免费下载链接】pgvectorOpen-source vector similarity search for Postgres项目地址: https://gitcode.com/GitHub_Trending/pg/pgvector创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
pgvector 在 Windows 上编不过？从一条 PGROOT 报错到 CREATE EXTENSION 跑通的完整路径
pgvector 在 Windows 上编不过从一条 PGROOT 报错到 CREATE EXTENSION 跑通的完整路径【免费下载链接】pgvectorOpen-source vector similarity search for Postgres项目地址: https://gitcode.com/GitHub_Trending/pg/pgvector你在 x64 Native Tools 命令行里敲下nmake /F Makefile.win回车后等来的却是一串红字PGROOT is not set、Cannot open include file: postgres.h换台机器又是别的报错文档里说的步骤和自己看到的现象对不上号。看完本文你能按 4 个动作单元走完全流程把 pgvector 编成 vector.dll 并装进 PostgreSQL 的扩展目录。工具链装什么、装哪里每个报错为什么发生编译产物落在哪几个目录跑通后如何验证扩展真的能查先建立全局认知这次构建到底在干什么在动手之前先用一张图理清输入、过程和产出后面遇到报错你才知道它卡在哪一环。构建的输入是 pgvector 源码树加上 PostgreSQL 的开发文件头文件与postgres.libnmake按 Makefile.win 里的规则把 19 个.c文件编译成.obj再链接出vector.dll并把 vector.sql 复制成带版本号的vector--0.8.6.sql。安装动作则把三样东西复制进%PGROOT%产物安装位置用途vector.dll%PGROOT%\lib扩展的动态库vector.control及vector--*.sql%PGROOT%\share\extension元数据与建扩展脚本halfvec.h等 3 个头文件%PGROOT%\include\server\extension\vector供其他扩展引用所以编译成功的标志是源码目录里多出一个vector.dll安装成功的标志是%PGROOT%下对应目录多出了这三个产物。动手前需要备好的清单只列清单不展开Visual Studio 2022勾选使用 C 的桌面开发工作负载含 C CMake 工具、Windows SDKPostgreSQL 13以 18 为例安装时勾选 Development Files记住安装路径管理员权限安装步骤要往%PGROOT%写文件版本对应关系见 CHANGELOG.md当前源码版本为 0.8.6支持到 Postgres 18主线实操四个动作单元把构建走通装对工具链并用正确的命令行窗口启动这一步最容易翻车且错得无声无息——装错了窗口编译会报一个和 pgvector 本身毫无关系的错误。安装 Visual Studio 2022 时工作负载选使用 C 的桌面开发即可PostgreSQL 从官网下载安装器里勾选 Development Files。装完不要直接开普通 cmd从开始菜单启动x64 Native Tools Command Prompt以管理员身份运行它会自动把cl.exe和nmake放进 PATH。验证方法在这个窗口输入where cl应返回C:\Program Files (x86)\Microsoft Visual Studio\...\cl.exe。如果提示找不到说明你打开的窗口不对回到开始菜单重新进。设置 PGROOT 并确认开发文件在位Makefile.win 的前几行就是强制检查PGROOT未设置直接!error终止所以这个变量必须先于编译存在。set PGROOTC:\Program Files\PostgreSQL\18 dir %PGROOT%\include\server\postgres.h dir %PGROOT%\lib\postgres.lib执行后你应该看到两条dir都列出了对应文件。postgres.h是编译器要用的头文件postgres.lib是链接期要用的库缺一不可。注意set只对当前窗口生效。每个新的命令行窗口都要重新设置一次这是昨天能编今天不能编的常见原因。克隆源码并执行 nmake 构建到这里编译器已就位、PGROOT 已就位接下来是真正的构建。cd %TEMP% git clone --branch v0.8.6 https://gitcode.com/GitHub_Trending/pg/pgvector cd pgvector nmake /F Makefile.win执行后你应该看到依次输出的 19 行src\xxx.c编译日志最后链接出vector.dll且没有error字样。坑点提示如果中途 CtrlC 或报错后直接重跑残留的.obj可能让链接行为诡异。遇到怪错先执行nmake /F Makefile.win clean再重来这条规则后面对应一个具体报错。落盘安装并验证扩展加载构建成功后一条命令把产物复制进%PGROOT%nmake /F Makefile.win install执行后你会看到几行copy的输出。然后停掉 PostgreSQL 服务再装避免 DLL 被占用或装完再启动最后用 psql 验证dir %PGROOT%\lib\vector.dll dir %PGROOT%\share\extension\vector.controlCREATE EXTENSION vector; CREATE TABLE test (id int, embedding vector(3)); INSERT INTO test VALUES (1, [1,2,3]); SELECT * FROM test ORDER BY embedding - [3,2,1] LIMIT 1;最后一条查询应返回1 | [1,2,3]说明扩展不仅装上了距离计算也能正常工作。故障诊断五个高频报错的根因与修复PGROOT is not set还没开编就被拒现象PGROOT is not setnmake一行代码没编就退出根因Makefile.win 用!ifndef PGROOT做了前置检查环境变量在当前窗口不存在或你换过窗口导致失效修复set PGROOTC:\Program Files\PostgreSQL\18 echo %PGROOT%\include\server第二条命令应回显出postgres.h所在的完整路径。Cannot open include file: postgres.h现象Cannot open include file: postgres.h: No such file or directory根因PGROOT 指向了一个没有开发文件的安装比如只装了运行时组件或版本目录写错修复重装 PostgreSQL 并勾选 Development Files然后验证文件真实存在dir %PGROOT%\include\server\postgres.herror C2196: case value 4 already used现象error C2196: case value 4 already used集中在halfvec.c这类做浮点转换的文件根因没有使用 x64 Native Tools 窗口32 位工具链处理某些位级 switch 会冲突旧.obj残留也会叠加这个问题修复换到正确的 x64 Native Tools 窗口清掉残留再编nmake /F Makefile.win clean nmake /F Makefile.wincl 不是内部或外部命令现象cl 不是内部或外部命令也不是可运行的程序根因普通 cmd 里没有 MSVC 的环境变量nmake找不到编译器修复用管理员打开x64 Native Tools Command Prompt或在当前窗口手动加载环境call C:\Program Files\Microsoft Visual Studio\2022\Community\VC\Auxiliary\Build\vcvars64.batLNK2019postgres.lib 解析失败现象LNK2019: 无法解析的外部符号发生在所有.obj都编译完、只剩最后链接时根因Makefile.win 固定链接%PGROOT%\lib\postgres.lib该文件不存在只装了 client 工具或 PGROOT 指错了版本目录修复dir %PGROOT%\lib\postgres.lib文件缺失就重装 PostgreSQL 补上 Development Files确认文件存在后重新执行nmake /F Makefile.win。以上都没解决带着完整报错输出尤其是最后 20 行去项目 Issue 区搜一下再提问PGROOT、postgres.h、LNK2019都是高频检索词。进阶调优默认行为之外的三个选择要不要在 OPTFLAGS 里追加 /arch:AVX2Makefile.win 中OPTFLAGS默认为空编译已带/O2 /fp:fast开启 MSVC 自动向量化若你的 CPU 支持 AVX2可以追加目标架构指令配置行为收益默认空 OPTFLAGS自动向量化兼容所有 x64任何机器可编译OPTFLAGS /arch:AVX2距离计算用 AVX2 指令向量运算明显提速但 DLL 只能在 AVX2 CPU 上运行限制条件仅适用于确认支持 AVX2 的 CPU/arch会改变 DLL 的最低硬件要求分发场景慎用。用 installcheck 回归套件确认正确性nmake /F Makefile.win只保证能链出来不保证结果对。项目自带回归测试test/sql/ 下的 15 组用例可以替你验证nmake /F Makefile.win installcheck执行后你应该看到每个测试输出ok结尾汇总无failed。 限制条件需要一个可连接的 PostgreSQL 实例且该实例里已执行过 install。选对版本Windows 修复都写在哪CHANGELOG.md 里有两条与 Windows 直接相关的记录0.8.2 改进了 Windows 下的install目标0.7.3 修复了 MSVC 与 Postgres 16 的编译警告。如果你的源码树停在旧 tag 上又遇到奇怪的 install 行为或警告先确认版本再怀疑环境。收尾核对产物确认跑通你现在应该已经有了三样东西源码目录里的vector.dll、%PGROOT%\lib\vector.dll、以及psql里一条返回了[1,2,3]的-查询。如果少了任何一个回到主线实操对应的小节没有 dll 查构建窗口最后几行查询报错查 install 是否成功。最后跑一遍这段全绿即成功dir %PGROOT%\lib\vector.dll dir %PGROOT%\share\extension\vector.controlSELECT extversion FROM pg_extension WHERE extname vector;延伸参考README.md 的 Windows 安装说明与 CHANGELOG.md 的版本记录。如果这篇文章帮到了你转发给正在踩坑的同事就好。【免费下载链接】pgvectorOpen-source vector similarity search for Postgres项目地址: https://gitcode.com/GitHub_Trending/pg/pgvector创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
