设置变量节点

设置变量节点只在循环体中可用，用于更新父循环节点定义的中间变量。它修改的是当前循环的运行状态，不是应用变量或用户变量；更新后的值可供本轮后续节点和下一轮循环继续使用。

使用前提

先在父循环节点的“中间变量”区域创建变量并设置初始值，再选中循环体添加设置变量节点。若父循环没有中间变量，变量选择列表为空，并提示先在父 Loop 节点中配置中间变量。

配置

配置项	说明
变量名	只能选择当前父循环中可写的中间变量。变量类型由父循环的定义决定，不能在本节点中修改。
变量值	可填写固定值，或引用当前项、循环体上游输出及其他可见变量。该项不可为空。
添加赋值	单个节点可以添加多行赋值；同一个父循环中间变量在当前节点内只能选择一次。至少保留一行赋值。
_loop_intermediate	只读对象，表示循环中间变量的执行结果，主要供循环运行时传递状态。
isSuccess	只读布尔值，表示本次设置变量操作是否成功。

目标变量和值必须类型兼容。固定值编辑器会沿用目标变量类型；引用上游参数时，需要自行选择兼容类型。对象或数组按新值整体写入，不会自动合并字段或追加元素；需要计算新结构时，应先在代码、文本处理等节点中得到完整结果，再进行赋值。

常见用法

• 累加循环计数；
• 保存上一轮模型或插件结果；
• 记录是否已经找到目标；
• 累积经过处理的数组或对象；
• 保存最后一个成功项。

执行顺序

设置变量节点执行前，排在它之前的节点仍读取旧值；执行成功后，本轮后续节点以及下一轮循环读取新值。若某条选择器分支没有经过设置变量节点，或在它之前执行了继续循环、终止循环，对应变量不会在该路径上更新。

设置变量节点与资源库中的“变量赋值”节点用途不同：前者只写当前父循环的中间变量，后者用于读写应用变量或用户变量，不要混用。

常见问题

为什么变量选择列表为空？

设置变量节点只能写入父循环的中间变量。返回父循环节点新增中间变量并保存，然后重新打开当前节点。

为什么下一轮仍读取旧值？

检查设置变量节点是否位于本轮实际执行路径上，以及选择器或继续循环节点是否绕过了该操作。

为什么同一个变量不能重复选择？

一个设置变量节点内，同一父循环中间变量只能配置一次。需要按先后顺序多次更新同一变量时，应拆成多个设置变量节点，并按执行顺序连接。

为什么引用上游变量后保存或运行失败？

检查引用值的数据类型是否与父循环中间变量一致，并确认引用节点位于当前循环体内的上游执行路径。设置变量节点不会自动进行字符串、数值、对象或数组之间的类型转换。