简介面向GIS数据处理人员这套ArcGIS环境下的shp与txt双向转换工具用于Shapefile矢量数据与文本文件的互转可支持占补平衡分析、坐标系统核查、跨系统数据交换等场景操作门槛不高GIS分析师可直接按文档使用有Python基础的开发者还可修改脚本。工具包共11个文件压缩后仅317KB含.tbx工具箱、.py脚本、.docx使用说明、WKID坐标列表、XML配置及dictionaries配置目录使用说明讲清参数与输出格式WKID列表可核对投影坐标系避免转换后位置偏移。已有1730人学习下载适合需要批量整理矢量数据、制作文本报表或准备外部系统导入的用户。资源附带的Python脚本与完整工程文件能帮助理解shp字段读取、占补平衡面积校验和txt生成流程TxtToShp工具还可反向用文本批量创建Shapefile用于快速构建点线面、补录图斑及数据入库预处理减少手工转换和坐标排查时间。1. 不是复制粘贴是把 shp 属性表变成能直接用的 txt做 GIS 数据交换的人十有八九都经历过这种场面甲方发来一个 shp你打开属性表想导成 txt 给后端清洗结果右键导出的 dbf 打开乱码复制粘贴到文本编辑器里列还错位。这个“shp转txt arcgis工具箱”其实就是解决这个尴尬它把 ArcGIS 里的要素类属性表按你指定的字段、分隔符和编码输出成纯文本落地就是数据结构清晰、外部程序能直接读的 txt 数据集。适合三类人频繁做数据入库和交换的实施工程师、需要给内部系统投喂点位数据的开发同学以及被 Excel 打开 shp 属性表折磨过的数据处理新手。它能省掉你每次手动整理字段顺序、补分隔符、处理编码的一整套琐碎动作把操作收敛成一个双击就能填参数的工具。2. 拆解这个工具箱原理、参数设计与为什么不用手动导出2.1 工具箱到底帮你做了什么常见做法是打开属性表全选复制然后粘贴到 Excel 或文本编辑器里。这个过程看着快实际上有三层损耗第一层是字段顺序不可控属性表里字段默认按创建顺序排你想要的“ID、X、Y、名称”往往要手动拖列第二层是导出后的编码不可控ArcMap 默认环境下复制的数据到 Excel 里经常是乱码第三层是分隔符不可控你把数据粘进 CS 程序或 SQL 里时还得再把逗号、制表符、换行统一一遍。这个工具箱就是用 arcpy 的 SearchCursor 把上述动作一次性收敛到参数面板里你想输出哪些字段、用什么分隔符、用什么编码、要不要表头全部由参数决定结果是一份完全可预测的 txt 文件。另一个常见做法是直接用“表转 Excel”工具输出 xls。这个工具的问题在于xls 是老格式行数上限 65535数据集一多就爆掉而且很多目标系统只认 txt。相比之下txt 是纯文本、体积小、可裁剪、可用任何编辑器检查中间层格式越少出错面越小。2.2 核心实现逻辑SearchCursor 与逐行写出工具箱背后的核心逻辑并不复杂就是遍历要素类的每一行把指定字段的值按分隔符拼接逐行写入目标 txt 文件。我一般会用 arcpy.da.SearchCursor原因是它比老的 arcpy.SearchCursor 快得多尤其数据量在十万行以上时差距非常明显。# -*- coding: utf-8 -*- import arcpy def shp_to_txt(in_features, fields, delimiter, out_txt, encodingutf-8, headerTrue): 核心转换函数把要素类属性表导出为 txt in_features: 输入要素类或 shp 路径 fields: 要导出的字段名列表逗号分隔传字符串后再拆分 delimiter: 分隔符支持逗号, 制表符\\t 等 out_txt: 输出 txt 文件路径 encoding: 输出编码常见 utf-8 / gbk header: 是否在第一行写入字段名 field_list [f.strip() for f in fields.split(,)] if isinstance(fields, str) else list(fields) with open(out_txt, w, encodingencoding, newline) as f: if header: f.write(delimiter.join(field_list) \n) cursor arcpy.da.SearchCursor(in_features, field_list) for row in cursor: # 把每一行字段值转成字符串None 值写成空字符串而不是 None line delimiter.join([ if v is None else str(v) for v in row]) f.write(line \n) del cursor逻辑说明arcpy.da.SearchCursor的第一个参数是要素类路径第二个参数是字段名列表。这里把 None 显式转成空字符串是为了避免外部程序读到字符串None后误判数据类型。newline是为了避免在 Windows 下写出重复的\r\n因为 Python 的 open 在这种模式下会做换行符转换重复转一次会让有些行后多一个空行。参数说明fields我这里设计成逗号分隔的字符串方便在 ArcGIS 工具界面里用一个文本框接收delimiter传\\t表示制表符传,表示逗号encoding默认utf-8但如果你最终要把 txt 拿到旧版 Excel 或其他 Windows 老软件里打开建议加一个带 BOM 的 utf-8即utf-8-sig这样 Excel 打开就不会乱码。2.3 为什么用工具箱而不是独立脚本到这里你可能会问既然核心代码就十几行直接到 IDLE 里跑不就行了原因有三个。第一是参数记忆成本脚本每次跑都要改路径、字段、分隔符改一次错一次把参数封装成工具箱对话框后字段可以从要素类下拉选择分隔符可以直接选不需要记参数顺序。第二是字段校验工具箱里把字段参数类型设为FieldArcGIS 会自动从输入要素类读取可用字段列表你不需要手写字段名手写容易拼错拼错了 SearchCursor 会直接报错。第三是可交付性你可以把这个工具箱文件直接传给同事对方在 ArcGIS 里双击加载就可以用不需要搭建任何 Python 环境。这三层价值比代码本身更能决定这个工具在团队里能不能被实际用起来。一个没人愿意填参数的工具最终只会在你电脑里吃灰。2.4 工具箱参数设计的推荐配置参数设计直接决定这个工具箱好不好用。我经验里最稳的参数组合是这样的参数数据类型方向默认值说明输入要素类要素类/图层输入无支持 shp、gdb 要素类、图层导出字段多值字段字符串输入无用 ArcGIS 的“多值”参数类型界面支持多选分隔符字符串输入逗号提供可选值逗号、制表符输出 txt 文件文件输出派生用户指定路径编码字符串输入utf-8-sig提供可选值utf-8、utf-8-sig、gbk是否写表头布尔型输入true勾选后首行输出字段名这里面最容易踩坑的是“是否写表头”建议默认勾上。很多外部程序读 txt 时靠表头定位字段你漏了表头对方就得多传一份字段清单给你。另一个用途是 ArcGIS 的工具对话框支持从输入要素类下拉选择字段设置字段参数类型时把“字段列表类型”设为All这样用户就能从全部字段里勾选而不是手敲能避免字段名写错导致的运行时错误。2.5 坐标字段怎么处理很多人导 txt 不只是要属性还要坐标。这需要在工具箱里加一个可选的“导出几何”功能。常见做法是当用户在字段列表里没有勾选 Shape 字段时工具自动追加两个字段X和Y用 SearchCursor 的SHAPEXY取每行的质心坐标。cursor arcpy.da.SearchCursor(in_features, field_list [SHAPEXY]) for row in cursor: # row 的最后一个位置是 (x, y) 元组 values list(row[:-1]) x, y row[-1] values.append(f{x:.6f}) values.append(f{y:.6f}) line delimiter.join(values) f.write(line \n)这段代码里SHAPEXY是 Data Access 模块内置的几何占位符返回的是质的 (x, y)。注意小数点位数这里我写成了.6f常用于经纬度坐标如果你的数据是投影坐标系x、y 的值可能是几十万到几百万的量级.6f会输出大量冗余小数这时候改成.3f或直接用str(x)保留原始精度更合适。实操中我会根据工具箱用户的选择动态设置精度而不是写死。3. 安装与调用把工具箱挂到 ArcGIS 并完成一次导出3.1 工具箱的两种组织方式这个 shp 转 txt 功能一般会以两种形式分发一种是 ArcGIS 工具箱文件.tbx 或 .atbx里面挂了一个 Python 脚本工具另一种是 Python 工具箱.pyt整个工具逻辑写在单个文件里双击即可加载。.pyt 是更现代的做法因为在 ArcGIS Pro 3.x 时代.pyt 可以在 ArcMap 和 Pro 之间通用逻辑修改后刷新一下界面就能用不用像脚本工具一样反复设置参数映射。我在实际交付时通常会选 .pyt理由很直接一个文件包住所有逻辑不需要额外装任何第三方库纯 arcpy 就能跑。下面是 .pyt 的工具类骨架import arcpy class Toolbox(object): def __init__(self): self.label shp转txt工具箱 self.alias shptotxt self.tools [ShpToTxt] class ShpToTxt(object): def __init__(self): self.label shp转txt self.description 把shp属性表按指定字段、分隔符和编码导出为txt self.canRunInBackground False def getParameterInfo(self): # 定义工具参数 param0 arcpy.Parameter( displayName输入要素类, namein_features, datatypeFeature Layer, parameterTypeRequired, directionInput) param1 arcpy.Parameter( displayName导出字段, namefields, datatypeField, parameterTypeRequired, directionInput) param1.parameterType Optional param1.multiValue True # 允许多选 ... return [param0, param1, param2, param3, param4, param5] def execute(self, parameters, messages): # 从界面取出参数值调用转换函数 ...说明.pyt里每个工具继承一个对象getParameterInfo负责定义工具界面的参数execute负责执行入口。这里字段参数设成Field类型之后ArcGIS 会自动根据输入要素类填充可选字段这是它比普通字符串参数稳的原因。multiValue True允许多选否则一次只能导出单列。当你双击 .pyt 时ArcGIS 会自动加载工具箱在目录里展开就能看到工具。不需要额外安装也不需要注册 Python 环境这在整个数据交换工具链里是最轻量的一环。3.2 在 ArcMap 里跑通一次导出的完整操作这里给你一套我从头到尾的操作路径照着走一般十分钟内能出结果第一步打开 ArcMap 或 ArcGIS Pro在“目录”面板里连接到你的工具箱文件双击打开工具对话框。第二步输入要素类选你的 shp 文件字段列表勾选需要的属性字段。第三步分隔符选制表符如果有字段内容本身可能包含逗号制表符优先于逗号。第四步输出 txt 文件路径指定到一个新建文件夹编码选 utf-8-sig。第五步勾选“写表头”然后点确定。工具跑完后到指定路径打开 txt首行是字段名下面是每行记录。我建议你第一件事不是打开看内容而是文本编辑器里把显示“所有字符”开关打开确认每行结尾只有一个换行符列之间确实是制表符。这一步在视觉上不容易发现但直接影响后续程序读取。3.3 在 ArcGIS Pro 里跑通一次导出的差异点ArcGIS Pro 3.x 和 ArcMap 用这个工具有几个差异点需要注意。第一个差异是 Python 版本Pro 内置 Python 3.xArcMap 是 Python 2.x。如果在 ArcMap 里用代码里不能用 f-string格式化需要用.format()或%。我给的示例里用的都是兼容写法但如果你自己二次开发要留意这一点。第二个差异是路径Pro 里推荐输入要素类直接用 URL也就是.gdb或.sde里的数据shp 路径也支持但 shp 文件名里的空格和中文在 Pro 3.x 下偶发路径解析异常这种情况用 arcpy.env.workspace 切换工作空间更稳。第三个差异是工具箱更新的刷新逻辑在 Pro 里改了 .pyt 代码需要右键刷新工具箱才能看到最新改动有时反复刷新还是不生效干脆移除再重新添加一次。还有一个经常被忽视的问题工具执行时 ArcMap 会弹出后台运行的提示如果你勾选了“后台执行”工具会异步执行对话框马上关闭但日志输出窗口还在跑。新手容易误以为工具出错了又点一次导致重复导出。我的习惯是默认关掉后台执行让工具同步跑完再关对话框。3.4 验证结果怎么看输出正确与否输出正确性验证是个技术活不仅仅是打开看一眼。我会做三层验证。第一层是行数核对用文本编辑器的行数统计对比属性表的记录数第二层是字段数核对每一行的字段数应该一致不一致大概率是数据里本身有换行符这个坑后面会细说第三层是首尾记录核对把属性表按导出字段排序后的第一行和最后一行与 txt 里的第一行和最后一行对比。这里有个小技巧我会在导出完成后临时改一下工具代码在结尾打印一个总行数到地理处理消息窗口arcpy.AddMessage(f共导出 {count} 行数据)arcpy.AddMessage输出的内容会显示在 ArcGIS 的地理处理“查看详情”窗口里这是排查导出是否完整的最快路径。如果数目对不上多半是 SearchCursor 在遍历时被要素类中的“空几何”弄懵了后面会在避坑部分展开。4. 常见问题与排错乱码、空值、坐标不明三组实战坑4.1 坑一txt 用 Excel 打开中文全部变成乱码现象导出时明明选的是 utf-8用记事本打开正常用 Excel 双击打开直接显示乱码。原因Excel 在打开 utf-8 无 BOM 的文件时默认按 ANSI 代码页中文系统下是 GBK解码utf-8 的字节流当然读不出中文。解决把编码选项统一改成utf-8-sig这个编码会在文件开头写入一个 BOM 头Excel 会识别 BOM 并按 utf-8 解析。如果工具没有提供编码选项就在代码里把encodingutf-8改成encodingutf-8-sig。如果你要喂给 Linux 后端程序bom 可能反而干扰解析那就得用无 BOM 的 utf-8并在交付说明里写清楚这一点。这个坑我几乎每次跟新人协作都会遇到后来我的习惯是工具界面把编码选项的默认值直接设成“utf-8-sig”并在说明文档里写一行“给 Excel 用选 utf-8-sig给程序用选 utf-8”。4.2 坑二导出后某些行的列数比其他行少一列现象导出数据后用程序读取报错说某一行字段数不对。排查发现该行的字段值是一个很长的文本里面含有换行符。原因要素类属性里的文本字段可以包含换行符这是合法的。SearchCursor 把带换行的文本原样读出后写入 txt导致这行在视觉上被拆成两行后续程序按换行符拆记录时就把文字截断了。解决导出时对文本字段的换行符做替换把\n和\r\n替换成空格或\\n保证一条记录物理上占一行。在代码里加一个清洗函数def clean_value(v): if v is None: return s str(v) return s.replace(\r\n, ).replace(\n, ).replace(\t, )这段代码把文本里的换行和制表符统一替换成空格。代价是数据里的原始换行信息丢失但对于大多数数据交换场景这个代价可以接受——后端系统更关心字段是否对齐而不是文本里的格式。如果你确实需要保留换行就得把每条记录用一对引号包起来并告知下游按带引号的 CSV 格式解析复杂度会上升不少。4.3 坑三导出的 X、Y 字段数值很大不是经纬度现象导出的 txt 里坐标是(512345.678, 3456789.012)这种量级的数字拿去做地图匹配完全对不上。原因shp 本身自带坐标系如果 shp 是投影坐标系比如 Gauss-Kruger 或 UTMSearchCursor 的SHAPEXY返回的就是投影坐标而不是经纬度。很多使用者不知道这一点只看数字就误以为是经纬度。解决在工具里增加一个“输出坐标类型”参数可选“原始坐标系”和“WGS84经纬度”。如果选后者代码里要把几何投影转换后再取出 XYfrom arcpy import arcpy sr_wgs84 arcpy.SpatialReference(4326) cursor arcpy.da.SearchCursor(in_features, [SHAPE]) for row in cursor: geom row[0] if geom is not None: geom_wgs84 geom.projectAs(sr_wgs84) x, y geom_wgs84.centroid.X, geom_wgs84.centroid.Y else: x, y , 这段代码里projectAs会把任意几何投影到 WGS84 坐标之后再取质心坐标。要留意的是转换本身有性能开销数据量大到几十万条时额外耗时可能从秒级到分钟级。我通常会在对话框里给一个复选框“坐标转为经纬度”默认不勾选需要的人自己勾避免给不需要的人增加等待。还有一个细节空几何比如 shp 里某些要素几何缺失在 SearchCursor 里返回的是None取.centroid会直接报错所以上面代码里判断了geom is not None否则工具会中断。4.4 坑四导出 GBK 编码的文件偶尔报错 UnicodeEncodeError现象选择 gbk 编码导出后跑到一半报错UnicodeEncodeError: gbk codec cant encode character。原因shp 字段里存在 GBK 字符集不支持的字符常见于某些生僻字或特殊符号。GBK 是中文环境的本地编码并非所有 Unicode 字符都覆盖得到。解决工具里预设一个“出错字符替换规则”在写出前把不可编码的字符替换成?。或者改回 utf-8 编码utf-8 能覆盖所有 Unicode 字符但 Excel 打开体验差一点。更稳妥的做法是在 getParameterInfo 里把编码参数默认值设为 utf-8-sig让 gbk 成为一个可选项而不是默认项这样绝大多数场景不会触发这个错误。如果确实必须输出 gbk比如目标系统是老旧 Windows 程序硬性要求则用下边这段安全写出def safe_write(f, text, encoding): try: f.write(text \n) except UnicodeEncodeError: # 替换掉无法编码的字符 fallback_text text.encode(encoding, errorsreplace).decode(encoding) f.write(fallback_text \n)逻辑说明errorsreplace会把无法编码的字符替换成?既保证程序不中断又能提示使用者“这里有异常字符”。我一般还会配合arcpy.AddWarning把出错行号打出来方便事后溯源哪一条数据不规范。这个坑是我跑某次历史数据清洗时踩过的那批数据里有大量古地名生僻字当时如果没用 replacement 机制整个导出流程会卡死在中间记录又得从头跑。5. 进阶用法批量转出与坐标点模式让工具从单次操作变成流水线5.1 批量遍历文件夹下所有 shp实际数据交换中经常不止一个文件要转几十个 shp 挨个点工具对话框是很崩溃的。我给这个工具箱加过一个批量模式指定一个根文件夹遍历所有子文件夹里的 .shp 文件每个 shp 按相同规则导出成同名 txt。实现方式是做一个小脚本调用之前的导出函数import arcpy, os def batch_shp_to_txt(work_dir, out_dir, delimiter\t, encodingutf-8-sig, fields*): # 遍历根目录下所有 shp for root, dirs, files in os.walk(work_dir): for f in files: if f.lower().endswith(.shp): shp_path os.path.join(root, f) txt_name f.replace(.shp, .txt) txt_path os.path.join(out_dir, txt_name) try: shp_to_txt(shp_path, fields, delimiter, txt_path, encoding) arcpy.AddMessage(f完成: {shp_path} - {txt_path}) except Exception as e: arcpy.AddWarning(f失败: {shp_path}, 原因: {e})这段代码的逻辑是递归遍历目录只要是 .shp 后缀就交给前边的导出函数。这里有个我自己的习惯批量跑的时候不中途退出而是把失败文件记到一个 log 文件里等全部跑完再看清单。因为批量场景往往是一个或多个 shp 本身有问题为了一个坏文件停掉全部不划算。日志可以用一个简单列表收集最后统一写errors [] # ... 在 except 里 errors.append(f) with open(os.path.join(out_dir, errors.log), w) as log: log.write(\n.join(errors))参数说明fields*表示导出全部字段如果只需要部分字段可以传字段名列表。注意有些 shp 里字段名长度超过 10 个字符会被截断这是 shapefile 格式本身的限制所以批量模式下fields*往往会遇到一个麻烦——导出字段名和你在 ArcMap 属性表里看到的字段名不一致。这种情况建议配合一个外部 txt 配置文件里写明每个文件要导哪些字段或者接受“全部字段”方案不裁剪。5.2 导出坐标点模式只出坐标不出属性有些场景下你只需要每个要素的坐标点比如给 GPS 设备生成兴趣点列表、给测绘软件展点位。原工具的核心逻辑是遍历所有字段但为了更简洁的 txt 输出我加了一个“坐标点模式”一行一个点格式固定为序号,X,Y,属性1,属性2。这个模式的实现是在导出函数里加一个开关if point_mode: with open(out_txt, w, encodingencoding, newline) as f: if header: f.write(ID,X,Y\n) cursor arcpy.da.SearchCursor(in_features, [SHAPEXY]) for i, row in enumerate(cursor, start1): x, y row[0] f.write(f{i},{x:.6f},{y:.6f}\n)这段代码跳过了属性字段遍历只用SHAPEXY取坐标速度比全属性导出快很多几十万条点数据大约能在几十秒内完成。使用场景很清晰你手上是一个点要素类只需要坐标列表不关心字段值。这个模式和完整属性模式互不冲突工具里加一个下拉开关即可。5.3 自定义表头与前置说明行给外部系统投喂 txt 时对方往往要求在文件开头有几行注释说明比如“此文件由 XX 系统导出”“坐标系WGS84”“日期2024-xx-xx”。默认导出只写字段名行没有说明行这会导致外部程序读文件时报“首行不是字段定义”的错误。我后来在工具里加了一个可选的“说明行”文本框用户在界面填写任意内容后工具会先写说明行再写表头if note_line: f.write(# note_line \n) if header: f.write(delimiter.join(field_list) \n)逻辑说明说明行用#开头是常见约定大多数解析程序会自动忽略#开头的行这样既保留说明信息又不干扰程序解析。如果你对接的程序是自己写的记得在读取逻辑里加上跳过#开头的行不然会把注释当数据。5.4 最后一道防线备份与版本自查这个工具调整过很多轮之后我自己养成了一个固定习惯每次改完代码先在三个不同环境里各跑一遍一个纯中文路径的 shp、一个带空格和中文的 shp、一个几十万行的点数据集。每次跑完都要核对三件事行数等于原始要素数、字段数一致、首尾记录一致。从那以后我每次写 shp 转 txt 的工具都强制自己走完这套验证流程顺手把验证命令写成一个小脚本存到工具箱旁边下次交接给同事时对方不用问我“这个工具靠不靠谱”直接跑一遍验证脚本就知道结果。希望这个工具和这篇文章里提到的坑能帮你在下一次数据交换时少走几步弯路。本文还有配套的精品资源点击获取