PostgreSQL pgvector 在 Windows 上安装教程:从编译到第一次向量查询的完整指南
PostgreSQL pgvector 在 Windows 上安装教程从编译到第一次向量查询的完整指南【免费下载链接】pgvectorOpen-source vector similarity search for Postgres项目地址: https://gitcode.com/GitHub_Trending/pg/pgvector做语义搜索、以图搜图、RAG 应用时你是不是总想再引一套独立的向量数据库其实不必。pgvector 是 Postgres 的一个开源扩展扩展即给数据库加新功能的插件包让你把向量直接存进 PostgreSQL 表里用一行 SQL 就能做相似度搜索。本文带你走完 Windows 上从源码编译、安装到跑通第一条查询的完整流程并覆盖最常见的报错处理和日常调优。动手前的 5 分钟环境检查编译类安装失败九成是环境没配对。开始前花几分钟核对这四项能省掉后面大量排查时间PostgreSQL 13 及以上版本pgvector 当前 0.8.6 版本支持 Postgres 13版本越新越推荐。记下你的安装路径比如C:\Program Files\PostgreSQL\18下一步要用。Visual Studio 的 C 生成工具只需勾选C 桌面开发工作负载不需要完整安装 Visual Studio。它是编译 pgvector 所需的 C 编译器来源。Git 命令行工具用于拉取源码。管理员权限安装步骤会往 Postgres 的 lib 目录写文件普通权限会直接被拒。 确认 Postgres 装的是 x64 版本。编译产物必须是 64 位架构不匹配会在链接阶段报错。编译安装三步走PGROOT、克隆、nmake这一步最关键的地方在于必须使用x64 Native Tools Command PromptVisual Studio 附带的命令行工具而不是普通的 CMD。它会自动把 MSVC 编译器加入 PATH并保证编译出 64 位代码。用错窗口后面所有报错都会绕着找不到文件打转。打开管理员身份的x64 Native Tools Command Prompt for VS按顺序执行第 1 步告诉构建脚本 Postgres 在哪这一步为什么关键构建脚本 Makefile.win 依赖PGROOT找到 Postgres 的头文件和postgres.lib它不会自己猜。路径写错编译立刻在第一步失败。set PGROOTC:\Program Files\PostgreSQL\18第 2 步拉取与安装匹配的源码克隆到临时目录避免污染你的代码工作区cd %TEMP% git clone --branch v0.8.6 https://gitcode.com/GitHub_Trending/pg/pgvector cd pgvector第 3 步编译并安装nmake /F Makefile.win nmake /F Makefile.win install第一条命令把 src/ 下的 HNSW、IVFFlat、向量类型等 C 源码编译成vector.dll第二条把 dll、vector.control和 sql/ 目录下的扩展脚本复制到 Postgres 的 lib 与 share 目录。看到install阶段打印出几条 copy 记录而没有红色 error就成功了一大半。30 秒验证一行 SQL 确认扩展可用重启一次 Postgres 服务让新 dll 生效然后用psql连到你的数据库CREATE EXTENSION vector; SELECT extversion FROM pg_extension WHERE extname vector;第二条查询应返回0.8.6。如果CREATE EXTENSION报could not open extension control file通常说明上一步 install 没执行成功或 Postgres 没重启回头检查即可。接着建一张最小测试表验证存取与最近邻查询CREATE TABLE items (id bigserial PRIMARY KEY, embedding vector(3)); INSERT INTO items (embedding) VALUES ([1,2,3]), ([4,5,6]); SELECT * FROM items ORDER BY embedding - [3,1,2] LIMIT 5;vector(3)表示 3 维单精度向量-是欧氏L2距离算子。结果里距离最小的那行排最前说明从存储、类型到算子链路全部通了。选对距离算子和索引类型pgvector 提供 6 种距离算子按场景选算子含义适用场景-L2欧氏距离通用余弦距离文本嵌入相似度#负内积推荐系统返回负值记得乘 -1 还原L1曼哈顿距离稀疏坐标~/%海明 / 杰卡德距离二进制向量bit类型注意一个容易踩的坑#返回的是负内积因为 Postgres 的索引只支持ASC方向的算子扫描。要显示真实内积就写(embedding # [1,2,3]) * -1。数据量上万后全表精确扫描扛不住该上近似索引了。pgvector 提供两种实现分别在 src/hnsw.c 和 src/ivfflat.cHNSW多层图索引速度-召回权衡更好CREATE INDEX ON items USING hnsw (embedding vector_l2_ops);无需训练空表就能建代价是构建慢、占用内存多。IVFFlat倒排文件索引内存占用更低CREATE INDEX ON items USING ivfflat (embedding vector_l2_ops) WITH (lists 100);需要先有数据训练聚类中心lists经验上取行数的平方根量级。⚠️ 加近似索引后同一查询的结果可能与精确搜索略有差异——它用少量召回率换速度这是设计预期不是 bug。让构建和查询更快的 3 个参数1. 构建索引时给内存HNSW 图能放进maintenance_work_mem时构建速度显著提升图放不下会弹出hnsw graph no longer fits的 NOTICE 提示SET maintenance_work_mem 2GB;别设到耗尽服务器内存。大批量建索引还可以加并行SET max_parallel_maintenance_workers 7;2. 查询时调召回率HNSW 的搜索候选列表大小默认 40召回不够时调大SET hnsw.ef_search 100;值越大召回越好、速度越慢只想对单条查询生效可以在事务里用SET LOCAL。3. 用 EXPLAIN 确认索引真的被走了EXPLAIN (ANALYZE, BUFFERS) SELECT * FROM items ORDER BY embedding - [3,1,2] LIMIT 5;输出里出现Index Scan using ... on items才说明查询走的是索引如果出现Seq Scan多半是数据太少或没加ORDER BY ... LIMIT只写WHERE embedding - ... 5不加排序限制时索引无法生效。常见编译报错速查现象 → 原因 → 解决现象Cannot open include file: postgres.h原因PGROOT指向的目录里找不到头文件通常是路径写错或指向了 32 位/非完整安装。 解决核对 Postgres 安装路径后重新set PGROOT...再执行nmake /F Makefile.win clean重跑编译。现象error C2196: case value 4 already used原因用的是 32 位或错误的命令提示符编译架构与 Postgres 不匹配。 解决关闭当前窗口改用管理员身份的x64 Native Tools Command Prompt先nmake /F Makefile.win clean再重新编译。现象unresolved external symbol float_to_shortest_decimal_bufn原因Postgres 17.0–17.2 与扩展符号不匹配。 解决把 Postgres 升级到 17.3 或更高版本。现象Access is denied安装阶段原因没有写 Postgres 安装目录的权限。 解决以管理员身份重新执行nmake /F Makefile.win install。以上细节与官方文档一致可对照 README.md 中的 Windows 安装章节复核。日常维护查版本与平滑升级升级流程很短先用同样的方式安装新版本到 Postgres覆盖 dll 与 sql 脚本然后在每个需要升级的数据库里执行ALTER EXTENSION vector UPDATE; SELECT extversion FROM pg_extension WHERE extname vector;每个小版本修了什么 bug、改了什么行为翻一下 CHANGELOG.md 心里就有数了——比如 0.8.4 修了 HNSW vacuum 相关的图损坏问题如果你的库在用 HNSW 索引这类修复值得优先跟进。日常只需盯两件事建 HNSW 大索引时观察maintenance_work_mem是否够用看 NOTICE 提示以及用EXPLAIN抽查关键查询是否走了预期索引。到这里你的 Windows 版 PostgreSQL 已经具备了开箱即用的向量搜索能力扩展装好了距离算子、HNSW/IVFFlat 索引和调优参数也都过了一遍。下一步建议把真实业务向量导入用EXPLAIN (ANALYZE, BUFFERS)实测一次查询再按召回率需求微调hnsw.ef_search。别被向量数据库三个字吓到——它现在就是你手上那个 Postgres动手试试比想象中简单得多。【免费下载链接】pgvectorOpen-source vector similarity search for Postgres项目地址: https://gitcode.com/GitHub_Trending/pg/pgvector创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关新闻

