PostGIS 官网入口与官方文档

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

PostGIS 官网入口是 https://postgis.net/(www.postgis.net 同样可用),旧站点 postgis.org 已自动指向这里,最新软件与文档都在此维护。官方文档集中在 文档中心,包含 Getting Started、官方手册(支持简体中文 zh_Hans)、FAQ 与培训材料。截至 2026 年 11 月,最新稳定版为 PostGIS 3.7.0(2026 年 10 月 30 日发布),直接从官网即可获取发布说明、多语言手册与安装指南。

PostGIS 官方网站首页,展示空间扩展介绍与主导航
PostGIS 官方网站首页,展示空间扩展介绍与主导航(截图来源:postgis.net)

PostGIS 官网入口怎么找、相关页面有哪些

找官网时只认 postgis.net 域名即可,避免被过时镜像或非官方站点误导。主站清楚说明:PostGIS 是 PostgreSQL 的空间扩展,用于存储、索引和查询点、线、多边形等地理空间数据(支持 2D/3D),并提供距离、相交、缓冲等空间函数,以及栅格、拓扑与地理编码能力,可与 QGIS、GeoServer、MapServer 等工具配合。

  • 新闻与发布页:查看版本更新、破坏性变更与推荐依赖组合。
  • 文档中心:入门、手册、FAQ、培训材料与开发文档的统一入口。
  • 问题报告:用户邮件列表与 Ticket Tracker;安全问题单独发至 security@postgis.net。
  • 源码与下载:OSGeo 下载目录或 Git 仓库(含 GitHub/GitLab 镜像),提供 tar.gz 源码包。

打开主站后,顶部导航即可跳到文档、新闻与安装相关页面。确认地址栏是 postgis.net 后,再继续查阅手册或下载,可减少版本错配风险。

官方文档怎么查阅(含中文手册)

文档中心把内容分成几块,动手安装前建议按顺序看:先 Getting Started(启用与各平台安装),再 Official Manual(函数与参考),遇到疑惑查 FAQ,需要系统学习可看 Training Materials。

  • Getting Started:覆盖 Docker、macOS、OpenSUSE、Red Hat、Ubuntu/Debian、Windows 安装与升级说明。
  • 官方手册:已发布分支提供 HTML、PDF、EPUB;开发中版本(当前指向 3.8)支持多语言,含 zh_Hans(简体中文)。稳定版 3.7 手册同样有 en、ja、zh_Hans、fr 等在线 HTML,并附 postgis、raster、topology、sfcgal 等速查表。
  • FAQ:常见问题包括栅格导入导出、坐标重投影、空间索引用法、geometry 与 geography 区别、PgAdmin 几何列空白、相交结果异常等。
  • 中文资源:手册有 zh_Hans 翻译,另有中文工作坊材料;翻译通过 OSGeo Weblate 进行。
PostGIS 官方文档中心页面,列出入门指南、手册与 FAQ 入口
PostGIS 官方文档中心页面,列出入门指南、手册与 FAQ 入口(截图来源:postgis.net)

查阅时注意分支对应关系:生产环境优先看与当前安装版本匹配的手册(例如 3.7),开发版文档更新快但可能含未发布变更。中文版可直接降低函数参数与示例的阅读成本,复杂拓扑或栅格章节建议对照英文核对细节。

最新版 3.7.0 安装启用步骤与配置要求

要解决的问题很明确:在已有 PostgreSQL 上正确装上 PostGIS,并让空间函数可用。3.7.0 是主要发布,含自 3.6.4 以来的修复与新功能(如 ST_IsSimpleDetail、ST_CoverageEdges、ST_MinimumSpanningTree、栅格 Float16 支持等),同时移除了对 PostgreSQL 12/13 与 GEOS <3.10 的支持。

