ArcGIS Pro Python二次开发入门教程

从零开始学习ArcGIS Pro自动化与定制开发

作者：闫神

2026年6月

目录

·第一章 ArcGIS Pro Python概述

·第二章 开发环境配置

·第三章 Python基础语法速成

·第四章 arcpy模块核心概念

·第五章 数据管理与处理

·第六章 地图文档自动化

·第七章 地理处理工具开发

·第八章 实战案例集锦

·附录 常用代码片段与资源 

第一章 ArcGIS Pro Python概述

1.1 什么是ArcGIS Pro Python

ArcGIS Pro内置了Python环境，提供强大的地理数据处理和自动化能力。通过Python脚本，用户可以实现数据处理自动化、批量操作、工具定制等功能。

1.2 为什么学习ArcGIS Pro Python

·自动化重复性工作，提高工作效率

·批量处理大量数据，节省时间成本

·开发定制工具，满足特定业务需求

·集成第三方库，扩展GIS功能

·构建工作流模型，实现智能化处理

1.3 ArcGIS Pro Python的特点

ArcGIS Pro使用Python 3.x版本，内置arcpy模块，提供了丰富的GIS功能接口。与ArcMap时代的Python 2.x不同，Pro环境更加现代化，支持更多新特性。

第二章 开发环境配置

2.1 ArcGIS Pro内置Python环境

ArcGIS Pro自带独立的Python环境，无需额外安装。通过以下方式访问：

1.开始菜单 → ArcGIS → Python Command Prompt

2.ArcGIS Pro菜单 → Geoprocessing → Python

3.ArcGIS Pro菜单 → Geoprocessing → Jupyter Notebooks

2.2 配置独立的Python开发环境

推荐使用ArcGIS Pro的Python环境克隆功能创建独立开发环境：

# 克隆Python环境          # 在ArcGIS Pro中：Project → Python → Manage Environments          # 或使用conda命令：          conda create --clone arcgispro-py3 --name my-env

2.3 集成开发环境（IDE）推荐

·PyCharm：功能强大的Python IDE，支持代码补全、调试等功能

·Visual Studio Code：轻量级编辑器，安装Python扩展后功能完善

·Spyder：科学计算友好，内置变量浏览器

·Jupyter Notebook：交互式编程，适合数据探索和可视化

第三章 Python基础语法速成

3.1 变量与数据类型

# 字符串          name = "ArcGIS Pro"          path = r"C:\Data\shapefile.shp"# 原始字符串          # 数字          count = 100          area = 125.5          # 布尔值          is_valid = True          has_data = False

3.2 列表与字典

# 列表          files = ["a.shp", "b.shp", "c.shp"]          files.append("d.shp")          first_file = files[0]          # 字典          params = {          "input": "data.shp",          "output": "result.shp",          "distance": 100          }

3.3 条件与循环

# 条件判断          if count > 0:          print("有数据")          else:          print("无数据")          # 循环          for file in files:          print(file)          for i in range(10):          print(i)

3.4 函数定义

# 定义函数          def buffer_feature(input_fc, distance):          """缓冲区分析"""          output = input_fc.replace(".shp", "_buffer.shp")          arcpy.Buffer_analysis(input_fc, output, distance)          return output

第四章 arcpy模块核心概念

4.1 arcpy模块简介

arcpy是ArcGIS的核心Python模块，提供了访问地理处理工具、数据管理、地图自动化等功能的编程接口。

4.2 导入arcpy模块

import arcpy          # 设置工作环境          arcpy.env.workspace = r"C:\Data"          arcpy.env.overwriteOutput = True

4.3 环境设置

arcpy.env包含多个重要的环境变量：

·workspace：默认工作空间路径

·overwriteOutput：是否覆盖已存在的输出

·outputCoordinateSystem：输出坐标系

·extent：处理范围

·cellSize：栅格像元大小

4.4 工具执行方式

# 方法1：直接调用          arcpy.Buffer_analysis("input.shp", "output.shp", "100 Meters")          # 方法2：使用工具箱名称          arcpy.analysis.Buffer("input.shp", "output.shp", "100 Meters")

第五章 数据管理与处理

5.1 要素类操作

5.1.1 列出要素类

import arcpy          arcpy.env.workspace = r"C:\Data\Geodatabase.gdb"          # 列出所有要素类          fcs = arcpy.ListFeatureClasses()          for fc in fcs:          print(fc)

5.1.2 创建要素类

# 创建新的要素类          arcpy.management.CreateFeatureclass(          out_path=r"C:\Data\Geodatabase.gdb",          out_name="NewFeature",          geometry_type="POINT",          spatial_reference=arcpy.SpatialReference(4326)          )

5.1.3 添加字段

# 添加字段          arcpy.management.AddField(          in_table="NewFeature",          field_name="Name",          field_type="TEXT",          field_length=50          )

5.2 游标操作

游标用于读取和编辑要素属性和几何信息：

5.2.1 搜索游标

