简介这份文档面向需要处理卫片图斑及大量地块出图任务的GIS从业者与ArcGIS初学者聚焦按图斑批量生成JPG/PNG图片的自动化方案帮助摆脱逐一手动出图的低效流程。内容围绕ArcGIS数据驱动页面与arcpy脚本展开涵盖图层与名称字段设置、排序和显示范围、比例尺与布局动态文本以及遍历页面导出图片、结果目录检查等环节并给出可直接套用的Python示例与参数调整思路。包内为1个doc文档压缩包约29KB体积轻便适合作为操作备忘或项目参考。已有8322人学习说明其在批量出图场景中具有一定实用参考价值。读者可据此理解卫片图斑批量出图的核心流程掌握动态信息展示与脚本导出方法并迁移到类似地块调查、巡查举证等制图任务中。1. 卫片图斑批量出图明明只有三个图斑却只出了两张某开发者接了个活一个卫片图斑层里躺着 1、2、3 三个图斑要求每个图斑出一张 JPG图名跟着图斑编号走。他翻出一段 ArcGIS 按图斑批量出图的脚本跑完打开输出目录只有两张图第三张怎么都不出现换到另一台机器上脚本第一行就直接报语法错误。这两件事都不是代码写错了而是卡在版本和前置配置上ArcGIS 9 里根本没有 Data Driven Pages数据驱动页面而 10.x 自带的是 Python 2.7跟现在随手搜到的 Python 3 写法对不上。这套环境在卫片核查、图斑台账、按村出图这类内业活里太常见了装不对的后果也很直接——跑一半停、图名乱码、最后一张永远缺。下面这套流程是按 ArcGIS Desktop 10.2 起的版本走的新手照着做能跑通老手可以只看版本取舍和排错部分。2. 环境准备ArcGIS Desktop 10.2 自带的 Python 2.7 才是执行环境动手装之前先把三件事定死桌面版装哪个大版本、脚本用哪个 Python 解释器跑、编辑器用什么。这三件事只要错一件后面配置数据驱动页面配得再漂亮脚本也跑不起来。2.1 三个版本变量桌面版、Python、arcpy很多人以为“装个 ArcGIS 就行”实际上决定批量出图能不能成的是三个互相绑定的东西。第一个是桌面版大版本Data Driven Pages 从 10.0 开始才有所以 9.x 直接排除10.2 及以上都可以10.2 胜在稳定、单位里存量机器多、网上能查到的 arcpy.mapping 写法基本都对得上。第二个是 Python 解释器10.x 安装时会把 Python 2.7 一起装进去位置一般在C:\Python27\ArcGIS10.2\这个解释器是独立的和你系统里另外装的 Python 3 完全没关系。第三个是 arcpy 模块它只存在于 ArcGIS 自带的那套 Python 里你用系统的 Python 3 去import arcpy一定报 ModuleNotFoundError。提示判断“我该用哪套写法”看模块名就够了。arcpy.mapping属于 Desktop 10.xarcpy.mp属于 ArcGIS Pro。两者函数名相似但参数不同复制粘贴时最容易在这里翻车。下面这张对照表是我自己贴在便签上的装环境前扫一眼能省不少时间对照项ArcGIS Desktop 10.2 ~ 10.8ArcGIS Pro分页出图机制Data Driven PagesMap Series地图系列脚本解释器Python 2.7随 Desktop 安装Python 3随 Pro 安装模块入口arcpy.mappingarcpy.mp读取文档arcpy.mapping.MapDocumentarcpy.mp.ArcGISProject导出函数ExportToJPEG/ExportToPNGexportToJPEG布局对象方法print 写法print mapName或print(mapName)必须print(mapName)在命令行里验证解释器对不对不需要打开 ArcMap一条命令就够C:\Python27\ArcGIS10.2\python.exe -c import arcpy; print(arcpy.GetInstallInfo()[Version])这段命令的意思是用 ArcGIS 自带解释器执行一段内联代码导入 arcpy 后打印安装信息里的版本号。能打出版本号说明 arcpy 可用路径写对如果提示No module named arcpy说明你调用的是别的 Python回去检查路径里ArcGIS10.2这一段是不是写成了ArcGIS10.8或者干脆指向了C:\Python39。这一步别偷懒后面所有报错里最难查的就是解释器错配。2.2 ArcGIS Desktop 的安装顺序与授权配置安装本身不难坑在于顺序和路径。常见做法是先确认机器上没有残留的其他版本 Desktop有就先卸干净不要两个大版本并存然后装授权管理组件再装 Desktop 主体。如果你的授权是浮动式的先装 License Manager 并在里面完成授权文件配置再装桌面端如果是单机版桌面端装完打开 ArcGIS Administrator选单机版并完成授权别一装完就去开 ArcMap授权没落地会反复弹窗。安装路径我一般坚持两条全英文、无空格。D:\ArcGIS\Desktop10.2这种最好别塞进D:\软件\地理信息 系统\下面。原因不在于 ArcGIS 本身装不上而在于后面写的 mxd 路径、脚本路径、输出路径一旦含中文或空格Python 2.7 在拼接字符串时很容易出编码问题导出函数又不给你明确报错只会一声不响地少出图。装完先做三件事再谈脚本打开 ArcMap 能正常启动、新建一个空白地图能保存成 mxd、工具箱能打开。这三步过了说明桌面端和 Python 组件都齐了。至于 Python 组件是否真的注册好可以用 2.1 里那条命令再验一次两条路都通才算环境干净。注意安装过程中把所有 GIS 相关进程关掉包括后台的地图服务、其他版本的 ArcCatalog。装到一半被占用导致组件注册失败事后表现是“ArcMap 能开但 arcpy 导入报错”这种半坏状态最难修重装比排查快。2.3 Notepad 装好之后把 .py 的执行按钮配出来脚本不一定非要用 Notepad 写但用它的好处是改一行、按一下就能跑不用来回切命令行。装最新版即可安装时勾选“添加到右键菜单”会方便些。装完第一件事是设语言菜单里找到语言选项选 Python这样缩进、关键字、注释颜色才正常——Python 靠缩进定逻辑用纯文本编辑器写一个 Tab 和空格的混用就够你查半小时。第二件事是把运行命令绑上去。打开“运行”菜单的运行对话框填入下面这行C:\Python27\ArcGIS10.2\python.exe $(FULL_CURRENT_PATH)这行的含义是用 ArcGIS 自带解释器执行当前正在编辑的文件$(FULL_CURRENT_PATH)是编辑器自带的变量会被替换成当前文件的完整路径。填完点保存给它一个快捷键比如 CtrlF5。以后改完脚本直接按快捷键输出窗口就在编辑器下方报错信息第一行通常在最后几行里往上翻能看到具体行号。第三件事是编码。脚本开头那行# coding:utf-8只是声明文件本身必须真的存成 UTF-8。Notepad 的编码菜单里选“UTF-8”不带 BOM别选“ANSI”也别选带 BOM 的那个。带 BOM 时 Python 2.7 有时会在第一行报莫名其妙的语法错误而不带 BOM 的 UTF-8 才能让中文图斑名正常参与字符串拼接。3. 配置数据驱动页面图层、名称字段、排序字段、显示范围和比例尺数据驱动页面是整套方案的底座。它的作用是把索引图层里的每一条记录映射成地图布局里的“一页”。你后面脚本做的事情本质上就是遍历这些页、逐页导出。所以这一章配错脚本写得再对也是错的结果。3.1 启用数据驱动页面与索引图层的选取在 ArcMap 里从自定义菜单找到工具栏把数据驱动页面工具条调出来点开设置。第一个要填的是图层这里必须选那个卫片图斑层而且它得是内容列表里的要素图层不能是栅格、不能是注记图层、不能是图层组。有些人把图斑层放进了图层组里统一管理直接选组是选不中的得展开组选到具体的要素层。选完图层后页面会自动按要素数量生成。此时布局里会出现页面指示左侧工具条上能翻页。如果翻页后地图范围没跟着动八成是显示范围设置成了固定范围回到设置里改成按要素范围自适应即可。这里有个容易被忽略的前提索引图层必须有明确的、唯一的标识字段。图斑层里如果只有系统自动生成的 ObjectID也能用但导出来的文件名就是一串流水号后期人工核对时基本没意义。所以正式跑之前先确认属性表里有一列能当图斑编号用的字段哪怕是手工补的一列“图斑号”。3.2 名称字段与排序字段输出文件名到底从哪来名称字段决定了每页的“页名”而脚本里取的正是这个页名来做输出文件名。所以这一步实际上是在决定你最终拿到的一批 JPG 叫什么。我的做法是选图斑编号字段形如 1、2、3 这种短编号或者带前缀的编号。不建议直接选面积、类型这类可能重复或带小数点的字段重复会导致文件互相覆盖小数点在某些环境下会被当成路径分隔符处理。排序字段是可选项但建议填。按编号排序后输出顺序稳定出问题时你能快速判断是“第几张开始错”而不是面对一堆乱序文件干瞪眼。按面积从大到小排序也常见方便优先检查大图斑。字段值还有两个硬性要求不能为空不能含 Windows 文件名非法字符。反斜杠、正斜杠、冒号、星号、问号、双引号、尖括号、竖线这九个字符只要出现一个导出就会失败而且报错位置往往指向导出函数那一行很容易误判成 arcpy 的问题。我一般会在脚本里加一层清洗第 4 章会给具体写法而不是指望数据本身干净。3.3 显示范围、比例尺与布局里的动态文本显示范围这一项决定每个图斑在图上占多大。选按要素自适应最省事图斑大小不一也能各自填满布局如果业务要求所有图统一比例尺比如统一 1:10000 便于目视比对就在比例尺框里写死数值这时范围要选保持比例尺那一档否则会出现图斑被裁切的情况。比例尺的取舍需要说明统一比例尺的好处是图与图之间可比坏处是极大和极小的图斑会分别表现为“撑爆”和“一个点”。卫片核查类业务通常要求统一比例尺那就接受小图斑看不清的事实必要时在布局里额外插一个小比例尺的定位图。按要素自适应的好处是每张图都好看坏处是不能横向比对看你怎么选。布局视图里还可以插入动态文本这是让每张图自带信息的关键。插入菜单里的动态文本能找到页名、页码以及数据驱动页面属性里的字段把村名、图斑面积、图斑类型这些字段插进去每翻一页文本就自动跟着变。这一步做完导出的 JPG 不只是地图截图而是一张带属性信息的成果图。配置完记得保存 mxd保存路径同样遵守全英文无空格的原则。保存后建议先在 ArcMap 里手动翻几页确认识别到的页名、比例尺、动态文本都对再去写脚本。4. 批量出图脚本从 ExportToPNG 到 ExportToJPEG 的参数取舍脚本本身不长二十来行但每一行都对应一个具体决定文档怎么读、页怎么翻、名字怎么取、图怎么导。下面这版是在原始写法基础上补了目录创建、文件名清洗和异常提示的版本能直接跑。4.1 脚本骨架MapDocument、currentPageID 与 pageRow# coding:utf-8 import arcpy import os import re MXD_PATH rF:\GeoData\ProjectA\WeiPian.mxd OUT_DIR rF:\GeoData\ProjectA\OutJPG mxd arcpy.mapping.MapDocument(MXD_PATH) ddp mxd.dataDrivenPages if not os.path.isdir(OUT_DIR): os.makedirs(OUT_DIR) # 页码从 1 开始到 pageCount 结束必须 1 for pageNum in range(1, ddp.pageCount 1): ddp.currentPageID pageNum mapName ddp.pageRow.getValue(ddp.pageNameField.name) print(mapName)MapDocument负责把磁盘上的 mxd 读进内存注意这里读的是文件而不是 ArcMap 里打开的那个窗口。dataDrivenPages拿到分页对象前提是这个 mxd 已经按第 3 章配好了数据驱动页面没配过的话这行会直接抛属性错误。currentPageID是当前页号赋值即切换取值范围 1 到pageCount赋 0 会报错这也是很多人踩的坑。pageRow返回当前页对应的那条记录再用pageNameField.name拿到名称字段的字段名getValue取出值这个值就是页名也就是后面要做文件名的东西。中间那句print(mapName)建议保留。它不是给你看的是给“跑到哪一张”留个痕迹脚本中途崩了输出窗口最后一行打印的图斑号就是崩的那张。4.2 导出函数PNG 换 JPEG 时要改哪几个参数原始写法用的是ExportToPNG业务要 JPG 就换成ExportToJPEG参数名并不完全一样。我用关键字参数写可读性好一些safe re.sub(r[\\/:*?|], _, unicode(mapName).strip()) out_file os.path.join(OUT_DIR, safe .jpg) arcpy.mapping.ExportToJPEG( mxd, out_file, resolution200, # 输出 DPI jpeg_quality90 # 1-100越大越清晰、体积越大 ) print(done)第一个参数是文档对象传mxd而不是路径导出时它会按照当前页号的状态渲染。第二个参数是完整输出路径必须是绝对路径且目录要事先存在否则报 IOError。resolution控制 DPI200 适合屏幕查看和打印小样要印刷级就到 300代价是文件体积和耗时成倍增长。jpeg_quality只在 JPEG 导出里有80 到 95 是常用区间低于 70 图斑边界会发虚高于 95 体积涨得快但肉眼几乎看不出差别。如果业务还要求带坐标信息ExportToJPEG有个world_file参数置 True 会在同目录多生成一个坐标辅助文件。多数核查场景不需要开了反而让输出目录看着乱。至于宽高df_export_width和df_export_height是像素尺寸不填就按布局的页面尺寸和 DPI 自动算一般不用动只有需要固定出图像素尺寸的批量任务才指定。提示函数名从 PNG 换成 JPEG 之后别只改函数名不改参数。PNG 有透明色和伽马参数JPEG 没有JPEG 有质量参数PNG 没有。混着写的结果是执行时报“参数类型不匹配”而报错信息不会告诉你具体是哪个参数。4.3 输出路径、文件名清洗和一批出图的收尾文件名清洗那行值得单独说。unicode(mapName).strip()先转成 Unicode 再去首尾空白Python 2.7 下中文名必须这么处理否则拼接路径时可能抛编码异常。re.sub把九个非法字符统一替换成下划线比逐个replace干净。替换完如果变成空字符串原值为空或全是非法字符得给个兜底名比如拼上页号否则一堆空名文件会互相覆盖最后你只得到一个文件。输出目录建议按批次分开比如按日期或按任务名建子目录别所有批次都往同一个文件夹里倒。同一次任务重跑时先清空目录再跑不然上次的残留会混在结果里核对文件数时永远对不上。脚本跑完后print(done)是给自己一个明确结束信号。如果输出窗口里最后一行是某个图斑号而不是 done说明是在那一张崩的直接拿那个图斑号去属性表里查八成是名称字段有非法字符或空值。5. 避坑与排查五个让批量出图中途停下的问题这几条都是我在实际任务里撞过的按“现象、原因、解决”记下来下次遇到能直接对号入座。5.1 输出比图斑少一张循环少写了一页现象是图层里有 3 个图斑输出目录只有 2 张图缺的永远是最后一个。原因是页码循环写成了range(1, pageCount)Python 的 range 不包含结束值实际只跑到pageCount - 1。解决很简单写成range(1, ddp.pageCount 1)。这个坑的隐蔽之处在于图斑多的时候只少一张肉眼很难发现等交付后被人指出来才回头查。5.2 中文图斑名报编码错误或输出乱码文件名现象是脚本跑到含中文的图斑号时抛 UnicodeEncodeError或者文件生成了但名字是乱码。原因通常是脚本文件本身存成了 ANSI而开头声明写的是 utf-8声明和实际编码不一致。解决办法是用编辑器把文件另存为不带 BOM 的 UTF-8同时在拼接路径前用unicode()转换字段值。如果输出目录里已经有一批乱码文件直接删掉重跑不要试图改名改到最后往往对不上号。5.3 报“对象没有 dataDrivenPages 属性”现象是执行到取分页对象那一行直接报属性错误。原因有三种mxd 根本没配数据驱动页面配了但保存后又被改回去或者脚本里 mxd 路径写错指向了一个普通地图文档。解决方式是先在 ArcMap 里打开那个 mxd把数据驱动页面工具条调出来看是否处于启用状态确认后重新保存再把脚本里的路径用原始字符串r...写避免反斜杠被当转义符。5.4 所有图导出来长得一模一样现象是文件数量对但每张图内容都是同一个图斑或者都是空白。原因多半是显示范围被设成了固定范围页号切换了但地图没跟着变另一种可能是索引图层的要素范围异常比如某个图斑的几何为空导致布局定位失败。解决是先手动在 ArcMap 里翻几页看范围是否跟着动再检查索引图层属性表把几何为空的记录挑出来排除掉。空白图还有个小概率原因数据框被锁定导出时没按当前页重绘重启 ArcMap 后重跑通常能恢复正常。5.5 用错解释器第一行就语法错误现象是脚本第一行print mapName报缺少括号之类的语法错误。原因是用了系统里的 Python 3 去执行 Python 2.7 的代码。解决办法是回到编辑器把运行命令里的解释器路径换成 ArcGIS 自带那个或者把代码改成print(mapName)这种两种版本都兼容的写法。判断当前用的是哪个解释器在脚本开头加一行打印即可import sys print(sys.version)跑出来是 2.7.x 就对了是 3.x 说明解释器选错。这条加上去之后别删留着当自检。6. 装完怎么验证先拿三个图斑跑小样再全量批量出图最怕的不是跑不起来是跑起来了结果不对却没人发现。我的固定做法是先小样后全量把索引图层筛成三个图斑——一个普通大小的、一个特别小的、一个名称里带空格或括号的用这份筛选后的图层跑一遍脚本三个文件都对再放全量。小样阶段盯三件事文件数是否等于图斑数、每张图的动态文本是否跟着变、文件名是否与图斑编号完全一致。文件名和图斑的对应关系靠肉眼对不现实用一段校验脚本扫一遍更可靠# coding:utf-8 import os OUT_DIR rF:\GeoData\ProjectA\OutJPG files [f for f in os.listdir(OUT_DIR) if f.lower().endswith(.jpg)] print(count:, len(files)) for f in files: size os.path.getsize(os.path.join(OUT_DIR, f)) if size 10240: # 小于 10KB 基本可判定为空白图 print(suspect:, f, size)这段脚本做两件事统计输出目录里 jpg 的数量和索引图层的记录数做个对比逐个检查文件体积把小于 10KB 的挑出来。空白图或者只导出了边框的图体积通常就是几 KB用这个阈值能快速筛出可疑项。阈值不是死的图斑密集、底图复杂的区域正常图可能就二三十 KB按自己那批数据调。数量对、体积正常之后还有一步不能省随机打开三五张看布局里的动态文本是不是当前图斑的信息。这一步专门抓“页名对但内容错”的情况常见于动态文本绑错了字段或者数据驱动页面的名称字段后来改过但地图没重新保存。三张里有一张对不上就回到第 3 章重新核对字段绑定。从那以后我每次接批量出图的活都强制自己先跑三个图斑的小样跑完再全量不管这套脚本我已经用过多少回。批量任务出错的代价从来不在跑的那几分钟而在交付之后被返回来重做。希望帮到你。本文还有配套的精品资源点击获取 
长河君 · 2026/11/3 6:18:25 · 阅读 1.2k ArcGIS卫片图斑批量出图：数据驱动页面与arcpy脚本避坑
简介这份文档面向需要处理卫片图斑及大量地块出图任务的GIS从业者与ArcGIS初学者聚焦按图斑批量生成JPG/PNG图片的自动化方案帮助摆脱逐一手动出图的低效流程。内容围绕ArcGIS数据驱动页面与arcpy脚本展开涵盖图层与名称字段设置、排序和显示范围、比例尺与布局动态文本以及遍历页面导出图片、结果目录检查等环节并给出可直接套用的Python示例与参数调整思路。包内为1个doc文档压缩包约29KB体积轻便适合作为操作备忘或项目参考。已有8322人学习说明其在批量出图场景中具有一定实用参考价值。读者可据此理解卫片图斑批量出图的核心流程掌握动态信息展示与脚本导出方法并迁移到类似地块调查、巡查举证等制图任务中。1. 卫片图斑批量出图明明只有三个图斑却只出了两张某开发者接了个活一个卫片图斑层里躺着 1、2、3 三个图斑要求每个图斑出一张 JPG图名跟着图斑编号走。他翻出一段 ArcGIS 按图斑批量出图的脚本跑完打开输出目录只有两张图第三张怎么都不出现换到另一台机器上脚本第一行就直接报语法错误。这两件事都不是代码写错了而是卡在版本和前置配置上ArcGIS 9 里根本没有 Data Driven Pages数据驱动页面而 10.x 自带的是 Python 2.7跟现在随手搜到的 Python 3 写法对不上。这套环境在卫片核查、图斑台账、按村出图这类内业活里太常见了装不对的后果也很直接——跑一半停、图名乱码、最后一张永远缺。下面这套流程是按 ArcGIS Desktop 10.2 起的版本走的新手照着做能跑通老手可以只看版本取舍和排错部分。2. 环境准备ArcGIS Desktop 10.2 自带的 Python 2.7 才是执行环境动手装之前先把三件事定死桌面版装哪个大版本、脚本用哪个 Python 解释器跑、编辑器用什么。这三件事只要错一件后面配置数据驱动页面配得再漂亮脚本也跑不起来。2.1 三个版本变量桌面版、Python、arcpy很多人以为“装个 ArcGIS 就行”实际上决定批量出图能不能成的是三个互相绑定的东西。第一个是桌面版大版本Data Driven Pages 从 10.0 开始才有所以 9.x 直接排除10.2 及以上都可以10.2 胜在稳定、单位里存量机器多、网上能查到的 arcpy.mapping 写法基本都对得上。第二个是 Python 解释器10.x 安装时会把 Python 2.7 一起装进去位置一般在C:\Python27\ArcGIS10.2\这个解释器是独立的和你系统里另外装的 Python 3 完全没关系。第三个是 arcpy 模块它只存在于 ArcGIS 自带的那套 Python 里你用系统的 Python 3 去import arcpy一定报 ModuleNotFoundError。提示判断“我该用哪套写法”看模块名就够了。arcpy.mapping属于 Desktop 10.xarcpy.mp属于 ArcGIS Pro。两者函数名相似但参数不同复制粘贴时最容易在这里翻车。下面这张对照表是我自己贴在便签上的装环境前扫一眼能省不少时间对照项ArcGIS Desktop 10.2 ~ 10.8ArcGIS Pro分页出图机制Data Driven PagesMap Series地图系列脚本解释器Python 2.7随 Desktop 安装Python 3随 Pro 安装模块入口arcpy.mappingarcpy.mp读取文档arcpy.mapping.MapDocumentarcpy.mp.ArcGISProject导出函数ExportToJPEG/ExportToPNGexportToJPEG布局对象方法print 写法print mapName或print(mapName)必须print(mapName)在命令行里验证解释器对不对不需要打开 ArcMap一条命令就够C:\Python27\ArcGIS10.2\python.exe -c import arcpy; print(arcpy.GetInstallInfo()[Version])这段命令的意思是用 ArcGIS 自带解释器执行一段内联代码导入 arcpy 后打印安装信息里的版本号。能打出版本号说明 arcpy 可用路径写对如果提示No module named arcpy说明你调用的是别的 Python回去检查路径里ArcGIS10.2这一段是不是写成了ArcGIS10.8或者干脆指向了C:\Python39。这一步别偷懒后面所有报错里最难查的就是解释器错配。2.2 ArcGIS Desktop 的安装顺序与授权配置安装本身不难坑在于顺序和路径。常见做法是先确认机器上没有残留的其他版本 Desktop有就先卸干净不要两个大版本并存然后装授权管理组件再装 Desktop 主体。如果你的授权是浮动式的先装 License Manager 并在里面完成授权文件配置再装桌面端如果是单机版桌面端装完打开 ArcGIS Administrator选单机版并完成授权别一装完就去开 ArcMap授权没落地会反复弹窗。安装路径我一般坚持两条全英文、无空格。D:\ArcGIS\Desktop10.2这种最好别塞进D:\软件\地理信息 系统\下面。原因不在于 ArcGIS 本身装不上而在于后面写的 mxd 路径、脚本路径、输出路径一旦含中文或空格Python 2.7 在拼接字符串时很容易出编码问题导出函数又不给你明确报错只会一声不响地少出图。装完先做三件事再谈脚本打开 ArcMap 能正常启动、新建一个空白地图能保存成 mxd、工具箱能打开。这三步过了说明桌面端和 Python 组件都齐了。至于 Python 组件是否真的注册好可以用 2.1 里那条命令再验一次两条路都通才算环境干净。注意安装过程中把所有 GIS 相关进程关掉包括后台的地图服务、其他版本的 ArcCatalog。装到一半被占用导致组件注册失败事后表现是“ArcMap 能开但 arcpy 导入报错”这种半坏状态最难修重装比排查快。2.3 Notepad 装好之后把 .py 的执行按钮配出来脚本不一定非要用 Notepad 写但用它的好处是改一行、按一下就能跑不用来回切命令行。装最新版即可安装时勾选“添加到右键菜单”会方便些。装完第一件事是设语言菜单里找到语言选项选 Python这样缩进、关键字、注释颜色才正常——Python 靠缩进定逻辑用纯文本编辑器写一个 Tab 和空格的混用就够你查半小时。第二件事是把运行命令绑上去。打开“运行”菜单的运行对话框填入下面这行C:\Python27\ArcGIS10.2\python.exe $(FULL_CURRENT_PATH)这行的含义是用 ArcGIS 自带解释器执行当前正在编辑的文件$(FULL_CURRENT_PATH)是编辑器自带的变量会被替换成当前文件的完整路径。填完点保存给它一个快捷键比如 CtrlF5。以后改完脚本直接按快捷键输出窗口就在编辑器下方报错信息第一行通常在最后几行里往上翻能看到具体行号。第三件事是编码。脚本开头那行# coding:utf-8只是声明文件本身必须真的存成 UTF-8。Notepad 的编码菜单里选“UTF-8”不带 BOM别选“ANSI”也别选带 BOM 的那个。带 BOM 时 Python 2.7 有时会在第一行报莫名其妙的语法错误而不带 BOM 的 UTF-8 才能让中文图斑名正常参与字符串拼接。3. 配置数据驱动页面图层、名称字段、排序字段、显示范围和比例尺数据驱动页面是整套方案的底座。它的作用是把索引图层里的每一条记录映射成地图布局里的“一页”。你后面脚本做的事情本质上就是遍历这些页、逐页导出。所以这一章配错脚本写得再对也是错的结果。3.1 启用数据驱动页面与索引图层的选取在 ArcMap 里从自定义菜单找到工具栏把数据驱动页面工具条调出来点开设置。第一个要填的是图层这里必须选那个卫片图斑层而且它得是内容列表里的要素图层不能是栅格、不能是注记图层、不能是图层组。有些人把图斑层放进了图层组里统一管理直接选组是选不中的得展开组选到具体的要素层。选完图层后页面会自动按要素数量生成。此时布局里会出现页面指示左侧工具条上能翻页。如果翻页后地图范围没跟着动八成是显示范围设置成了固定范围回到设置里改成按要素范围自适应即可。这里有个容易被忽略的前提索引图层必须有明确的、唯一的标识字段。图斑层里如果只有系统自动生成的 ObjectID也能用但导出来的文件名就是一串流水号后期人工核对时基本没意义。所以正式跑之前先确认属性表里有一列能当图斑编号用的字段哪怕是手工补的一列“图斑号”。3.2 名称字段与排序字段输出文件名到底从哪来名称字段决定了每页的“页名”而脚本里取的正是这个页名来做输出文件名。所以这一步实际上是在决定你最终拿到的一批 JPG 叫什么。我的做法是选图斑编号字段形如 1、2、3 这种短编号或者带前缀的编号。不建议直接选面积、类型这类可能重复或带小数点的字段重复会导致文件互相覆盖小数点在某些环境下会被当成路径分隔符处理。排序字段是可选项但建议填。按编号排序后输出顺序稳定出问题时你能快速判断是“第几张开始错”而不是面对一堆乱序文件干瞪眼。按面积从大到小排序也常见方便优先检查大图斑。字段值还有两个硬性要求不能为空不能含 Windows 文件名非法字符。反斜杠、正斜杠、冒号、星号、问号、双引号、尖括号、竖线这九个字符只要出现一个导出就会失败而且报错位置往往指向导出函数那一行很容易误判成 arcpy 的问题。我一般会在脚本里加一层清洗第 4 章会给具体写法而不是指望数据本身干净。3.3 显示范围、比例尺与布局里的动态文本显示范围这一项决定每个图斑在图上占多大。选按要素自适应最省事图斑大小不一也能各自填满布局如果业务要求所有图统一比例尺比如统一 1:10000 便于目视比对就在比例尺框里写死数值这时范围要选保持比例尺那一档否则会出现图斑被裁切的情况。比例尺的取舍需要说明统一比例尺的好处是图与图之间可比坏处是极大和极小的图斑会分别表现为“撑爆”和“一个点”。卫片核查类业务通常要求统一比例尺那就接受小图斑看不清的事实必要时在布局里额外插一个小比例尺的定位图。按要素自适应的好处是每张图都好看坏处是不能横向比对看你怎么选。布局视图里还可以插入动态文本这是让每张图自带信息的关键。插入菜单里的动态文本能找到页名、页码以及数据驱动页面属性里的字段把村名、图斑面积、图斑类型这些字段插进去每翻一页文本就自动跟着变。这一步做完导出的 JPG 不只是地图截图而是一张带属性信息的成果图。配置完记得保存 mxd保存路径同样遵守全英文无空格的原则。保存后建议先在 ArcMap 里手动翻几页确认识别到的页名、比例尺、动态文本都对再去写脚本。4. 批量出图脚本从 ExportToPNG 到 ExportToJPEG 的参数取舍脚本本身不长二十来行但每一行都对应一个具体决定文档怎么读、页怎么翻、名字怎么取、图怎么导。下面这版是在原始写法基础上补了目录创建、文件名清洗和异常提示的版本能直接跑。4.1 脚本骨架MapDocument、currentPageID 与 pageRow# coding:utf-8 import arcpy import os import re MXD_PATH rF:\GeoData\ProjectA\WeiPian.mxd OUT_DIR rF:\GeoData\ProjectA\OutJPG mxd arcpy.mapping.MapDocument(MXD_PATH) ddp mxd.dataDrivenPages if not os.path.isdir(OUT_DIR): os.makedirs(OUT_DIR) # 页码从 1 开始到 pageCount 结束必须 1 for pageNum in range(1, ddp.pageCount 1): ddp.currentPageID pageNum mapName ddp.pageRow.getValue(ddp.pageNameField.name) print(mapName)MapDocument负责把磁盘上的 mxd 读进内存注意这里读的是文件而不是 ArcMap 里打开的那个窗口。dataDrivenPages拿到分页对象前提是这个 mxd 已经按第 3 章配好了数据驱动页面没配过的话这行会直接抛属性错误。currentPageID是当前页号赋值即切换取值范围 1 到pageCount赋 0 会报错这也是很多人踩的坑。pageRow返回当前页对应的那条记录再用pageNameField.name拿到名称字段的字段名getValue取出值这个值就是页名也就是后面要做文件名的东西。中间那句print(mapName)建议保留。它不是给你看的是给“跑到哪一张”留个痕迹脚本中途崩了输出窗口最后一行打印的图斑号就是崩的那张。4.2 导出函数PNG 换 JPEG 时要改哪几个参数原始写法用的是ExportToPNG业务要 JPG 就换成ExportToJPEG参数名并不完全一样。我用关键字参数写可读性好一些safe re.sub(r[\\/:*?|], _, unicode(mapName).strip()) out_file os.path.join(OUT_DIR, safe .jpg) arcpy.mapping.ExportToJPEG( mxd, out_file, resolution200, # 输出 DPI jpeg_quality90 # 1-100越大越清晰、体积越大 ) print(done)第一个参数是文档对象传mxd而不是路径导出时它会按照当前页号的状态渲染。第二个参数是完整输出路径必须是绝对路径且目录要事先存在否则报 IOError。resolution控制 DPI200 适合屏幕查看和打印小样要印刷级就到 300代价是文件体积和耗时成倍增长。jpeg_quality只在 JPEG 导出里有80 到 95 是常用区间低于 70 图斑边界会发虚高于 95 体积涨得快但肉眼几乎看不出差别。如果业务还要求带坐标信息ExportToJPEG有个world_file参数置 True 会在同目录多生成一个坐标辅助文件。多数核查场景不需要开了反而让输出目录看着乱。至于宽高df_export_width和df_export_height是像素尺寸不填就按布局的页面尺寸和 DPI 自动算一般不用动只有需要固定出图像素尺寸的批量任务才指定。提示函数名从 PNG 换成 JPEG 之后别只改函数名不改参数。PNG 有透明色和伽马参数JPEG 没有JPEG 有质量参数PNG 没有。混着写的结果是执行时报“参数类型不匹配”而报错信息不会告诉你具体是哪个参数。4.3 输出路径、文件名清洗和一批出图的收尾文件名清洗那行值得单独说。unicode(mapName).strip()先转成 Unicode 再去首尾空白Python 2.7 下中文名必须这么处理否则拼接路径时可能抛编码异常。re.sub把九个非法字符统一替换成下划线比逐个replace干净。替换完如果变成空字符串原值为空或全是非法字符得给个兜底名比如拼上页号否则一堆空名文件会互相覆盖最后你只得到一个文件。输出目录建议按批次分开比如按日期或按任务名建子目录别所有批次都往同一个文件夹里倒。同一次任务重跑时先清空目录再跑不然上次的残留会混在结果里核对文件数时永远对不上。脚本跑完后print(done)是给自己一个明确结束信号。如果输出窗口里最后一行是某个图斑号而不是 done说明是在那一张崩的直接拿那个图斑号去属性表里查八成是名称字段有非法字符或空值。5. 避坑与排查五个让批量出图中途停下的问题这几条都是我在实际任务里撞过的按“现象、原因、解决”记下来下次遇到能直接对号入座。5.1 输出比图斑少一张循环少写了一页现象是图层里有 3 个图斑输出目录只有 2 张图缺的永远是最后一个。原因是页码循环写成了range(1, pageCount)Python 的 range 不包含结束值实际只跑到pageCount - 1。解决很简单写成range(1, ddp.pageCount 1)。这个坑的隐蔽之处在于图斑多的时候只少一张肉眼很难发现等交付后被人指出来才回头查。5.2 中文图斑名报编码错误或输出乱码文件名现象是脚本跑到含中文的图斑号时抛 UnicodeEncodeError或者文件生成了但名字是乱码。原因通常是脚本文件本身存成了 ANSI而开头声明写的是 utf-8声明和实际编码不一致。解决办法是用编辑器把文件另存为不带 BOM 的 UTF-8同时在拼接路径前用unicode()转换字段值。如果输出目录里已经有一批乱码文件直接删掉重跑不要试图改名改到最后往往对不上号。5.3 报“对象没有 dataDrivenPages 属性”现象是执行到取分页对象那一行直接报属性错误。原因有三种mxd 根本没配数据驱动页面配了但保存后又被改回去或者脚本里 mxd 路径写错指向了一个普通地图文档。解决方式是先在 ArcMap 里打开那个 mxd把数据驱动页面工具条调出来看是否处于启用状态确认后重新保存再把脚本里的路径用原始字符串r...写避免反斜杠被当转义符。5.4 所有图导出来长得一模一样现象是文件数量对但每张图内容都是同一个图斑或者都是空白。原因多半是显示范围被设成了固定范围页号切换了但地图没跟着变另一种可能是索引图层的要素范围异常比如某个图斑的几何为空导致布局定位失败。解决是先手动在 ArcMap 里翻几页看范围是否跟着动再检查索引图层属性表把几何为空的记录挑出来排除掉。空白图还有个小概率原因数据框被锁定导出时没按当前页重绘重启 ArcMap 后重跑通常能恢复正常。5.5 用错解释器第一行就语法错误现象是脚本第一行print mapName报缺少括号之类的语法错误。原因是用了系统里的 Python 3 去执行 Python 2.7 的代码。解决办法是回到编辑器把运行命令里的解释器路径换成 ArcGIS 自带那个或者把代码改成print(mapName)这种两种版本都兼容的写法。判断当前用的是哪个解释器在脚本开头加一行打印即可import sys print(sys.version)跑出来是 2.7.x 就对了是 3.x 说明解释器选错。这条加上去之后别删留着当自检。6. 装完怎么验证先拿三个图斑跑小样再全量批量出图最怕的不是跑不起来是跑起来了结果不对却没人发现。我的固定做法是先小样后全量把索引图层筛成三个图斑——一个普通大小的、一个特别小的、一个名称里带空格或括号的用这份筛选后的图层跑一遍脚本三个文件都对再放全量。小样阶段盯三件事文件数是否等于图斑数、每张图的动态文本是否跟着变、文件名是否与图斑编号完全一致。文件名和图斑的对应关系靠肉眼对不现实用一段校验脚本扫一遍更可靠# coding:utf-8 import os OUT_DIR rF:\GeoData\ProjectA\OutJPG files [f for f in os.listdir(OUT_DIR) if f.lower().endswith(.jpg)] print(count:, len(files)) for f in files: size os.path.getsize(os.path.join(OUT_DIR, f)) if size 10240: # 小于 10KB 基本可判定为空白图 print(suspect:, f, size)这段脚本做两件事统计输出目录里 jpg 的数量和索引图层的记录数做个对比逐个检查文件体积把小于 10KB 的挑出来。空白图或者只导出了边框的图体积通常就是几 KB用这个阈值能快速筛出可疑项。阈值不是死的图斑密集、底图复杂的区域正常图可能就二三十 KB按自己那批数据调。数量对、体积正常之后还有一步不能省随机打开三五张看布局里的动态文本是不是当前图斑的信息。这一步专门抓“页名对但内容错”的情况常见于动态文本绑错了字段或者数据驱动页面的名称字段后来改过但地图没重新保存。三张里有一张对不上就回到第 3 章重新核对字段绑定。从那以后我每次接批量出图的活都强制自己先跑三个图斑的小样跑完再全量不管这套脚本我已经用过多少回。批量任务出错的代价从来不在跑的那几分钟而在交付之后被返回来重做。希望帮到你。本文还有配套的精品资源点击获取