列表合并

📖 节点概述

将多个列表按顺序合并成一个新列表。支持动态增减输入端口（右键菜单），最少 2 个列表。每个输入端口可以接受列表对象、JSON 数组字符串或多行文本（每行一个元素）。该节点为纯数据节点，无执行端口。

💡 使用场景：

• 数据汇聚：将从不同来源获取的多个列表合并为一个，统一处理。
• 配置合并：将多个配置文件中的列表项合并成一个大列表。
• 分页数据拼接：将从 API 分页获取的数据列表拼接成完整列表。
• 批量操作预处理：将多个小列表合并后一次性传给后续节点处理。
• 动态列表组合：在流程中根据条件生成多个子列表，最后合并输出。

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

节点通过动态端口接收至少 2 个列表，按端口顺序依次合并所有元素。

场景案例：合并三个订单来源列表

1. 准备数据：
   • 订单列表 A = ["ORD001", "ORD002"]
   • 订单列表 B = ["ORD003"]
   • 订单列表 C = ["ORD004", "ORD005"]
2. 连接节点：
   • 右键单击【列表合并】节点，添加端口至 3 个输入（默认 2 个）。
   • 将三个列表分别连接到 列表 1、列表 2、列表 3。
3. 获取结果：合并列表 输出 ["ORD001", "ORD002", "ORD003", "ORD004", "ORD005"]。
4. 后续使用：将合并后的订单列表用于批量发货或统计。

手动输入示例：

• 列表 1 文本框输入（每行一个）：

  苹果
  香蕉
  

• 列表 2 文本框输入 JSON：["橙子", "葡萄"]
• 输出：["苹果", "香蕉", "橙子", "葡萄"]

⚙️ 引脚与参数说明

📥 输入引脚（动态）

⚙️ 控件参数

📤 输出引脚

🔧 行为说明

• 按照端口创建顺序（列表 1 → 列表 2 → ...）依次读取每个列表的元素。
• 每个端口的解析规则与【列表反转】节点一致：支持列表对象、JSON 数组或多行文本。
• 合并过程中不会去重，保留所有原始元素（包括重复项）。
• 空列表会被跳过（不影响结果）。
• 合并操作生成新列表，不修改原列表。

⚠️ 注意事项

• 动态端口管理：右键单击节点可添加或删除输入端口。删除端口时对应的连线会自动断开。
• 幽灵端口处理：新增加的端口如果既没有连线也没有手动输入内容，会被自动忽略，不影响合并结果。
• 元素类型：列表中的元素支持任意类型，合并后原样保留（不会做类型转换）。
• 性能：合并操作的时间复杂度为 O(n)，其中 n 为所有列表元素总数。对于超大列表，注意内存占用。
• 输入解析：多行文本模式下，空行会被忽略；JSON 模式下需保证格式正确（使用双引号）。

💎 小贴士：

• 该节点与【Zip 并行打包】互补：前者用于串联（合并），后者用于并联（配对）。
• 如果需要去重，可以在节点后连接【列表去重】节点。
• 合并后的列表可直接用于【遍历列表】进行逐项处理。
• 动态端口的设计使得合并任意数量的列表变得非常灵活，无需串联多个节点。
• 由于是纯数据节点，可以在数据流中随时使用，无需执行信号触发。