Windows 3 步装好 pgvectorPostgreSQL 向量扩展完整指南【免费下载链接】pgvectorOpen-source vector similarity search for Postgres项目地址: https://gitcode.com/GitHub_Trending/pg/pgvector本文带你完成 pgvectorPostgreSQL 向量扩展在 Windows 上的完整安装装完后你都能在数据库表里存向量表示文本内容的数值数组并用一条 SQL 做出向量相似性搜索。适合会基础 SQL、没装过数据库扩展的读者全程约 30 分钟。 开篇速览能完成在 Windows 的 PostgreSQL 上装好 pgvector并跑通第一次按距离排序的向量搜索适合谁会写基本 SQL但没装过数据库扩展给数据库加装新能力的小组件耗时含自检与验证约 30 分钟纯安装环节约 10 分钟路线只走预编译版本这一条最短路径源码编译压缩成本节末尾的一个可选分支✅ 动手前自检清单按下表逐项自查不满足就先做完处理列再做安装检查项通过标准不满足怎么办系统Windows 10/11 64 位改用 WSL 2 走 Linux 安装方式PostgreSQL13 及以上推荐 16postgres -V能输出版本号用 EDB 官方安装包安装对应版本psql 客户端开始菜单能找到 PostgreSQL 16 - psql 且能打开安装 PostgreSQL 时勾选完整组件C 编译工具链仅源码编译分支需要Visual Studio 含 C 工作负载在 Visual Studio Installer 中勾选使用 C 的桌面开发前两项不满足时后面所有步骤都会卡住第四项只在走可选分支时才需要。 最短安装路径主推 pgvector 预编译版本不需要任何编译动作把两类文件放到正确目录即可。下载预编译包。到 pgvector 项目的 Releases 页面选与你的 PostgreSQL 大版本匹配的 Windows 构建当前版本 0.8.6解压后应得到三类文件vector.dll、vector.control、一组vector--0.x.x.sql。放置动态库。把vector.dll复制到C:\Program Files\PostgreSQL\16\lib\16 换成你的大版本号需要管理员权限。放置扩展描述与脚本。把vector.control和全部vector--*.sql复制到C:\Program Files\PostgreSQL\16\share\extension\。vector.control的内容见 vector.control它声明了扩展版本。重启数据库服务。打开服务管理器右键 PostgreSQL 服务选重新启动。扩展由后端进程加载漏掉这一步是下一节报错的头号原因。可选分支pgvector 源码编译需要最新提交时才走这条。克隆仓库https://gitcode.com/GitHub_Trending/pg/pgvector打开 x64 Native Tools Command Prompt for VS执行set PGROOTC:\Program Files\PostgreSQL\16进入源码目录后运行nmake /F Makefile.win和nmake /F Makefile.win install。构建脚本会自动把产物拷进上面两个目录细节见 Makefile.win 与 README.md 的 Windows 章节。 一条命令验证打开 psql 连上任意数据库执行CREATE EXTENSION vector; SELECT extname, extversion FROM pg_extension WHERE extname vector;预期结果第一行无报错第二行返回一行如vector | 0.8.6。看到这一行即代表安装成功版本与 vector.control 中声明的一致。 第一次向量搜索下面三条语句可在同一 psql 会话中直接执行。建表CREATE TABLE notes ( id bigserial PRIMARY KEY, note_vec vector(4) );它创建一张notes表并声明一个vector(4)列即每行存恰好 4 个分量的向量。预期结果返回CREATE TABLE。写入数据INSERT INTO notes (note_vec) VALUES ([0.1, 0.9, 0.2, 0.4]), ([0.8, 0.3, 0.6, 0.1]), ([0.5, 0.5, 0.5, 0.2]);它写入 3 条向量字符串用方括号数组字面量表示这就是向量类型的输入形式。预期结果返回INSERT 0 3。按距离搜索SELECT id, note_vec FROM notes ORDER BY note_vec - [0.2, 0.8, 0.3, 0.1] LIMIT 2;-是 L2欧氏距离操作符计算查询向量与每行的距离后升序排序取前 2 名。预期结果第一行id 1第二行id 3。 故障自诊表症状最可能原因处理CREATE EXTENSION报extension vector is not availablevector.control没进share\extension或拷文件后未重启服务逐个检查两个目标目录是否都有对应文件确认后重启 PostgreSQL 服务再执行执行时报could not load library ... vector.dllvector.dll不在lib目录或版本错位如 16 的 dll 拷进了 15把vector.dll放进你实际启动的那个 PostgreSQL 版本的lib目录重启服务源码分支nmake报PGROOT is not set编译窗口未设置PGROOT变量先执行set PGROOTC:\Program Files\PostgreSQL\16再重新运行nmake /F Makefile.win三条之外的报错优先对照 README.md 的 installation notes 章节排查。 装完去哪索引数据量过万行时给向量列建 HNSW 索引近似最近邻的分层图索引避免全表逐行算距离。距离度量除 L2 外还支持#内积与余弦距离选与你的嵌入模型匹配的度量再建索引。落地把这张小表换成你的真实语料先跑通一条端到端的语义搜索链路再谈参数调优。【免费下载链接】pgvectorOpen-source vector similarity search for Postgres项目地址: https://gitcode.com/GitHub_Trending/pg/pgvector创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考