PostGIS 中文入门教程与在线学习指南

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

PostGIS 是 PostgreSQL 的空间扩展,用来存储点、线、多边形等几何数据,并提供距离、相交、缓冲、面积等空间函数与索引。想系统学习 PostGIS 中文入门,优先使用官方已发布的 PostGIS 3.7 简体中文手册和 Introduction to PostGIS Workshop 中文版,再配合 Docker 或系统包快速安装验证。截至 2026 年 11 月,最新稳定版是 2026 年 10 月 30 日发布的 PostGIS 3.7.0,建议搭配 PostgreSQL 14 及以上版本,先跑通安装与基本空间查询,再深入函数与项目实战。

PostGIS 将空间几何数据存入 PostgreSQL 并支持空间分析的概念示意

如何快速安装 PostGIS

安装要解决的核心问题是:让 PostgreSQL 能识别 geometry/geography 类型,并加载空间函数。优先保证 PostgreSQL 主版本与 PostGIS 包匹配,不要在默认 postgres 库里装扩展,单独建业务库。

推荐三种常见路径(任选其一即可上手):

  1. Docker(最快验证):拉取官方镜像如 postgis/postgis:18-3.7,启动后进入容器创建库并执行 CREATE EXTENSION。适合本机不想折腾依赖的情况,详细一键脚本与 GDAL 联调可参考本站Docker 一键部署 GDAL 与 PostGIS 教程(含镜像脚本)。
  2. Ubuntu/Debian(生产常用):先配置 PGDG 源,再安装对应主版本的 postgresql-XX-postgis-3 与 postgis 包,新建数据库后执行 CREATE EXTENSION postgis;(按需再加 postgis_raster、postgis_topology、postgis_sfcgal)。
  3. Windows:用 EnterpriseDB 安装器 + StackBuilder 选 PostGIS Bundle,或下载官方 Windows Bundle 安装器,安装后同样 CREATE EXTENSION。

启用后立刻验收:

  • 执行 SELECT postgis_full_version(); 或 SELECT PostGIS_Version(); 能看到版本号即成功。
  • 确认 PostgreSQL ≥14、GEOS ≥3.10(全功能建议更高)、Proj ≥6.1;栅格需 GDAL。
场景 推荐方式 关键注意
快速试用 / 教学 Docker 官方镜像 注意 2026 年 10 月起 Debian 镜像基线变化,升级可能影响文本索引
Linux 服务器 PGDG apt/yum 包 包名带 PostgreSQL 主版本号,勿混装
Windows 桌面 StackBuilder 或 Bundle Bundle 通常含 raster、topology、SFCGAL、pgRouting 等

升级 PostGIS 3 系列时,装好新二进制后执行 SELECT postgis_extensions_upgrade();。3.7.0 起不再支持 PostgreSQL 12/13 和过旧 GEOS,topology 相关默认值也有调整,升级前请对照发布说明。

官方中文文档与在线 Workshop 怎么用

中文学习路径已经比较完整,不必先啃英文。官方提供 PostGIS 3.7 简体中文手册(HTML/PDF 等)以及 cheat sheets,覆盖安装、数据类型、空间函数、栅格、拓扑等。入门动手则直接跟官方 Workshop「Introduction to PostGIS」中文简体版,按章节导入示例数据、写 SQL、看结果。

PostGIS 3.7 官方简体中文手册页面示例
PostGIS 3.7 官方简体中文手册页面示例(截图来源:postgis.net)

建议学习顺序:

  1. 先浏览PostGIS 3.7 中文手册里的安装与入门章节,弄清 geometry 与 geography 区别、SRID、空间索引。
  2. 打开官方 Getting Started,对照自己系统完成安装与 CREATE EXTENSION。
  3. 跟着 Workshop 中文版做完整练习(加载 shapefile、空间关系判断、缓冲与叠加),GitHub 仓库有源码可本地对照。
  4. 需要查函数签名时直接搜手册或 cheat sheet,比零散博客更准确。

