for 列表遍历 (NodeForList)

📖 节点概述

基于列表数据的遍历节点，按顺序逐个取出列表中的元素，每取一个就执行一遍 循环体。适合批量处理数组或文本行，支持灵活的输入方式：手动输入（一行一个元素）或连线传入 JSON 数组。

💡 使用场景：

• 批量操作文件：遍历文件路径列表，依次删除、移动或重命名。
• 多行文本处理：逐行读取用户清单、日志内容并执行相应动作。
• 动态数组驱动：配合 API 返回的 JSON 数组，对每个对象进行解析入库。
• 自动化测试：遍历测试用例集，执行相同的校验流程并记录结果。

🎮 实战连线指南：如何正确使用它？

列表数据可以从控件直接输入，也可以由上游节点连线动态提供，优先使用连线数据。

场景案例：批量修改文件名

1. 准备列表：在【for列表遍历】节点中手动输入文件名（一行一个），或连线一个由【获取文件夹内文件列表】输出的文件名数组。
2. 串联循环体：将【for列表遍历】的 循环体 输出连接到【重命名文件】节点的执行入口。
3. 传递当前项：将【for列表遍历】的 当前项 输出连接到【重命名文件】的“旧文件名”引脚，再根据规则拼接出新文件名。
4. 完成处理：将【for列表遍历】的 完成 输出连接到【打印日志】节点，输出“所有文件改名完毕”。

空列表处理：如果列表为空，会直接触发 完成 出口，不会报错也不会执行 循环体。

⚙️ 引脚与参数说明

📥 输入引脚

📤 输出引脚

🧩 进阶用法

• 提前终止/跳过：循环体内可使用 跳出循环 或 继续循环 节点控制流程。
• 数据类型保留：通过 JSON 连线传入的列表会保留元素类型（数字、布尔值等），手动输入则全部为字符串。
• 控件占位：未连线时，可直接在控件中输入文本，支持换行和 JSON 格式，方便调试和测试。

💎 小贴士：当需要在一个循环内同时使用索引和元素时，直接将 当前索引 和 当前项 分别连线给下游节点即可，无需额外计算。