从零构建班级同学录网站:Vue+Node.js全栈开发实战

从零构建班级同学录网站:Vue+Node.js全栈开发实战

简介:本资源是一套面向计算机专业本科生的毕业设计实战项目——班级同学录网站,聚焦教育信息化场景下的班级管理与师生互动需求,适用于软件工程、Web开发课程设计及毕设选题参考。压缩包共1261个文件,总大小28.52MB,涵…

2026/11/16 9:35:51 阅读更多 →
用RomM在NAS上搭建私人游戏库,让老游戏封面墙随点随玩

用RomM在NAS上搭建私人游戏库,让老游戏封面墙随点随玩

上个月整理书房,翻出一块吃灰多年的移动硬盘。里面装着我从 GBA、NDS、PS1 一路攒下来的老游戏镜像,总量好几百 GB,命名乱七八糟,目录层层嵌套,有些平台连文件夹都分了三个版本。我想找一两个打开重温,光是…

2026/11/14 20:09:18 阅读更多 →
Unity热更新实录:HybridCLR接入 C#代码热更的选型与实践

Unity热更新实录:HybridCLR接入 C#代码热更的选型与实践

1. 为什么最终选了 HybridCLR,而不是 Lua 或 ILRuntime做 Unity 项目的同学应该都有体会:在国内做手游,热更新几乎不是“可选项”,而是“必选项”。原因很简单,应用商店审核周期摆在那里,线上出了个崩溃、卡…

2026/11/6 11:31:05 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/16 8:22:12 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/16 6:41:34 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/16 8:22:12 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/16 8:22:12 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/16 7:30:18 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/16 8:22:12 阅读更多 →

日新闻

周新闻

月新闻