多字符串拼接

📖 节点概述

将多个字符串按指定顺序拼接成一个字符串。支持动态增减输入端（右键菜单），最少 2 个输入，最多无上限。可选的拼接符（高级设置）用于在各部分之间插入分隔内容（如逗号、换行符等）。该节点为纯数据节点，无执行端口。

💡 使用场景：

• 动态生成消息：将多个变量内容拼接成完整的日志或通知文本。
• 构造 CSV 行：用逗号作为拼接符，将字段值组合成一行。
• 构建路径：用路径分隔符（如 /）拼接多个目录名。
• 多行文本合并：用换行符 \n 作为拼接符，将多个文本行合并为多行字符串。
• 动态表单拼接：根据用户输入的多个字段生成完整的描述文本。

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

节点通过动态端口接收至少 2 个字符串输入，按端口字母顺序（输入 1 → 输入 2 → 输入 3 ...）依次拼接。可在“高级设置”中指定拼接符。

场景案例：将姓、名、年龄拼接为描述文本

1. 获取数据：使用【变量获取】节点读取：
   • first_name = "张"
   • last_name = "三"
   • age = 28
2. 连接节点：
   • 右键单击【多字符串拼接】节点，添加端口至 3 个输入。
   • 依次连接 first_name → 输入 1，last_name → 输入 2，age → 输入 3（年龄会自动转字符串）。
3. 设置拼接符（可选）：展开“高级设置”，在“拼接符”中输入 （空格）或 -。
4. 获取结果：若拼接符为空格，结果为 "张 三 28"；若拼接符为空，结果为 "张三28"。
5. 后续使用：将结果用于显示或存储。

场景案例：生成逗号分隔的 CSV 字段

• 设置拼接符为 ,。
• 输入："apple", "banana", "cherry" → 结果 "apple,banana,cherry"。

场景案例：按行合并多段文本

• 设置拼接符为 \n（支持转义，实际表示换行符）。
• 输入："第一行", "第二行", "第三行" → 结果：

  第一行
  第二行
  第三行
  

⚙️ 引脚与参数说明

📥 输入引脚（动态）

⚙️ 控件参数

📤 输出引脚

🔧 处理流程

1. 收集所有动态输入端口（输入 1、输入 2……），并按字母顺序排列（即端口创建顺序）。
2. 自动忽略末尾未连线的幽灵端口（避免空值参与拼接）。
3. 将每个输入端口的实际值转换为字符串。
4. 若设置了拼接符（非空），则将其作为分隔符插入每两个相邻部分之间。
5. 返回拼接后的完整字符串。

⚠️ 注意事项

• 动态端口管理：右键单击节点可添加新输入端口，删除端口时对应的连线会自动断开。
• 空值处理：如果某个输入端口没有连线且没有默认值，该端口会被跳过（不会插入空字符串）。若需要占位空字符串，请确保输入端口有值（如连接【常量】节点并设为空字符串）。
• 拼接符转义：支持常见的转义序列，例如：
  • \n → 换行符
  • \t → 制表符
  • \r → 回车符
  • 如需字面反斜杠加字母，请使用 \\n（双反斜杠）。
• 类型自动转换：非字符串输入（如数字、布尔值）会自动转换为字符串（数字转为十进制表示，布尔值转为 "True"/"False"）。如需特定格式，请先使用【类型转换】节点。
• 大量输入性能：当输入端口数量非常多（如上百个）时，拼接操作仍可高效完成。

💎 小贴士：

• 若不需要拼接符，保持“拼接符”为空字符串即可直接连接各输入。
• 需要不同的前后缀或复杂格式时，可先拼接主内容，再使用【前缀/后缀追加】节点添加修饰。
• 使用转义拼接符 \n 可以方便地将多个字符串合并为多行文本。
• 该节点与【分割字符串】互为逆操作（当拼接符与分割符一致且无空字段时）。