PostGIS 必须与 PostgreSQL 主版本严格匹配安装，通过系统包管理器配对或同源编译；启用需用超级用户在目标库执行 CREATE EXTENSION postgis;，并验证 search_path、schema 及 postgis.control 版本一致性。
PostGIS 不能直接“安装插件”——它必须和 PostgreSQL 同版本编译或通过系统包管理器配对安装，否则 CREATE EXTENSION postgis 会报错（常见如 could not open extension control file 或 version mismatch）。
确认 PostgreSQL 版本与源匹配
PostGIS 严格绑定 PostgreSQL 主版本（如 14.x、15.x、16.x），小版本不兼容也会失败。别只看 postgres --version，得查实际安装来源：
- 用
pg_config --version确认正在使用的 PostgreSQL 构建版本 - 若用系统包安装（如 Ubuntu 的
postgresql-15），必须装对应postgresql-15-postgis-3（不是postgis或postgis-3） - 若从源码编译 PostgreSQL，PostGIS 必须用同一份
pg_config路径编译：./configure --with-pgconfig=/usr/local/pgsql/bin/pg_config - 检查
pg_config --pkglibdir输出路径下是否存在postgis.so，没有就说明没装对包
在数据库中启用 PostGIS 扩展的正确顺序
即使包已装好，CREATE EXTENSION 仍可能失败——关键在权限、模板库、依赖顺序：
- 必须用
postgres超级用户或有CREATEDB权限的用户连接目标数据库（不是template1或postgres库本身） - 先运行
CREATE EXTENSION postgis;，再运行CREATE EXTENSION postgis_topology;（如果需要拓扑支持） - 若提示
function geometry_lt does not exist，说明扩展未加载成功，立刻查SELECT * FROM pg_extension;看状态 - 不要在
template1上执行；想让新库自动带 PostGIS？改template1前先UPDATE pg_database SET datistemplate = false WHERE datname = 'template1';，操作完再设回 true
验证是否真正可用（别只信 CREATE EXTENSION 成功）
很多用户卡在“扩展创建成功但函数不可用”，本质是 search_path 或 schema 权限问题：
- 执行
SHOW search_path;，确保包含public（或你指定的 postgis 安装 schema） - 运行
SELECT ST_AsText(ST_Point(1, 1));—— 返回POINT(1 1)才算通路 - 若报
function st_astext does not exist，检查SELECT extnamespace::regnamespace FROM pg_extension WHERE extname = 'postgis';，输出不是public就得加 schema 前缀：SELECT public.ST_AsText(...) - 用
\dx+在 psql 里看扩展详情，重点关注Version和Schema两列是否一致
最常被跳过的一步：PostGIS 安装后，postgis.control 文件必须落在 $PGSHARE/extension/ 下，且内容里的 default_version 要和实际安装的 SO 文件版本号完全一致（比如 3.3.2 对应 postgis--3.3.2.sql）。差一个字符，CREATE EXTENSION 就静默失败。