官网总入口见 PostGIS 官方网站。手册与 Workshop 均为持续维护的正规渠道,翻译进度较高,遇到新函数以最新手册为准。

入门实操:建库、导数据、写第一条空间查询

装好后立刻做三件事:建专用库、启用扩展、导入一份矢量数据并验证空间查询。这样能确认环境、坐标系与索引都正常。

  1. 创建数据库(示例名 gisdb),连接后执行 CREATE EXTENSION postgis;,按需加 raster/topology。
  2. 用 shp2pgsql(或 ogr2ogr)把 Shapefile 导入,指定正确 SRID(如 4326 或项目实际坐标系),并创建 GIST 空间索引。
  3. 写简单查询验收:ST_AsText、ST_Intersects、ST_DWithin、ST_Buffer、ST_Area 等。先查点数、再做缓冲与相交,确认结果合理。
  4. 在 QGIS 里连上同一库,叠加底图目视检查坐标是否偏移。

常见验收标准:

  • postgis_full_version() 输出含 3.7.x 且依赖库版本符合预期。
  • 导入表有 geometry 列,ST_SRID 正确,空间索引存在。
  • 缓冲/相交查询能在合理时间内返回,结果与 QGIS 目视一致。

本地环境若还要联调 GDAL 读写与容器编排,可直接复用本站Docker 部署 GDAL 与 PostGIS 的镜像与脚本说明,减少路径和版本冲突。

版本选择、破坏性变更与踩坑预防

选版本时盯住两件事:PostgreSQL 主版本支持范围,以及 GEOS/Proj/GDAL 是否够新。PostGIS 3.7.0 是当前主要版本,修复了 3.6.4 以来的问题并加入 ST_IsSimpleDetail、ST_CoverageEdges、ST_MinimumSpanningTree、NURBSCurve 等能力;同时移除了对 PostgreSQL 12/13 与 GEOS < 3.10 的支持,部分 topology 默认值行为变化,address_standardizer 与 tiger geocoder 也已移出核心。

  • 新项目:直接上 3.7 + 匹配的 PostgreSQL(14–19 区间,以实际包为准)。
  • 旧库升级:先备份,再装新二进制,调用 postgis_extensions_upgrade(),并重点回归 topology、栅格与自定义脚本。
  • 不要混用不同 PostgreSQL 头文件编译出的扩展,否则会出现诡异报错。

安装与运行常见坑:版本不匹配、在默认库装扩展、SRID 忘设导致“坐标看起来对但空间关系全错”、Docker 升级后文本索引异常。遇到奇怪错误先 SELECT version(); 与 postgis_full_version(); 对照包管理器里的实际版本。

常见问题

PostGIS 中文教程去哪找最靠谱?

优先官方 3.7 简体中文手册和 Introduction to PostGIS Workshop 中文版,函数说明与示例最完整;再配合 Getting Started 安装指南,比散落博客更不容易过时。

Docker 和系统包哪个更适合入门?

入门与教学优先 Docker,环境干净、可随时销毁;要长期跑服务器或与现有 PostgreSQL 共存再用 PGDG 系统包。两者都要单独建库并 CREATE EXTENSION,验收方式相同。

CREATE EXTENSION 报错或函数找不到怎么办?

先确认装的是与当前 PostgreSQL 主版本对应的 postgis 包,并在目标业务库(而非 postgres 库)执行;然后查 postgis_full_version()。若刚升级,执行 postgis_extensions_upgrade() 并重启会话再试。

学完基础下一步做什么?

把一份真实小项目数据(行政区、道路或兴趣点)导入,练习空间索引、缓冲与叠加,再用 QGIS/GeoServer 连库出图或发布服务,把 SQL 结果固化成可复查的图层与文档。

总结:学 PostGIS 中文入门,先装好 3.7 并跑通 CREATE EXTENSION 与一条空间查询,再系统跟官方中文手册和 Workshop。建议今天就用 Docker 或本机包建一个 gisdb,导入一份 Shapefile 验证索引与缓冲;环境搭建可直接参考本站 Docker 教程,后续查函数以官方中文手册为准,避免被过时文章带偏。