> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# 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 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/LoopIteration/zh.md)

***

**Source fingerprint (SHA-256):** `c7072f22bd382f567792d2ea7a30312c64d33c213551f8983c25cd7b95adc4fb`