GIS研习社 GIS研习社
编程与开发 PostgreSQL POSTGRESQL官网

PostgreSQL官网那么多版本，GIS二次开发该选哪个？（附：空间数据库扩展插件下载）

编程与开发
Dr.GIS
wowwwai GIS研习社 · 工具流程与项目排障

《PostgreSQL官网那么多版本，GIS二次开发该选哪个？（附：空间数据库扩展插件下载）》这个问题，本质上不是“版本越新越好”，而是要在 PostgreSQL、PostGIS、操作系统、开发框架和生产稳定性之间做匹配。对 GIS 二次开发来说，数据库不仅要能存属性表，还要稳定支持 geometry、geography、空间索引、坐标转换、矢量切片、空间查询和数据导入导出。

很多同学第一次打开 PostgreSQL 官网下载页，会看到不同的大版本、安装包、源码包、EDB 安装器、Windows、Linux、macOS、Stack Builder 等选项，再加上 PostGIS 插件下载入口不太直观，很容易不知道该装哪一个。本文按 GIS 二次开发的实际场景，说明 PostgreSQL 版本怎么选、PostGIS 插件怎么装，以及如何验证空间数据库环境是否可用。

PostgreSQL版本选择与PostGIS空间数据库扩展插件下载流程图
GIS 二次开发中 PostgreSQL 与 PostGIS 的选择流程：先定操作系统，再定数据库大版本，最后安装并验证空间扩展。

引言：GIS二次开发为什么不能随便选 PostgreSQL 版本

普通业务系统选择 PostgreSQL，通常关注事务、并发、备份和 SQL 兼容性；但 GIS 二次开发还要额外关注空间数据库能力。比如在 WebGIS 后端中，你可能需要用 PostGIS 存储地块面、道路中心线、兴趣点、影像范围、多边形缓冲区和行政区边界。

如果 PostgreSQL 版本和 PostGIS 插件不匹配，常见问题包括：

  • 安装 PostgreSQL 后找不到 PostGIS 扩展。
  • 执行 CREATE EXTENSION postgis; 报错。
  • QGIS 能连接数据库，但看不到空间图层。
  • 导入 Shapefile 或 GeoPackage 后，geometry 字段不可识别。
  • 项目部署到服务器后，开发环境能跑，生产环境不能跑。

所以，GIS 二次开发选择 PostgreSQL，不能只看官网首页推荐的最新版本，而要结合项目周期、PostGIS 支持情况、服务器系统、团队维护能力和第三方工具兼容性一起判断。

背景：PostgreSQL官网常见下载选项怎么看

PostgreSQL 官网的下载内容一般可以分为几类。对于 GIS 初学者和中小型项目开发者，最常用的是预编译安装包，而不是源码编译。

下载类型 适合人群 GIS开发建议
Windows 图形安装包 学习、桌面开发、测试环境 适合 QGIS、ArcGIS Pro、WebGIS 后端本地联调
Linux 软件源安装 服务器部署、生产环境 推荐用于正式项目，便于升级和安全维护
macOS 安装包或包管理器 个人开发、教学实验 适合 Python GIS、GeoDjango、FastAPI 后端开发
源码包 数据库内核研究、特殊编译需求 普通 GIS 二次开发不建议优先选择
Stack Builder Windows 用户安装附加组件 常用于安装 PostGIS、pgAgent 等扩展

对于大多数 GIS 二次开发场景，可以优先选择“官方推荐安装包 + 对应版本 PostGIS 扩展”的方式。除非你明确知道自己需要源码编译，否则不要一开始就选择源码包。

原理：PostgreSQL、PostGIS 和 GIS 项目的关系

PostgreSQL 是关系型数据库，负责数据存储、事务、权限、索引和 SQL 查询。PostGIS 是 PostgreSQL 的空间数据库扩展，它让 PostgreSQL 具备 GIS 能力，例如空间字段、空间索引、空间关系判断、距离计算和坐标转换。

安装 PostgreSQL 并不等于已经具备空间数据库能力。只有安装并启用 PostGIS 后，数据库中才可以使用下面这些典型 GIS 能力：

  • geometry 和 geography 空间字段类型。
  • ST_Intersects、ST_Within、ST_Buffer、ST_Transform 等空间函数。
  • GiST 或 SP-GiST 空间索引。
  • 空间参考系统表 spatial_ref_sys。
  • QGIS、GeoServer、ArcGIS Pro 等软件直接连接空间表。

