%20(1).png)
ComfyUI Simple Json Node 插件超详细新手教程
1. 插件简介
ComfyUI Simple Json Node 是一个专门处理JSON数据的插件包，GitHub地址：https://github.com/Q-Bug4/Comfyui-Simple-Json-Node
简单来说，这个插件就像一个万能的数据整理工具箱，可以帮你处理各种文本格式的数据。想象一下，你有一堆写着不同信息的小纸条（JSON数据），这个插件就像一个超级聪明的助手，能帮你：
- 从一堆数据中找到你想要的特定信息（就像在字典里找单词）
- 把两份数据合并成一份（就像把两本笔记本合并）
- 随机选择一个数据（就像抽签）
- 逐个查看数据列表（就像翻阅相册）
- 检查数据是否存在（就像查看某个联系人是否在通讯录里）
2. 如何安装
安装方法很简单，就像下载软件一样：
- 找到你的ComfyUI安装文件夹，进入
custom_nodes目录 - 在命令行中输入：
git clone https://github.com/Q-Bug4/Comfyui-Simple-Json-Node.git - 重启ComfyUI或者重新加载自定义节点
3. 节点详细解析
3.1 JSON解析器节点（JSONParserNode）
这个节点就像一个智能的信息提取器，能从一大堆数据中精确找到你想要的信息。
3.1.1 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| JSON字符串 | json_string | 文本输入 | 任意有效JSON | 就像一本字典，里面装着各种信息 | 包含结构化数据的JSON格式字符串 | 输入{"name":"小明","age":20}这样的文本 |
| 数据路径 | path | 文本输入 | 可选填写 | 就像告诉助手去第几页找什么内容 | 用点号分隔的路径表示法指向特定数据 | 输入name获取姓名，users.0.name获取第一个用户姓名 |
3.1.2 输出内容
| 输出名 | 输出类型 | 说明 |
|---|---|---|
| 解析数据 | parsed_data | 找到的具体信息内容 |
| 数组大小 | array_size | 如果找到的是列表，会告诉你有多少项 |
3.2 随机JSON值节点（RandomJSONValueNode）
这个节点就像一个抽奖机，能从你的数据中随机选择一个值。
3.2.1 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| JSON输入 | json_input | JSON数据 | 任意JSON | 就像一个装满彩票的盒子 | 包含多个值的JSON数据结构 | 输入包含多个选项的JSON数据 |
| 最大深度 | max_depth | 数字 | 3-5 | 决定抽奖机能翻到多深层的数据 | 限制随机选择时搜索的嵌套层数 | 设置为2表示最多搜索2层嵌套 |
3.2.2 输出内容
| 输出名 | 输出类型 | 说明 |
|---|---|---|
| 随机值 | random_value | 随机选中的那个幸运数据 |
3.3 JSON对象遍历节点（JSONObjectIteratorNode）
这个节点就像一个自动翻页器，能按顺序查看数据中的每一项内容。
3.3.1 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| JSON输入 | json_input | JSON对象 | 任意JSON对象 | 就像一本通讯录，里面有很多联系人 | 包含键值对的JSON对象 | 输入包含多个属性的JSON对象 |
| 索引 | index | 数字 | 0开始 | 就像页码，告诉你现在看第几页 | 当前遍历位置的索引值 | 0表示第一项，1表示第二项 |
| 模式 | mode | 选择项 | incr | 决定是固定看一页，还是自动翻页 | 遍历模式：固定/递增/递减 | incr会自动翻到下一页 |
3.3.2 输出内容
| 输出名 | 输出类型 | 说明 |
|---|---|---|
| 键名 | key | 当前项的名字（比如联系人的姓名） |
| 值 | value | 当前项的内容（比如联系人的电话） |
| 当前索引 | current_index | 现在看到第几项了 |
| 总项数 | total_items | 总共有多少项 |
3.4 JSON数组遍历节点（JSONArrayIteratorNode）
这个节点就像一个自动播放器，能按顺序播放列表中的每一项。
3.4.1 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| JSON输入 | json_input | JSON数组 | 任意JSON数组 | 就像一个播放列表，里面有很多歌曲 | 包含多个元素的JSON数组 | 输入["歌曲1","歌曲2","歌曲3"]这样的列表 |
| 索引 | index | 数字 | 0开始 | 就像播放进度，告诉你现在播放第几首 | 当前遍历位置的索引值 | 0表示第一首，1表示第二首 |
| 模式 | mode | 选择项 | incr | 决定是固定播放一首，还是自动播放下一首 | 遍历模式：固定/递增/递减 | incr会自动播放下一首 |
3.4.2 输出内容
| 输出名 | 输出类型 | 说明 |
|---|---|---|
| 项目 | item | 当前播放的歌曲内容 |
| 当前索引 | current_index | 现在播放第几首 |
| 总项数 | total_items | 播放列表总共有多少首歌 |
3.5 JSON合并节点（JSONMergerNode）
这个节点就像一个文件夹合并器，能把两个文件夹的内容合并成一个。
3.5.1 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| JSON输入1 | json_input_1 | JSON数据 | 任意JSON | 就像第一个文件夹 | 第一个要合并的JSON数据 | 输入基础信息的JSON |
| JSON输入2 | json_input_2 | JSON数据 | 任意JSON | 就像第二个文件夹 | 第二个要合并的JSON数据 | 输入补充信息的JSON |
| 合并策略 | merge_strategy | 选择项 | Override | 决定遇到重复文件时怎么处理 | 合并冲突的解决策略 | Override会用新的替换旧的 |
3.5.2 输出内容
| 输出名 | 输出类型 | 说明 |
|---|---|---|
| 合并JSON | merged_json | 合并后的完整数据 |
3.6 JSON修改节点（JSONModifierNode）
这个节点就像一个精确的编辑器，能找到特定位置并修改内容。
3.6.1 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| JSON输入 | json_input | JSON数据 | 任意JSON | 就像一本需要修改的书 | 要进行修改的原始JSON数据 | 输入包含现有数据的JSON |
| 路径 | path | 文本输入 | 有效路径 | 就像告诉编辑器修改第几页第几行 | 指向要修改位置的路径 | 输入name修改姓名字段 |
| 新值 | new_value | 任意值 | 要设置的值 | 就像要写入的新内容 | 要替换的新数据值 | 输入新的姓名或数值 |
3.6.2 输出内容
| 输出名 | 输出类型 | 说明 |
|---|---|---|
| 修改后JSON | modified_json | 修改完成的新数据 |
3.7 JSON生成节点（JSONGeneratorNode）
这个节点就像一个数据工厂，能根据你的要求生成新的数据结构。
3.7.1 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 键值对 | key_value_pairs | 文本输入 | 键值对列表 | 就像填写表格的每一行内容 | 要生成的JSON数据的键值对 | 输入name:小明,age:20这样的格式 |
| 是否数组 | is_array | 布尔值 | false | 决定生成的是文件夹还是文件列表 | 决定生成JSON对象还是数组 | true会生成列表格式 |
3.7.2 输出内容
| 输出名 | 输出类型 | 说明 |
|---|---|---|
| 生成JSON | generated_json | 工厂生产出的新数据 |
3.8 JSON长度节点（JSONLengthNode）
这个节点就像一个计数器，能告诉你数据有多少项。
3.8.1 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| JSON输入 | json_input | JSON数据 | 任意JSON | 就像一个装满东西的盒子 | 要计算长度的JSON数据 | 输入任意JSON数据或数组 |
3.8.2 输出内容
| 输出名 | 输出类型 | 说明 |
|---|---|---|
| 长度 | length | 盒子里有多少个东西 |
3.9 JSON键检查节点（JSONKeyCheckerNode）
这个节点就像一个门卫，能检查特定的信息是否存在。
3.9.1 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| JSON输入 | json_input | JSON对象 | 任意JSON对象 | 就像一本通讯录 | 要检查的JSON对象数据 | 输入包含各种信息的JSON |
| 键名 | key | 文本输入 | 要检查的键名 | 就像要查找的联系人姓名 | 要检查是否存在的键名 | 输入name检查是否有姓名信息 |
3.9.2 输出内容
| 输出名 | 输出类型 | 说明 |
|---|---|---|
| 是否存在 | exists | 门卫的回答：找到了还是没找到 |
| 值 | value | 如果找到了，这就是具体内容 |
3.10 JSON格式化节点（JSONFormatterNode）
这个节点就像一个排版师，能把乱糟糟的数据整理得整齐漂亮。
3.10.1 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| JSON输入 | json_input | JSON数据 | 任意JSON | 就像一份需要排版的文档 | 要进行格式化的JSON数据 | 输入任意JSON数据 |
| 缩进 | indent | 数字 | 4 | 决定每一层内容缩进多少空格 | 格式化时的缩进空格数 | 4表示每层缩进4个空格 |
| 排序键 | sort_keys | 布尔值 | false | 决定是否按字母顺序排列内容 | 是否按字母顺序排列键名 | true会按A-Z顺序排列 |
3.10.2 输出内容
| 输出名 | 输出类型 | 说明 |
|---|---|---|
| JSON字符串 | json_string | 排版师整理好的漂亮文档 |
4. 使用技巧和建议
4.1 路径表示法技巧
在使用路径查找数据时，可以使用点号来表示层级关系，使用方括号来表示数组索引：
- 简单对象：
name获取姓名 - 嵌套对象：
user.profile.name获取用户资料中的姓名 - 数组元素：
users[0]或users.0获取第一个用户 - 复杂结构：
users[2].profile.name获取第三个用户的姓名
4.2 合并策略选择
在使用合并节点时，有三种策略可选：
- Override（覆盖）：新数据会替换旧数据，就像重新装修房子
- Preserve（保留）：保留原有数据，只添加新的，就像在房子里添加新家具
- Concat（连接）：把两个数据连接起来，就像把两个房间打通
4.3 遍历模式使用
在使用遍历节点时，有三种模式：
- fixed（固定）：始终停留在同一项，就像单曲循环
- incr（递增）：自动前进到下一项，就像自动播放下一首
- decr（递减）：自动返回到上一项，就像倒序播放
5. 常见问题解答
5.1 为什么会出现错误？
插件会在以下情况报错：无效的JSON格式、无效的路径或键名、类型不匹配、数组索引超出范围。
解决方法：
- 检查JSON格式是否正确（可以用在线JSON验证工具）
- 确保路径存在且拼写正确
- 检查数组索引是否在有效范围内
5.2 如何处理中文数据？
插件完全支持中文数据，只要确保JSON格式正确即可。中文键名和值都可以正常使用。
5.3 可以处理多大的数据？
插件理论上可以处理任意大小的JSON数据，但实际受限于系统内存。建议单个JSON文件不超过100MB。
5.4 如何调试数据问题？
建议使用JSON格式化节点来美化数据，这样更容易发现问题。同时可以使用键检查节点来确认数据结构是否符合预期。
6. 高级应用场景
6.1 批量数据处理
可以结合数组遍历节点和修改节点，实现批量修改数据的功能。就像用复印机批量处理文件一样。
6.2 数据验证流程
使用键检查节点可以构建数据验证流程，确保输入数据包含所有必要字段。
6.3 动态数据生成
结合随机值节点和生成节点，可以创建动态变化的数据结构，适用于测试和模拟场景。
6.4 数据统计分析
使用长度节点可以快速获取数据规模信息，帮助进行数据分析和统计。
这个插件就像一个强大的数据处理工具箱，掌握了这些节点的使用方法，你就能在ComfyUI中轻松处理各种数据任务了！