ArcPy怎么批量制图？数据驱动模块实操详解（含：源代码）

作者： GIS研习社更新时间：2026-04-09 08:30:01 分类：GIS基础理论

引言：告别“机械式”制图，重塑 GISer 的工作流

你是否经历过这样的绝望时刻：项目截止在即，老板突然要求输出 500 个不同行政村的土地利用现状图？按照传统的人工导出模式，打开一个图层、调整一次视图、导出一次图片，哪怕每张图耗时 1 分钟，这也意味着你需要连续工作 8 个小时以上，且中间不能犯任何错误。

对于资深 GIS 工程师而言，这种低效的重复劳动是绝对不能容忍的。这不仅浪费了宝贵的分析时间，更极易因疲劳导致文件命名错误或图幅范围偏移。自动化才是解决这一痛点的唯一出路。

本文将深入解析 ArcGIS 中最实用的自动化工具——ArcPy 结合数据驱动页面（Data Driven Pages）。我们将跳过晦涩的理论，直接通过实操代码演示如何将三天的工作量压缩至三分钟。无论你是 GIS 小白还是进阶用户，这篇文章都将成为你提升工作效率的转折点。

核心解析：为什么选择 ArcPy + 数据驱动模块？

在开始写代码之前，我们需要明白为什么“数据驱动页面”是批量制图的神器。单纯使用 ArcPy 控制视图范围虽然可行，但代码量大且难以调试；而单纯使用软件自带的“导出地图”功能又缺乏灵活性（如无法自定义复杂的文件名）。

下表对比了三种常见制图方式的优劣：

制图方式	操作难度	灵活性	适用场景
纯手工导出	低	低	小于 10 张图的临时任务
纯 ArcPy 代码控制	高	极高	复杂的动态分析制图
ArcPy + 数据驱动	中	高	标准分幅图、行政区划图批量生产

实操步骤一：MXD 文档的基础设置

在编写代码前，必须先在 ArcMap 中配置好“数据驱动页面”。这是自动化的基础，相当于为代码提供了一个“导航仪”。

准备索引图层：你需要一个矢量图层（通常是面图层），其每一个要素代表一张图的范围（例如：行政村边界、标准图幅框）。
启用工具条：在 ArcMap 中，右键工具栏勾选“Data Driven Pages”（数据驱动页面）。
设置驱动参数：点击工具条上的设置按钮。
- Layer：选择你的索引图层。
- Name Field：选择用于命名的字段（如“村名”），这将是后续文件命名的关键。
- Sort Field：设置排序字段，决定出图顺序。
保存工程：将配置好的地图保存为 .mxd 文件，例如 Project_Map.mxd。

实操步骤二：编写 ArcPy 自动化脚本

配置好 MXD 后，我们使用 Python 来接管导出过程。以下代码展示了如何遍历每一页，并以“索引字段”命名导出为 JPG 图片。

注意：以下代码适用于 Python 2.7 (ArcMap 环境)。请在 ArcMap 的 Python 窗口或独立的 IDE 中运行。

import arcpy

import os

# 设置工作空间和MXD路径

mxd_path = r"C:GIS_ProjectProject_Map.mxd"

output_folder = r"C:GIS_ProjectOutput"

mxd = arcpy.mapping.MapDocument(mxd_path)

# 获取数据驱动页面对象

ddp = mxd.dataDrivenPages

# 遍历每一页

for pageNum in range(1, ddp.pageCount + 1):

    # 跳转到指定页面

    ddp.currentPageID = pageNum

    # 获取当前页面的名称属性（用于文件名）

    pageName = ddp.pageRow.getValue(ddp.pageNameField.name)

    # 构建输出路径

    file_name = "{}.jpg".format(pageName)

    full_path = os.path.join(output_folder, file_name)

    # 执行导出

    arcpy.mapping.ExportToJPEG(mxd, full_path, resolution=300)

    print("已导出: " + file_name)

del mxd

这段代码的核心逻辑非常清晰：它利用 mxd.dataDrivenPages 对象作为迭代器，像翻书一样一页页切换地图视图，然后调用 ExportToJPEG 函数进行保存。resolution=300 确保了打印级别的清晰度。

扩展技巧：如何动态修改图面元素？

单纯导出地图有时无法满足需求，你可能需要根据不同的区域修改地图标题或备注信息。虽然数据驱动页面自带动态文本功能，但有时我们需要更复杂的逻辑控制。

我们可以利用 arcpy.mapping.ListLayoutElements 来实现：

# 在循环内部添加以下逻辑

# 查找名为 "Title_Text" 的文本元素

for elm in arcpy.mapping.ListLayoutElements(mxd, "TEXT_ELEMENT"):

if elm.name == "Title_Text":

elm.text = "{} 土地利用现状图 (2023)".format(pageName)

技巧提示：在 MXD 布局视图中，右键点击文本元素，属性中的“Element Name”就是代码中用来定位的 ID，务必保持一致。

FAQ：关于 ArcPy 批量制图的常见问答

Q1: 这段代码可以在 ArcGIS Pro 中运行吗？

不可以。 ArcGIS Pro 使用的是 Python 3 和全新的 arcpy.mp 模块。在 Pro 中，“数据驱动页面”被升级为“地图系列”（Map Series）。你需要将 arcpy.mapping 替换为 arcpy.mp，并将 MapDocument 替换为 ArcGISProject 对象。逻辑相似，但语法不兼容。

Q2: 导出几百张图后，程序报错“内存不足”怎么办？

这是一个经典的 ArcMap 32位程序限制问题。解决方案是：不要在循环外部创建 mxd 对象，或者每处理 50-100 张图后，手动调用 Python 的垃圾回收机制，甚至重启 Python 进程。更简单的办法是使用 64位的 Background Geoprocessing 扩展包运行脚本。