# 搜索游标 - 只读          with arcpy.da.SearchCursor("cities.shp", ["NAME", "POPULATION"]) as cursor:          for row in cursor:          print(f"城市: {row[0]}, 人口: {row[1]}")

5.2.2 更新游标

# 更新游标 - 修改数据          with arcpy.da.UpdateCursor("cities.shp", ["POPULATION"]) as cursor:          for row in cursor:          if row[0] > 1000000:          row[0] = row[0] * 1.1# 人口增长10%          cursor.updateRow(row)

5.2.3 插入游标

# 插入游标 - 添加新要素          fields = ["SHAPE@", "NAME", "POPULATION"]          with arcpy.da.InsertCursor("cities.shp", fields) as cursor:          point = arcpy.Point(116.4, 39.9)          cursor.insertRow([point, "北京", 21700000])

5.3 几何对象操作

# 创建点几何          point = arcpy.Point(116.4, 39.9)          point_geometry = arcpy.PointGeometry(point)          # 创建多点          points = [arcpy.Point(0, 0), arcpy.Point(1, 1), arcpy.Point(2, 2)]          multipoint = arcpy.Multipoint(arcpy.Array(points))          # 创建线          array = arcpy.Array([arcpy.Point(0, 0), arcpy.Point(1, 1)])          line = arcpy.Polyline(array)          # 创建面          array = arcpy.Array([          arcpy.Point(0, 0),          arcpy.Point(1, 0),          arcpy.Point(1, 1),          arcpy.Point(0, 1),          arcpy.Point(0, 0)# 闭合          ])          polygon = arcpy.Polygon(array)

第六章 地图文档自动化

6.1 APRX文件操作

ArcGIS Pro使用.aprx格式的工程文件，通过arcpy.mp模块可以自动化操作地图文档。

6.1.1 打开工程文件

import arcpy.mp          # 打开工程          aprx = arcpy.mp.ArcGISProject(r"C:\Data\MyProject.aprx")          # 获取地图          maps = aprx.listMaps()[0]          print(f"地图名称: {map.name}")

6.1.2 添加图层

# 添加图层到地图          layer_file = r"C:\Data\layers\roads.lyrx"          layer = map.addDataFromPath(layer_file)          # 或者          map.addDataFromPath(r"C:\Data\roads.shp")

6.1.3 导出地图

# 导出为PDF          layout = aprx.listLayouts()[0]          layout.exportToPDF(r"C:\Output\map.pdf")          # 导出为图片          layout.exportToPNG(r"C:\Output\map.png")

6.2 布局操作

# 获取布局          layout = aprx.listLayouts("主布局")[0]          # 修改布局元素          for elem in layout.listElements():          if elem.name == "标题":          elem.text = "新标题"          if elem.name == "比例尺":          elem.scale = 50000

6.3 批量导出地图

# 批量导出多个地图          aprx = arcpy.mp.ArcGISProject(r"C:\Data\Project.aprx")          for map in aprx.listMaps():          print(f"处理地图: {map.name}")          for layout in aprx.listLayouts():          if map.name in layout.name:          output_path = f"C:\Output\{layout.name}.pdf"          layout.exportToPDF(output_path)

第七章 地理处理工具开发

7.1 创建自定义工具

可以将Python脚本封装为ArcGIS工具箱中的工具：

7.1.1 工具脚本模板

import arcpy          class ToolClass:          def __init__(self):          self.label = "工具名称"          self.description = "工具描述"          self.canRunInBackground = False          def getParameterInfo(self):          """定义工具参数"""          params = []          # 输入要素          param1 = arcpy.Parameter(          displayName="输入要素",          name="input_features",          datatype="GPFeatureLayer",          parameterType="Required",          direction="Input"          )          params.append(param1)          return params          def execute(self, parameters, messages):          """执行工具"""          input_fc = parameters[0].valueAsText          # 处理逻辑...          return

7.1.2 参数类型

·GPFeatureLayer：要素图层

·GPString：字符串

·GPDouble：双精度浮点数

·GPLong：长整型

·GPBoolean：布尔值

·DEShapefile：Shapefile

·DEFeatureClass：要素类

·DERasterDataset：栅格数据集

7.2 错误处理与消息

import arcpy          try:          # 执行地理处理          arcpy.Buffer_analysis("input.shp", "output.shp", "100 Meters")          arcpy.AddMessage("处理成功！")          except arcpy.ExecuteError:          arcpy.AddError(arcpy.GetMessages(2))          except Exception as e:          arcpy.AddError(f"发生错误: {str(e)}")

第八章 实战案例集锦

8.1 批量缓冲区分析

# 批量对多个要素类进行缓冲区分析          import arcpy          import os          arcpy.env.workspace = r"C:\Data\Input"          arcpy.env.overwriteOutput = True          output_folder = r"C:\Data\Buffer"          buffer_distance = "500 Meters"          # 获取所有要素类          fcs = arcpy.ListFeatureClasses()          for fc in fcs:          output = os.path.join(output_folder, f"{fc[:-4]}_buffer.shp")          arcpy.Buffer_analysis(fc, output, buffer_distance)          print(f"完成: {fc} -> {os.path.basename(output)}")

