ArcGIS Python Toolbox参数依赖配置：文本关联选择参数仅显示首行问题排查

选项仅显示首行的问题，本质是参数类型和ArcGIS内置的依赖匹配规则完全不搭，不是依赖机制本身设计反人类：

• Field类型参数从设计之初，就是用来绑定要素类、属性表、栅格表这类带结构化字段的数据集的，它的自动枚举逻辑是读取数据集的字段名，根本没有解析普通文本文件行的能力。
• 当你把DETextFile类型的文本文件入参设为Field参数的依赖时，GP引擎没有对应的内置解析规则，不知道要从文本里提取什么生成下拉列表，只会拿文件第一行的内容当占位值返回，这才导致下拉框里只看到A。

文本文件的行列表生成选项，没有内置的自动映射规则，需要手动通过updateParameters钩子刷新参数可选值，根据交互需求选择对应参数类型即可：

方案1：单选场景（用户仅选择文件中某一行作为目标项） #

改用GPString类型+值列表过滤，完全替代之前的Field类型：

1. 修改getParameterInfo中的参数定义：

   def getParameterInfo(self):
       # 文本文件入参（原定义可保留）
       in_text = arcpy.Parameter(
           displayName="输入文本文件",
           name="in_text",
           datatype="DETextFile",
           parameterType="Required",
           direction="Input")
   
       # 选择项入参 替换原Field类型为GPString
       selection = arcpy.Parameter(
           displayName="选择目标列表项",
           name="selection",
           datatype="GPString",
           parameterType="Required",
           direction="Input")
       # 给字符串参数开启值列表过滤
       selection.filter.type = "ValueList"
   
       # 派生输出（原绑定文本文件为要素层的逻辑存在类型不匹配问题，需按实际业务调整类型）
       out_result = arcpy.Parameter(
           displayName="输出结果",
           name="out_result",
           datatype="GPBoolean",
           parameterType="Derived",
           direction="Output")
   
       return [in_text, selection, out_result]
   

2. 新增updateParameters钩子函数，监听文本文件变化、动态加载行选项：

   def updateParameters(self, parameters):
       text_path = parameters[0].valueAsText
       # 文本文件有效时加载行列表
       if text_path and arcpy.Exists(text_path):
           with open(text_path, 'r', encoding='utf-8') as f:
               # 读取所有非空行 去除首尾空格
               item_list = [line.strip() for line in f if line.strip()]
           # 把列表赋值给选择参数的可选值
           parameters[1].filter.list = item_list
           # 若当前选中的项不在新列表中，清空等待重选
           if parameters[1].valueAsText not in item_list:
               parameters[1].value = None
       else:
           # 文本文件无效时清空选项
           parameters[1].filter.list = []
           parameters[1].value = None
       return
   

方案2：多选/灵活配置场景（用户可选择多个行项） #

改用GPValueTable类型，支持在表格中勾选多个目标：

1. 参数定义调整为：

   selection_table = arcpy.Parameter(
       displayName="选择目标列表项",
       name="selection_table",
       datatype="GPValueTable",
       parameterType="Required",
       direction="Input")
   # 定义值表结构：第一列为下拉选择的列表项
   selection_table.columns = [["GPString", "可选列表项"]]
   

2. 在updateParameters中给值表列绑定读取到的行列表即可，交互上用户可以在表格中多行选择不同的文件行项。

原生的parameterDependencies自动枚举选项的逻辑是硬编码匹配的：

• 只有当被依赖入参为DEFeatureClass、DPTable等带结构化字段的类型时，Field类参数才会自动枚举字段名
• 对文本文件这类无内置结构解析规则的入参，所有关联参数的可选值都需要开发者手动在updateParameters中编写逻辑刷新，不存在可以直接靠依赖自动加载的捷径。

内容的提问来源于stack exchange，提问作者lasagna42