因此，GIS 二次开发选版本时，真正要匹配的是这组关系：

操作系统版本 → PostgreSQL 大版本 → PostGIS 扩展版本 → GIS 软件和后端框架兼容性 → 项目维护周期。

如果其中某一环不匹配，就可能出现安装成功但空间功能不可用的问题。

步骤：GIS二次开发该选哪个 PostgreSQL 版本

步骤一：先判断是学习环境、开发环境还是生产环境

如果你只是学习 PostGIS、QGIS 连接数据库、WebGIS 后端查询，可以选择当前主流且安装方便的 PostgreSQL 稳定大版本。学习环境的重点是少折腾、能复现教程、容易安装 PostGIS。

如果是公司项目或毕业设计开发环境，建议和服务器生产环境保持同一个 PostgreSQL 大版本。不要本地用一个版本，服务器用另一个版本，否则空间函数、扩展版本和备份恢复可能出现差异。

如果是正式生产环境，优先选择仍处于官方维护期、PostGIS 支持成熟、Linux 发行版软件源支持良好的 PostgreSQL 版本。不要为了“最新”牺牲稳定性。

步骤二：Windows 本地 GIS 开发优先选择图形安装包

Windows 用户做 GIS 二次开发，常见组合是：

  • PostgreSQL 官方 Windows 安装包。
  • Stack Builder 安装 PostGIS。
  • QGIS 连接 PostgreSQL 数据库。
  • GeoServer、Python、Java 或 Node.js 后端读取空间表。

安装 PostgreSQL 时要记住三项信息：

  • 数据库超级用户，一般是 postgres。
  • 端口，默认通常是 5432。
  • 安装目录和数据目录，后续排查插件路径时会用到。

安装完成后，可以通过 Stack Builder 选择对应 PostgreSQL 实例，再选择 Spatial Extensions 中的 PostGIS 组件。注意：PostGIS 必须安装到对应 PostgreSQL 大版本上，不能把一个版本的插件装到另一个版本的数据库目录里。

步骤三：Linux 服务器优先使用官方仓库或发行版仓库

生产服务器上，不建议从不明来源下载 PostgreSQL 安装包。更推荐使用 PostgreSQL 官方软件仓库或 Linux 发行版仓库。这样做的好处是：

  • 依赖关系更清晰。
  • 安全更新更方便。
  • 服务管理可以直接使用系统服务。
  • PostGIS 相关包通常能通过包管理器安装。

以 Linux 服务器为例，实际安装时要确认 PostgreSQL 服务、客户端工具和 PostGIS 包来自同一个版本体系。安装后不要只看服务是否启动，还要进入数据库执行 SQL 验证空间扩展。

步骤四：确认 PostGIS 扩展插件下载入口

PostGIS 插件通常有几种安装方式：

系统 常用安装方式 说明
Windows Stack Builder 适合初学者，图形化选择 PostgreSQL 实例和 PostGIS 扩展
Linux 软件仓库安装 适合服务器，便于维护和升级
macOS 安装包或包管理器 适合本机开发，注意数据库服务路径
源码编译 手动编译 PostGIS 仅适合有特殊版本、特殊依赖或内网构建需求的团队

如果你在 Windows 上已经安装 PostgreSQL，但 Stack Builder 里找不到 PostGIS，可以检查以下几点：

  • 是否选择了正确的 PostgreSQL 实例。
  • 网络是否能访问插件下载源。
  • PostgreSQL 大版本是否仍有对应 PostGIS 安装包。
  • 是否使用了非官方或过旧的 PostgreSQL 安装方式。

步骤五：创建空间数据库并启用 PostGIS

安装 PostgreSQL 和 PostGIS 后，还需要在具体数据库中启用扩展。扩展不是对所有数据库自动生效的，通常每个需要空间能力的数据库都要执行一次。

CREATE DATABASE gis_demo;

c gis_demo

CREATE EXTENSION postgis;

SELECT postgis_full_version();

如果返回 PostGIS、GEOS、PROJ、GDAL 等组件信息，说明空间数据库扩展已经正常启用。这里的 GEOS 常用于几何运算，PROJ 用于坐标转换，GDAL 常用于栅格和空间数据格式相关能力。

