PostgreSQL扩展选型实战：从向量检索到中文全文检索

最近在整理一个老项目的技术底座时，遇到了一个很典型的问题：PostgreSQL 16 跑得好好的，但业务方突然要加向量检索、地理位置查询、中文全文检索这三项能力。我第一反应是找现成的扩展方案，结果打开官方文档的 contrib 模块列表，一下子就晕了——几十个模块，有的还要挑支持版本，社区里再搜一圈，又冒出来一堆第三方扩展，光“选哪个”就能耗掉大半天。

我索性把这个问题丢给 DeepSeek，让它按照“业务场景”而不是“模块名称”帮我梳理一份 PostgreSQL 扩展方案。它给的第一版框架确实能打，把性能监控、向量检索、地理空间、全文检索、数据同步几大类拆得明明白白。但等我把方案真正落到测试环境时，才发现 AI 输出和真实环境之间还隔着不少坑：版本号对不上、Windows 下 DLL 不知道去哪找、配置文件里少了一个预加载项导致扩展“装了个寂寞”。这篇文章就是把我用 DeepSeek 做扩展调研、再逐项人工验证和踩坑的完整过程整理出来，给同样在为 PostgreSQL 扩展选型头痛的朋友一份可以直接参考的清单和排错思路。

1. 扩展太多先不说，业务场景更值得先说清楚

1.1 当时业务上面临的具体问题

我手上的系统是一个基于 PostgreSQL 16 的业务库，已经稳定运行了一段时间。但新需求来得很快：算法团队要基于向量做相似度检索，业务方想在地图上按距离筛选门店，运营要搜索中文商品描述，DBA 这边还要补一套 SQL 性能监控。另外，还涉及到从 MySQL、SQL Server 把历史数据同步过来的问题。

把需求拆开看，每个需求背后都对应不止一个扩展。比如全文检索有内置分词、zhparser、pg_jieba 能选；向量检索有 pgvector、pgvectorscale，甚至还有早期社区项目 pg_embedding；地理位置基本是 PostGIS 一家独大，但它的安装配置又比普通扩展重得多。这种“答案不唯一”的局面，恰好是 AI 归纳能力最值钱的地方。

1.2 为什么选择让 AI 做初筛而不是直接啃官方文档

官方文档的 contrib 列表是按模块名称罗列的，你必须自己知道要找什么，才翻得动。但业务方描述需求时说的是“我要能搜相似图片”“我要按距离排序”，不会直接说“我要装 pgvector”。所以我需要的不是一本按字母排序的手册，而是一张“从业务需求到扩展推荐”的映射表。

这个转换恰恰是 DeepSeek 擅长的。我只要把场景描述清楚，它就能把官方文档、社区博客、PGXN 上零散的信息重组为结构化的候选清单。我的底线也很明确：AI 只负责初筛，任何扩展在进测试环境之前，都必须人工核实版本和维护状态。后面你会发现，这个底线救了我好几次。

2. PostgreSQL 扩展机制的核心认知：理解 CREATE EXTENSION 背后的逻辑

2.1 扩展就是数据库里的“App Store 应用”

很多刚接触 PostgreSQL 的朋友会把扩展和“插件”混为一谈，然后问出“扩展是不是要改源码”这种问题。实际上，PostgreSQL 的扩展（Extension）是一套打包好的数据库对象集合：函数、数据类型、操作符、索引方法、视图、触发器等等，通过一条 CREATE EXTENSION 命令，就能把整组对象装进指定的数据库。

可以类比成手机应用商店：扩展是打包好的 App，CREATE EXTENSION 就是点击安装，DROP EXTENSION 就是卸载。相比手动执行一堆 SQL 脚本，扩展最大的优势是“可追踪、可升级、可卸载”。pg_available_extensions 视图告诉你系统里有哪些扩展可用，pg_extension 视图告诉你哪个库装了哪个扩展、是什么版本，运维起来完全可控。

2.2 控制文件、SQL 脚本和动态库：扩展的三个构成部分

在 $PGDIR/share/extension 目录下，你会看到三类文件：

• 扩展名.control：控制文件，定义扩展名、默认版本、依赖关系、是否可重定位。
• 扩展名--版本.sql：安装脚本。
• 扩展名--旧版本--新版本.sql：升级脚本。

以 pgvector 为例，目录里会有 vector.control、vector--0.7.4.sql 这样的文件。某些扩展还会带动态库，比如 PostGIS 的 postgis-3.so，pg_stat_statements 的 pg_stat_statements.so。如果扩展带动态库并且需要预加载，就得在 postgresql.conf 里配置 shared_preload_libraries，然后重启实例。“扩展装了但没生效”八成是漏了这一项，后面我会单独展开。

2.3 版本和依赖：选型时必须盯住的两件事

扩展有严格的版本概念。`CREAT