PostGIS导入Shapefile?shp2pgsql怎么用?

“shp2pgsql命令不存在？”——别慌，这是你导入Shapefile前必踩的坑

上周一位在国土规划院实习的研究生私信我：“Dr. Gis，我用PostGIS导入.shp文件，终端敲shp2pgsql提示‘command not found’，是不是我电脑坏了？”——其实不是电脑坏了，是你还没装对工具包。我在参与某智慧城市底图项目时，也见过团队里三个新人同时卡在这个报错上。今天，我就手把手带你打通这条“数据入库存”的任督二脉。

为什么非要用shp2pgsql？不能直接拖进去吗？

很多人刚接触PostGIS，第一反应是：“能不能像MySQL那样，找个图形界面点几下就导入？”——理论上可以（比如用pgAdmin或QGIS），但实际工程中，shp2pgsql才是王道。原因有三：

1. 批量处理能力强：几十上百个shp文件？一条脚本全搞定。
2. 控制粒度精细：你可以指定SRID、字段编码、几何类型，甚至自定义表结构。
3. 性能稳定可靠：底层直接调用PostGIS C函数，比GUI少一层封装，出错率更低。

类比一下：把Shapefile导入PostGIS，就像把散装乐高积木放进带编号的收纳盒。shp2pgsql就是那个帮你按图纸分类、贴标签、压紧实的智能分拣机——手动一个个放？当然行，但效率和准确性天差地别。

实战第一步：安装与环境配置（Linux/macOS/Windows通用）

shp2pgsql不是独立软件，它是PostGIS扩展包的一部分。如果你没装PostGIS，或者只装了PostgreSQL没装空间扩展，就会报“命令未找到”。

Linux (Ubuntu/Debian为例)：

sudo apt-get install postgis postgresql-XX-postgis-scripts
# XX替换为你的PostgreSQL主版本号，如14

macOS (Homebrew)：

brew install postgis

Windows：推荐使用PostGIS Bundle for Windows，它会自动配置好所有依赖。

安装完成后，在终端输入：

shp2pgsql -v

如果看到版本号（如“Release 3.4.0”），恭喜你，环境配好了！

核心语法拆解：一行命令背后的五个关键参数

shp2pgsql的基本格式如下：

shp2pgsql [选项] 输入.shp [模式名.]表名 | psql -h 主机 -U 用户 -d 数据库

看着复杂？我们拆成五块“积木”：

真实案例：导入全国省界Shapefile并建立空间索引

假设你有一个叫china_province.shp的文件，坐标系是WGS84（EPSG:4326），字段含中文，想导入到本地PostgreSQL的gisdb库中，表名叫provinces。

完整命令如下：

shp2pgsql -s 4326 -I -W GBK -d china_province.shp public.provinces | psql -h localhost -U postgres -d gisdb

逐段解释：

• -s 4326：告诉PostGIS，原始数据是WGS84经纬度。
• -I：导入后自动CREATE INDEX，加速后续空间查询。
• -W GBK：避免省份名称出现乱码（如“广东省”变成“骞垮笗鐪?）。
• -d：如果表已存在，先DROP再重建——适合调试阶段。
• public.provinces：指定模式（schema）和表名，不写模式默认是public。
• | psql ...：通过管道直接执行生成的SQL，免去中间保存.sql文件的麻烦。

执行成功后，你会看到类似“INSERT 0 34”的提示，表示插入了34条记录（中国34个省级行政区）。

避坑指南：三大高频报错与解决方案

根据我带过上百人的经验，90%的失败集中在以下三点：

1. 报错：ERROR: type "geometry" does not exist
   → 你没在目标数据库启用PostGIS扩展！登录数据库后执行：
   

   CREATE EXTENSION postgis;

2. 报错：Unable to convert data value to UTF-8
   → 字符编码不对。试试-W GB18030或-W LATIN1，实在不行用QGIS重导一份UTF-8编码的shp。
3. 报错：Connection refused
   → 检查psql连接参数：主机名、端口、用户名、密码、数据库名是否正确。Windows用户注意：PostgreSQL默认只监听localhost，远程连接需改pg_hba.conf。

进阶技巧：生成SQL脚本而非直接执行

有时候你不想直接入库，而是想先看看生成的SQL长什么样（比如要修改字段类型或加触发器）。去掉管道符，重定向到文件即可：

shp2pgsql -s 4326 china_province.shp provinces > import.sql

然后用文本编辑器打开import.sql，你会发现它其实就是一堆标准的CREATE TABLE和INSERT INTO语句——这正是shp2pgsql的底层逻辑：它不直接操作数据库，而是生成SQL，再交给psql执行。

总结：shp2pgsql的本质是“翻译官+搬运工”

记住这个公式：
Shapefile（文件系统）→ shp2pgsql（翻译成SQL）→ PostgreSQL（执行并存储）

掌握了它，你就打通了从桌面GIS到空间数据库的关键链路。下次遇到“海量地块数据入库慢”、“属性表中文乱码”、“空间查询卡顿”等问题，你就能从根源上解决，而不是在QGIS里一遍遍重试。

你在用shp2pgsql时踩过什么坑？或者有什么骚操作想分享？评论区留下你的故事，点赞最高的三位，我送你《PostGIS实战秘籍》电子书一份！