8.2 属性数据批量更新

# 批量更新属性字段          import arcpy          fc = r"C:\Data\cities.shp"          fields = ["POPULATION", "DENSITY", "CLASS"]          with arcpy.da.UpdateCursor(fc, fields) as cursor:          for row in cursor:          population = row[0]          area = 100# 假设面积          # 计算密度          row[1] = population / area          # 分类          if population > 1000000:          row[2] = "特大城市"          elif population > 100000:          row[2] = "大城市"          else:          row[2] = "中小城市"          cursor.updateRow(row)

8.3 批量裁剪

# 批量裁剪多个数据集          import arcpy          import os          input_folder = r"C:\Data\Input"          output_folder = r"C:\Data\Output"          clip_features = r"C:\Data\boundary.shp"          arcpy.env.workspace = input_folder          arcpy.env.overwriteOutput = True          # 裁剪所有要素类          fcs = arcpy.ListFeatureClasses()          for fc in fcs:          output = os.path.join(output_folder, f"{fc[:-4]}_clip.shp")          arcpy.analysis.Clip(fc, clip_features, output)          print(f"已裁剪: {fc}")

8.4 自动生成地图册

# 批量生成地图册          import arcpy          import os          # 打开工程          aprx = arcpy.mp.ArcGISProject(r"C:\Data\MapBook.aprx")          layout = aprx.listLayouts("主布局")[0]          map = aprx.listMaps("主地图")[0]          # 获取索引图层          index_layer = map.listLayers("索引")[0]          output_folder = r"C:\Output\MapBook"          # 遍历每个要素          with arcpy.da.SearchCursor(index_layer, ["PageName", "SHAPE@"]) as cursor:          for row in cursor:          page_name = row[0]          extent = row[1].extent          # 设置地图范围          map.defaultCamera.setExtent(extent)          # 更新标题文本元素          for elem in layout.listElements("TEXT_ELEMENT"):          if elem.name == "标题":          elem.text = f"区域: {page_name}"          # 导出PDF          output_pdf = os.path.join(output_folder, f"{page_name}.pdf")          layout.exportToPDF(output_pdf)          print(f"已导出: {page_name}")

8.5 数据格式转换

# 批量转换Shapefile到Geodatabase          import arcpy          import os          input_folder = r"C:\Data\Shapefiles"          output_gdb = r"C:\Data\Geodatabase.gdb"          arcpy.env.workspace = input_folder          arcpy.env.overwriteOutput = True          # 转换所有Shapefile          fcs = arcpy.ListFeatureClasses()          for fc in fcs:          output_fc = os.path.join(output_gdb, fc[:-4])          arcpy.conversion.FeatureClassToFeatureClass(          fc, output_gdb, fc[:-4]          )          print(f"已转换: {fc}")

附录 常用代码片段与资源

A. 常用代码片段

A.1 检查文件是否存在

import arcpy          import os          fc = r"C:\Data\test.shp"          if arcpy.Exists(fc):          print("文件存在")          else:          print("文件不存在")

A.2 获取要素数量

fc = r"C:\Data\cities.shp"          count = int(arcpy.management.GetCount(fc).getOutput(0))          print(f"要素数量: {count}")

A.3 描述数据属性

fc = r"C:\Data\cities.shp"          desc = arcpy.da.Describe(fc)          print(f"数据类型: {desc['dataType']}")          print(f"几何类型: {desc['shapeType']}")          print(f"坐标系: {desc['spatialReference'].name}")

A.4 获取字段列表

fc = r"C:\Data\cities.shp"          fields = [f.name for f in arcpy.ListFields(fc)]          print("字段列表:", fields)

A.5 进度显示

import arcpy          arcpy.SetProgressor("step", "处理中...", 0, 100, 1)          for i in range(100):          # 执行操作          arcpy.SetProgressorPosition(i)          arcpy.ResetProgressor()

B. 学习资源

·ArcGIS Pro官方文档https://pro.arcgis.com/zh-cn/pro-app/latest/arcpy/main/arcgis-pro-arcpy-reference.htm

·Esri中国官网https://www.esri.com/zh-cn

·ArcGIS API for Pythonhttps://developers.arcgis.com/python/

·GIS Stack Exchangehttps://gis.stackexchange.com/

·Esri社区https://community.esri.com/

C. 调试技巧

4.使用print()或arcpy.AddMessage()输出调试信息

5.使用try-except捕获异常并输出详细错误信息

6.使用arcpy.GetMessages()获取地理处理工具的详细消息

7.在Python窗口中逐行测试代码

8.使用断点调试功能（在支持的IDE中） 

结语

恭喜您完成ArcGIS Pro Python二次开发入门学习！通过本教程，您已经掌握了：

·ArcGIS Pro Python环境配置与基础语法

·arcpy模块的核心概念与使用方法

·数据管理与处理的基本操作

·地图文档自动化技术

·自定义工具开发方法

·实战案例的应用

继续深入学习，探索更多高级功能，让Python成为您GIS工作的得力助手！