转为字符串

📖 节点概述

将任意类型的输入数据转换为字符串。对于基本类型（数字、布尔、None 等），直接调用 str() 转换。对于列表和字典，会自动转换为格式规范的 JSON 字符串（使用双引号、非 ASCII 字符原样保留）。输入为 None 时返回空字符串。该节点为纯数据节点，无执行端口。

💡 使用场景：

• 日志记录：将任意变量转换为字符串，便于输出到日志系统。
• 文本拼接前的准备：确保参与字符串拼接的变量都是字符串类型。
• 数据展示：将字典或列表格式化为可读的 JSON 字符串，用于界面显示或调试。
• 跨节点兼容：下游节点要求字符串输入时，使用本节点进行类型转换。
• 持久化前的序列化：将复杂数据结构转为字符串后写入文件或数据库。

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

节点有一个输入端口 数据（接受任意类型）和一个输出端口 字符串。

场景案例：将用户信息字典转换为字符串

1. 获取数据：从上游节点（如【创建字典】）得到字典 {"name": "张三", "age": 28}。
2. 连接节点：将该字典连接到【转为字符串】的 数据 端口。
3. 获取结果：字符串 输出 '{"name": "张三", "age": 28}'（有效的 JSON 字符串）。
4. 后续使用：将字符串写入日志或发送给 API。

其他类型转换示例：

• 数字 123 → "123"
• 布尔 True → "True"
• 列表 ["a","b"] → '["a","b"]'
• None → ""（空字符串）

⚙️ 引脚与参数说明

📥 输入引脚

📤 输出引脚

🔧 转换规则

• 数字、布尔、字符串等基本类型：直接调用 str()。
• 列表和字典：使用 json.dumps(val, ensure_ascii=False) 转换为标准 JSON 字符串，中文字符保留原样，不转义为 \uXXXX。
• None：返回空字符串 ""。
• 其他类型（如自定义对象）：若 JSON 序列化失败，则回退到 str()。

⚠️ 注意事项

• JSON 序列化限制：列表或字典中包含不可序列化的类型（如 datetime、Decimal、自定义类实例）时，json.dumps() 会抛出异常，此时节点会回退到 str()，结果可能不是 JSON 格式，而是 Python 的 repr 形式（如 {'a': datetime.now()}）。
• 空值处理：None 转为空字符串，而非 "None"，适应大多数日志和拼接场景。
• 性能：对于大型字典或列表，JSON 序列化会遍历整个结构，有一定开销。但对于常规数据量可接受。
• 输出格式：字典键名会被双引号包裹，字符串值也会使用双引号，符合 JSON 规范。

💎 小贴士：

• 需要将数字转为字符串时，该节点是合适选择。
• 如果需要自定义格式（如日期格式化），建议先使用【格式化字符串】或【类型转换】节点。
• 该节点是纯数据节点，无需执行信号，可在数据流中随时使用。