步骤六：创建一张测试空间表

为了确认 GIS 二次开发环境真的可用，可以创建一个简单点图层表，并插入一条数据。

CREATE TABLE poi_test (
    id SERIAL PRIMARY KEY,
    name TEXT,
    geom geometry(Point, 4326)
);

INSERT INTO poi_test (name, geom)
VALUES (
    '测试点',
    ST_SetSRID(ST_MakePoint(116.391, 39.907), 4326)
);

CREATE INDEX idx_poi_test_geom
ON poi_test
USING GIST (geom);

然后执行一个简单空间查询：

SELECT id, name, ST_AsText(geom)
FROM poi_test
WHERE ST_Intersects(
    geom,
    ST_MakeEnvelope(116.0, 39.0, 117.0, 40.0, 4326)
);

如果能查出“测试点”，说明 PostgreSQL、PostGIS、空间字段和空间查询都已经基本可用。

步骤七：用 QGIS 或 GIS 客户端验证

SQL 验证通过后，建议再用 QGIS 连接 PostgreSQL 数据库。操作思路如下：

  1. 打开 QGIS 的 PostgreSQL 连接管理。
  2. 填写主机、端口、数据库名、用户名和密码。
  3. 连接后查看是否能识别 poi_test 表。
  4. 将表加载到地图画布。
  5. 确认图层坐标系为 EPSG:4326。

如果 QGIS 能正常加载点图层，说明该 PostgreSQL 版本已经可以支撑基础 GIS 二次开发。

常见坑：PostgreSQL 和 PostGIS 安装最容易出错的地方

坑一：只安装 PostgreSQL，没有安装 PostGIS

很多新手以为 PostgreSQL 天生支持空间数据。实际上 PostgreSQL 只能存普通字段，空间能力来自 PostGIS。没有 PostGIS 时，执行 CREATE EXTENSION postgis; 往往会提示扩展控制文件不存在。

坑二：PostGIS 插件版本和 PostgreSQL 大版本不匹配

PostGIS 是编译到特定 PostgreSQL 环境下使用的扩展。不要手动复制其他版本目录里的扩展文件。正确方式是通过对应安装器、软件仓库或官方构建包安装。

坑三：本地和服务器版本不一致

如果本地开发使用一个 PostgreSQL 大版本，服务器使用另一个大版本，备份恢复时可能出现扩展版本、函数行为或权限差异。GIS 项目尤其要注意 postgis_full_version() 返回结果是否一致。

坑四：忘记给空间字段建索引

PostGIS 能查询空间数据，但大数据量下如果没有空间索引，ST_Intersects、ST_Within、ST_DWithin 等查询会非常慢。常见索引写法如下：

CREATE INDEX idx_table_geom
ON your_table
USING GIST (geom);

坑五：坐标系 SRID 混乱

空间数据库能不能查得准，不只取决于版本，还取决于坐标系。比如一个图层是 EPSG:4326，经纬度单位是度；另一个图层是投影坐标，单位是米。如果直接做距离计算，结果很可能不正确。

常见检查 SQL：

SELECT ST_SRID(geom), COUNT(*)
FROM your_table
GROUP BY ST_SRID(geom);

坑六：用最新版做生产，却没有验证周边工具

PostgreSQL 新版本通常会带来新特性，但 GIS 二次开发还依赖 QGIS、GeoServer、GDAL、驱动库、ORM 框架和部署脚本。生产环境升级前，应先在测试环境验证完整链路，而不是只验证数据库能启动。

方法比较：不同 GIS 场景下怎么选版本组合

使用场景 推荐思路 原因
GIS 学生学习 PostGIS 选择安装方便、教程覆盖多的稳定版本 重点是快速完成空间表、空间索引和 QGIS 连接练习
毕业设计或课程项目 本地与部署环境保持同一大版本 避免演示前出现备份恢复和扩展不兼容
WebGIS 后端开发 选择 PostGIS 支持成熟的 PostgreSQL 稳定版本 需要长期运行空间查询、接口服务和地图数据发布
企业生产项目 优先选择仍在维护期且团队熟悉的版本 稳定性、补丁、安全和备份策略比追新更重要
内网或信创环境 先确认操作系统仓库和编译依赖 PostGIS 依赖较多，离线安装要提前准备包和版本矩阵

