ArcPy 字段批量计算：CalculateField 的常见用法和避坑

wowwwai GIS研习社 · 工具流程与项目排障

问题场景：字段计算一旦写错，就是批量写错

ArcPy 的 CalculateField 是自动化处理中非常高频的工具。它可以批量生成编码、拼接名称、计算面积、更新分类字段，也可以作为模型或脚本中的关键步骤。但字段计算有一个特点：执行后会直接改写属性表。表达式写错，影响的不是一条记录，而是一整张表。

因此，CalculateField 的核心不是会不会写语法，而是能否在执行前确认字段类型、空值、坐标单位和备份策略。

字符串拼接

import arcpy

fc = r"D:gisdata.gdbparcels"
arcpy.management.CalculateField(
    fc,
    "full_name",
    "!town! + '-' + !village!",
    "PYTHON3"
)

字段引用使用感叹号。若字段可能为空，建议在 code block 中写函数处理 None，避免拼接时报错。

面积和长度计算

arcpy.management.CalculateField(
    fc,
    "area_mu",
    "!shape.area@SQUAREMETERS! / 666.6667",
    "PYTHON3"
)

面积计算前必须确认数据使用合适的投影坐标系。如果图层是经纬度坐标，计算结果可能不符合项目要求。

条件分类写法

code_block = """
def level(v):
    if v is None:
        return '未知'
    if v >= 80:
        return '高'
    if v >= 50:
        return '中'
    return '低'
"""
arcpy.management.CalculateField(fc, "level", "level(!score!)", "PYTHON3", code_block)

实操流程

1. 先复制数据或新增结果字段，不要直接覆盖关键字段。
2. 用少量样本测试表达式。
3. 检查字段类型，文本、整数、浮点数不要混用。
4. 执行后统计空值、唯一值和异常值。

项目避坑：保留原字段，新增计算字段

正式项目中，尽量不要直接覆盖原始字段。新增字段计算结果，确认无误后再决定是否替换。

这个习惯能让你在表达式错误、单位错误或规则变化时快速回滚。

FAQ

CalculateField 支持中文字符串吗？

支持，但要注意数据格式和字段编码。文件地理数据库通常比 Shapefile 更稳定。

为什么面积字段结果不对？

优先检查坐标系和面积单位。经纬度坐标不适合直接做平面面积统计。

能批量处理多个图层吗？

可以，用 arcpy.ListFeatureClasses 遍历，但每个图层字段结构必须先检查。

总结

ArcPy 字段计算是提高效率的利器，也可能快速放大错误。先备份、再测试、后执行，并把计算规则写清楚，才能让自动化真正可靠。