列表转字符串

📖 节点概述

将列表中的所有元素转换为字符串，并用指定的分隔符连接成一个字符串。输入支持列表对象、JSON 数组字符串或多行文本（每行一个元素）。输出为拼接后的字符串。该节点为纯数据节点，无执行端口。

💡 使用场景：

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

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

节点有两个输入端口：列表 和 分隔符（高级设置），输出端口 字符串。

场景案例：将水果列表用换行符拼接成多行文本

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

   apple
   banana
   cherry
   

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

2. 设置分隔符：展开“高级设置”，在“分隔符”输入框中填写 \n（表示换行符）。

3. 获取结果：字符串 输出：

   apple
   banana
   cherry
   

4. 后续使用：将该多行文本写入文件或显示。

CSV 行示例：

• 列表：["张三", "25", "北京"]
• 分隔符：,
• 结果："张三,25,北京"

路径拼接示例：

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

⚙️ 引脚与参数说明

📥 输入引脚

⚙️ 控件参数

📤 输出引脚

🔧 转义字符支持

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

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

例如分隔符设为 \t，则元素之间以制表符连接。

⚠️ 注意事项

• 元素自动转字符串：列表中的元素会通过 str() 转换为字符串。数字、布尔值等均会转换为对应的字符串形式。
• 空列表：如果列表为空，输出为空字符串 ""。
• 分隔符默认为换行：注意默认分隔符是 \n（换行），而非逗号。如需逗号分隔，请手动修改。
• 多行文本输入：在“列表”文本框中直接输入多行文本时，每行被视为一个元素（空行会被忽略）。如需保留空字符串作为元素，请使用 JSON 数组格式（如 ["a","","b"]）。
• 性能：拼接操作时间复杂度 O(n)，n 为元素总字符长度。

💎 小贴士：

• 该节点与【分割字符串】节点互为逆操作（当分隔符一致且元素中不包含分隔符时）。
• 使用换行符 \n 作为分隔符可以将列表转换为易于阅读的多行文本。
• 生成 CSV 行时，若字段本身可能包含分隔符（如逗号），建议先对字段进行转义或使用专门的 CSV 处理节点。
• 由于是纯数据节点，无需执行信号，可在数据流中直接使用。