简单来说，如果你是初学者，不要纠结每一个小版本差异；如果你是项目负责人，不要只看安装成功，还要看生命周期、备份恢复、扩展兼容和团队维护成本。

检查清单：安装后必须验证的 10 项内容

  • PostgreSQL 服务是否正常启动。
  • 端口是否为项目配置中的端口，常见为 5432。
  • 客户端工具是否能连接数据库。
  • 是否已安装 PostGIS 扩展文件。
  • 目标数据库是否已执行 CREATE EXTENSION postgis;。
  • SELECT postgis_full_version(); 是否能正常返回。
  • 空间表是否存在 geometry 或 geography 字段。
  • 空间字段是否设置了正确 SRID。
  • 大表是否创建 GiST 空间索引。
  • QGIS、GeoServer 或后端程序是否能正常读取空间图层。

如果这 10 项都通过，说明 PostgreSQL 与 PostGIS 环境已经满足大多数 GIS 二次开发入门和中小型项目需求。

FAQ：PostgreSQL官网版本和PostGIS插件常见问题

问：GIS二次开发一定要安装 PostGIS 吗？

如果只是存普通业务表，不一定需要 PostGIS。但只要涉及空间字段、地图图层、缓冲区、叠加分析、空间相交、范围查询、距离查询，就应该安装 PostGIS。对于 PostgreSQL GIS 二次开发来说，PostGIS 基本是必备扩展。

问：PostgreSQL 官网最新版适合直接用于生产吗？

不建议只因为“最新版”就直接用于生产。生产环境更应该看官方维护期、PostGIS 支持成熟度、操作系统仓库支持、备份恢复方案和团队经验。新版本可以测试，但上线前要做完整链路验证。

问：Windows 上安装 PostgreSQL 后，PostGIS 插件在哪里下载？

Windows 用户通常通过 Stack Builder 安装 PostGIS。安装 PostgreSQL 后运行 Stack Builder，选择对应 PostgreSQL 实例，再在扩展组件中选择 PostGIS。关键是要选对数据库实例和版本。

问：为什么执行 CREATE EXTENSION postgis 报错？

常见原因有三个：第一，PostGIS 没有安装；第二，PostGIS 安装到了另一个 PostgreSQL 版本；第三，当前数据库用户没有创建扩展的权限。先确认扩展文件存在，再确认连接的是正确数据库实例。

问：PostgreSQL 和 PostGIS 小版本需要完全一致吗？

通常不要求小版本号完全一致，但必须使用兼容的 PostgreSQL 大版本和 PostGIS 构建包。实际项目中，不要混用来源不明的二进制文件，尽量通过官方安装器或软件仓库安装。

问：QGIS 能连接 PostgreSQL，但看不到图层怎么办？

先确认表中是否有合法的 geometry 字段，再检查 SRID、主键、空间索引和表权限。可以执行 SELECT GeometryType(geom), ST_SRID(geom) FROM your_table LIMIT 5; 判断空间字段是否正常。

问：PostGIS 的 geometry 和 geography 该选哪个？

多数 GIS 二次开发优先使用 geometry。它适合常规矢量数据、投影坐标、空间分析和地图展示。geography 更适合基于地球椭球的经纬度距离计算，但函数支持和性能场景要单独评估。

结论：GIS二次开发选 PostgreSQL 的实用建议

对于 GIS 二次开发，PostgreSQL 官网那么多版本，不需要盲目追新，也不建议随便下载一个能安装的版本就开始做项目。正确做法是：先确定项目环境，再选择仍在维护期、PostGIS 支持成熟、团队容易维护的 PostgreSQL 稳定版本。

如果你是学习或本地开发，优先选择图形安装方便、能通过 Stack Builder 或包管理器安装 PostGIS 的版本；如果你是生产部署，优先保证操作系统仓库、PostGIS 扩展、备份恢复和 GIS 客户端工具兼容。

最后记住一个判断标准：只要能稳定执行 CREATE EXTENSION postgis;、SELECT postgis_full_version();，并能被 QGIS 或后端程序正确读取空间表，这个 PostgreSQL 版本才算真正适合你的 GIS 二次开发环境。