字典转字符串

📖 节点概述

将字典对象转换为 JSON 格式的字符串。输入支持字典对象、JSON 字符串、Python 字典字面量或简易键值对格式（多行或逗号分隔）。提供美化输出选项，可选择生成紧凑或缩进格式的 JSON。该节点为纯数据节点，无执行端口。

💡 使用场景：

• API 请求体构建：将字典转换为 JSON 字符串，用于 HTTP 请求的 body。
• 数据持久化：将字典序列化为 JSON 字符串，便于存储到文件或数据库。
• 日志记录：将复杂字典格式化为可读字符串，输出到日志系统。
• 跨系统数据交换：将内部字典结构转换为标准 JSON，供外部系统解析。
• 调试查看：美化输出模式下，生成带缩进的 JSON，方便人工阅读。

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

节点有一个输入端口 字典 和一个输出端口 JSON字符串，以及一个高级选项“美化输出”。

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

1. 准备字典：在“字典”文本框中输入：

   name: 李四
   age: 30
   city: 上海
   

   或从上游连线传入字典对象 {"name": "李四", "age": 30, "city": "上海"}。

2. 美化输出：勾选“美化输出”（默认），输出带缩进的 JSON。

3. 获取结果：

   {
     "name": "李四",
     "age": 30,
     "city": "上海"
   }
   

4. 后续使用：将该字符串发送给 API 或写入文件。

紧凑输出示例：

• 不勾选“美化输出” → 输出：{"name":"李四","age":30,"city":"上海"}。

输入格式灵活性：

• JSON 字符串输入：{"product":"laptop","price":5999} → 直接转换（会先解析再输出，实际保留原内容，但建议直接用字典对象）。
• Python 字面量：{'name': '王五', 'score': 95} → 同样被解析后转为 JSON 字符串。

⚙️ 引脚与参数说明

📥 输入引脚

⚙️ 控件参数

📤 输出引脚

🔧 转换规则

• 节点内部会先将输入解析为 Python 字典对象（支持多种格式），然后调用 json.dumps() 进行序列化。
• 如果输入已经是字典对象，直接序列化。
• 如果输入是字符串，会尝试按照 JSON、Python 字面量、简易键值对的顺序解析。
• 解析失败则视为空字典 {}（不报错）。
• 输出使用 ensure_ascii=False，因此中文字符不会被转义为 \uXXXX，保持可读性。

⚠️ 注意事项

• 输入解析的健壮性：节点内置了多种解析方式，可以处理大多数常见格式。但对于很规格式（如混合类型、嵌套复杂表达式），建议直接使用标准 JSON 或字典对象输入。
• 美化输出的换行与缩进：美化模式会添加换行和空格，增加字符串长度。若下游需要紧凑格式（如节省网络流量），请取消勾选。
• 类型兼容性：字典中的值若包含不可 JSON 序列化的类型（如 datetime、Decimal），转换会失败。请提前使用【类型转换】节点处理。
• 循环引用：如果字典中存在循环引用（如 a["self"] = a），json.dumps() 会抛出异常，节点当前未做特殊处理，请避免此类结构。
• 空字典：输入为空字典时，输出 "{}"。

💎 小贴士：

• 该节点与【创建字典】节点配合，可实现字典 ↔ JSON 字符串的互转。
• 美化输出适合开发和调试阶段，便于人工检查数据结构。
• 生产环境中通常使用紧凑输出以减少传输体积。
• 如果输入的字典已经包含中文字符，默认输出会保留原字符，无需额外设置。