列表拼接成字符串

📖 节点概述

将列表中的所有元素拼接成一个字符串，元素之间用指定的分隔符连接。输入可以是列表对象或多行文本（每行一个元素）。输出为拼接后的字符串。该节点为纯数据节点，无执行端口。

💡 使用场景：

• 生成 CSV 行：将字段列表用逗号拼接成 CSV 格式的一行。
• 构造路径：将路径片段用 / 或 \ 拼接成完整路径。
• 生成查询字符串：将参数列表用 & 连接成 URL 查询参数。
• 日志格式化：将多个信息片段用空格或特定分隔符合并成一条日志。
• 配置生成：将多个配置项用换行符 \n 拼接成多行文本。

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

节点有两个输入端口：数据列表 和 分隔符，输出端口 结果。

场景案例：将水果列表拼接成逗号分隔的字符串

1. 准备列表：在“数据列表”多行文本框输入：

   apple
   banana
   cherry
   

   或从上游传入列表 ["apple", "banana", "cherry"]。

2. 设置分隔符：在“分隔符”输入框中填写 ,（默认值）。

3. 获取结果：结果 输出 "apple,banana,cherry"。

4. 后续使用：将字符串写入文件或作为参数传递。

换行符拼接示例：

• 列表：["line1", "line2", "line3"]
• 分隔符：\n（支持转义，实际表示换行符）
• 结果：

  line1
  line2
  line3
  

路径拼接示例：

• 列表：["home", "user", "docs"]
• 分隔符：/
• 结果："home/user/docs"

⚙️ 引脚与参数说明

📥 输入引脚

⚙️ 控件参数

📤 输出引脚

🔧 转义字符支持

分隔符支持常见的转义序列，会被转换为实际字符：

• \n → 换行符
• \t → 制表符
• \r → 回车符
• \\ → 反斜杠

例如分隔符设为 \n，则元素之间会以换行符连接。

⚠️ 注意事项

• 空列表：如果数据列表为空，结果为空字符串 ""。
• 元素类型：列表中的元素会自动转换为字符串（数字、布尔等均转为字符串形式）。
• 多行文本输入：按 splitlines() 拆分，且默认会过滤掉空行。如果需要保留空行，可使用 JSON 数组格式输入（如 ["a","","b"]）。
• 分隔符留空：如果分隔符设为空字符串，则元素直接首尾相接拼接（无间隔）。
• 性能：拼接操作时间复杂度 O(n)，n 为元素总长度。

💎 小贴士：

• 该节点是【分割字符串】的逆操作（当分隔符一致且元素中不包含分隔符时）。
• 需要生成 CSV 行时，若字段本身可能包含逗号，建议使用专门 CSV 节点或先对字段进行转义。
• 使用换行符 \n 作为分隔符可以将列表转为多行文本，便于显示或写入文件。
• 结合【列表去重】或【列表排序】节点，可以在拼接前对数据进行预处理。