ArcGIS Python Addin 开发实战:三普及补充耕地质量鉴定评价工具完整流程

第三次全国土壤普查项目中，耕地质量等级评价是核心业务模块。此前我们开发过独立版耕地质量计算质检系统，土壤三普专题篇-耕地质量等级评价国家反馈错误质检规则加入本次改用ArcGIS Python Addin 插件重构整套工具。相比 Toolbox、原生 Arcpy 脚本，Addin 插件界面可视化、安装卸载极简、占用体积小，适配行业日常制图与成果核查工作。下文完整梳理从项目创建、界面配置、代码开发到打包部署、落地使用全流程。

一、新建 Addin 项目，规范工程目录

1. 启动开发工具addin_assistant.exe，选择空白文件夹作为项目根目录

   开发工具程序

   

   选择项目存放目录

重要提示：项目路径必须使用纯英文文件夹，ArcGIS 内置 Python2.7 对中文路径兼容性差，极易出现读取、编码报错。

1. 选定目录后，项目全部界面配置、业务脚本、图标资源都会统一存放在该文件夹内，方便统一管理。

二、基础项目信息配置（插件基础信息）

切换至Project Settings面板，配置插件基础属性，适配三普业务场景：

• 插件名称：三普及补充耕地质量鉴定评价质检系统
• 版本、开发单位、作者自定义填写
• 上传第三次全国土壤普查官方标识作为插件图标

  

  插件基础信息配置页

配置完成点击Save保存项目，进入功能界面搭建环节。

三、可视化界面搭建：工具栏 + 功能按钮

1. 切换Add-In Contents标签页，右键新建工具栏，命名为「耕地质量等级评级及质检」

   

   新建自定义工具栏

2. 在工具栏内创建 3 个核心业务按钮，对应工具三大功能：

   

   新增功能按钮配置

1. 质量等级计算：批量核算耕地各指标得分、综合等级
2. 质量等级质检：校验区县耕评成果计算逻辑错误
3. 注册按钮：配套工具授权校验

完成界面搭建后，项目目录生成固定结构：

项目文件夹结构

• Images：存放插件按钮、窗口 logo 图标
• Install：核心业务代码存放目录，所有 ArcPy 评价逻辑在此编写
• config.xml、README、makeaddin.py：打包、配置、编译核心文件

四、业务功能代码开发（耕地质量评价逻辑）

进入 Install 文件夹下 Python 脚本，基于 ArcPy 编写三普耕地质量评价核心逻辑：

1. 导入系统、空间计算、加密、编码处理依赖库，强制 UTF-8 编码避免中文乱码；
2. 定义耕评标准字段集：地形部位、耕层质地、有机质、有效磷、速效钾等 12 项评价指标；
3. 建立指标字段映射关系，兼容 Shp、GDB 不同数据源字段命名差异；
4. 编写得分计算、空值处理、综合指数核算、等级判定、异常值校验完整逻辑。

   

   评价核心代码片段

开发小技巧：代码调试优先在 ArcGIS 内置 Python 窗口测试逻辑，避免每次修改都重新打包安装插件，大幅提升调试效率。

五、一键打包生成 Esri Addin 插件文件

业务代码调试无误后，运行项目根目录makeaddin.py完成打包：

打包脚本代码

1. 运行环境要求：必须使用 ArcGIS 自带 Python2.7 执行脚本；
2. 脚本自动压缩项目全部资源，生成后缀.esriaddin安装包；
3. 
4. 打包文件集成界面、代码、图标，无需额外依赖，可直接分发给其他作业人员。

六、插件安装与 ArcGIS 加载配置

1. 双击.esriaddin文件，弹出安装工具，点击Install Add-In完成安装

2. 

   插件安装弹窗

3. 打开 ArcMap，顶部菜单栏【自定义】-【加载项管理器】，即可查看已安装的三普耕地质量评价插件，支持删除、管理加载项

   

   加载项管理器查看插件

七、工具实操：耕地质量等级批量计算

1. 在 ArcMap 加载待评价耕地矢量数据（Shp/GDB 要素类）

   

   加载耕地矢量数据

2. 点击工具栏「质量等级计算」按钮，弹出字段映射窗口，自动匹配图层评价字段

注意：Shapefile 字段名仅支持 10 字节，过长字段会自动截断，工具内置字段适配逻辑

字段匹配确认弹窗

1. 点击确定启动运算，工具自动新增 14 个属性字段：12 项单指标得分 + 综合评价指数 + 耕地质量等级；空值指标统一按 0 分处理，不干扰整体计算。运算结束弹出完成提示，同步展示要素总量、异常条数

   

   评价完成提示窗口

开发总结

1. ArcGIS Python Addin 优势：轻量化可视化插件，分发、安装零门槛，相比工具箱更贴合业务人员操作习惯；
2. 避坑要点：全程英文路径、使用 Python2.7 环境、代码提前分块调试减少重复打包；
3. 业务适配：本工具完全贴合第三次全国土壤普查耕地质量评价规范，可直接用于区县耕评成果生产、质检核查。

5. 如果你喜欢本公众号内容，麻烦文章下面给个免费的赞赞及爱心，我们也将推出更多免费精品好资源，如果您想进入我们专属农业、土壤普查技术交流群，欢迎在公众号主页联系小编拉你进去！