文档 /
节点说明 /
LoopIteration
LoopIteration
此节点为循环式工作流提供迭代元数据。它接收基于列表的输入,并传递每个列表的第一个元素,因此循环可以跟踪当前索引、是否为第一步或最后一步、当前列表项以及任何运行中的迭代值。
节点说明
LoopIteration 更新于 2026-11-12
LoopIteration - ComfyUI Built-in Node Documentation
此节点为循环式工作流提供迭代元数据。它接收基于列表的输入,并传递每个列表的第一个元素,因此循环可以跟踪当前索引、是否为第一步或最后一步、当前列表项以及任何运行中的迭代值。
此节点为循环式工作流提供迭代元数据。它接收基于列表的输入,并传递每个列表的第一个元素,因此循环可以跟踪当前索引、是否为第一步或最后一步、当前列表项以及任何运行中的迭代值。缓存行为由 reuse_cache 标志控制。此节点被标记为仅供开发者使用。
输入
| 参数 | 描述 | 数据类型 | 必填 | 范围 |
|---|---|---|---|---|
iteration_index | 当前迭代的索引,以列表形式提供。第一个元素会传递到输出。 | INT | 是 | - |
is_first | 指示当前迭代是否为第一次迭代,以列表形式提供。第一个元素会传递到输出。 | BOOLEAN | 是 | - |
is_last | 指示当前迭代是否为最后一次迭代,以列表形式提供。第一个元素会传递到输出。 | BOOLEAN | 是 | - |
list_item | 本次迭代从列表中取出的项。可选;提供时,第一个元素会传递到输出,否则返回 None。 | ANY | 否 | - |
current_iteration_value | 当前迭代携带的值。可选;提供时,完整值会传递到输出,否则返回 None。 | ANY | 否 | - |
reuse_cache | 控制结果是否可以从缓存中复用。启用时,节点会保持稳定的指纹,以便复用缓存结果。禁用时,会生成不匹配的指纹,使节点在每次迭代时重新运行。 | BOOLEAN | 是 | - |
注意:此节点支持列表输入,这意味着每个输入都应以列表形式到达,而节点仅输出每个列表的第一个元素(current_iteration_value 除外,它按列表传递)。它还接受此处所列之外的额外输入。
输出
| 输出名称 | 描述 | 数据类型 |
|---|---|---|
iteration_index | 当前迭代的索引。 | INT |
is_first | 当前迭代是否为第一次迭代。 | BOOLEAN |
is_last | 当前迭代是否为最后一次迭代。 | BOOLEAN |
list_item | 本次迭代从列表中取出的项,未提供项时为 None。 | ANY |
current_iteration_value | 当前迭代携带的值,未提供值时为 None。该输出以列表形式返回。 | ANY |
本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! 在 GitHub 上编辑
Source fingerprint (SHA-256): c7072f22bd382f567792d2ea7a30312c64d33c213551f8983c25cd7b95adc4fb