组件 3.7.0 要求 说明
PostgreSQL 14–19 需完整服务器头文件;推荐配合 19 RC1 测试
GEOS 3.10+ 全功能建议 3.15.0
Proj 6.1+ 坐标转换必需
GDAL 2.4+(优选 3+) 栅格支持;默认可能禁用部分驱动
其他 libgmp、LibXML2、Perl、iconv 等 可选 SFCGAL 2.3+、protobuf-c(MVT)
  1. 确认本机 PostgreSQL 版本在 14–19 区间,并已安装开发头文件与匹配的 GEOS/Proj/GDAL。
  2. 源码安装:从 OSGeo 下载目录获取 postgis-3.7.0.tar.gz,解压后执行 ./configure(可用 –with-pgconfig=、–with-gdalconfig=、–with-sfcgal 等),再 make && make install。包管理器用户按 Ubuntu/Debian(apt)、Red Hat(yum)、macOS(Homebrew)或 Windows(EnterpriseDB + StackBuilder / 官方 Windows 下载页)指南操作。
  3. 在目标数据库以超级用户执行:CREATE EXTENSION postgis; 按需再执行 CREATE EXTENSION postgis_raster;、postgis_topology;、postgis_sfcgal; 等。
  4. 验收:运行 SELECT PostGIS_Full_Version(); 或查询 pg_available_extensions,确认版本与依赖库信息正确。升级已有扩展时执行 SELECT postgis_extensions_upgrade();。

Windows 用户注意与 EnterpriseDB 发行版匹配;云托管 PostgreSQL 多数已预装,只需启用扩展。编译时若缺依赖,configure 会明确报错,按提示补齐即可。

PostGIS 将点、线、多边形等几何存入 PostgreSQL 并支持空间查询的概念示意

使用文档与安装时要注意什么

版本与依赖错配是最常见踩坑点。3.7.0 有几处破坏性变更:topology 函数中 tolerance 默认行为调整(0 真正为 0,-1 使用拓扑精度);address_standardizer 与 tiger_geocoder 已移出核心,改为独立仓库;ST_MemCollect 被移除。升级前先读发布说明,并在测试库验证。

  • 手册与二进制版本必须对应,避免把 3.8 开发文档里的新函数用到 3.7 生产库。
  • 栅格安全:部分 GDAL 驱动默认禁用,需按手册配置后才能导入特定格式。
  • 性能:大几何或高频空间连接时,合理设置 shared_buffers,并确保空间索引(GIST)已建。
  • 工具链:shp2pgsql、raster2pgsql、pgsql2shp 随安装提供,3.7 对 loader 参数做了增强(如 UNLOGGED、–if-not-exists)。

验收标准很简单:扩展创建成功、PostGIS_Full_Version() 输出含 3.7.0 与预期 GEOS/GDAL 版本、简单查询如 ST_Intersects 或 ST_Buffer 能返回正确结果。若结果异常,先查 FAQ 中“相交结果异常”“geography intersects”等条目。

常见问题

官网或文档页面打不开、跳到旧站点怎么办?

直接使用 postgis.net(或 www.postgis.net)。旧的 postgis.org 会重定向到新站点;若仍异常,可换网络或清除缓存后再访问文档中心。

如何快速确认当前数据库里的 PostGIS 版本与依赖?

在目标库执行 SELECT PostGIS_Full_Version(); 即可看到 PostGIS、GEOS、PROJ、GDAL 等完整信息。也可用 SELECT * FROM pg_available_extensions WHERE name = ‘postgis’; 查看是否可用。

PgAdmin 中几何列显示空白怎么处理?

几何数据较大时会超出单元格显示限制。改用 SELECT ST_AsText(geom) 或 ST_AsEWKT(geom) 查看文本表示,或在 QGIS 等客户端直接加载图层。

升级到 3.7.0 后扩展报错或函数行为变化怎么办?

先确认已安装匹配二进制,再执行 SELECT postgis_extensions_upgrade();。若涉及 topology tolerance 或已移除函数,按 3.7.0 发布说明调整脚本,并在测试库验证后再上线。

总结:PostGIS 官网与文档的权威入口就是 postgis.net 及其文档中心,最新稳定版 3.7.0 已支持简体中文手册。建议先按 Getting Started 完成安装并启用扩展,用 PostGIS_Full_Version() 做验收;日常查函数与排错优先对照对应版本的中文/英文手册和 FAQ,遇到安全或疑难问题再走官方报告渠道。