ComfyUI Subgraph子图创建复用教程

当工作流中的连线增多时，重复连接固定节点组合会变得繁琐。ComfyUI的Subgraph功能可以将这些节点打包成一个可编辑的子图节点。如果进一步发布为Subgraph Blueprint，就可以直接从节点库中拖出，在其他工作流中即插即用。

在开始操作前，需要确认版本要求。创建和编辑子图需要ComfyUI前端至少为1.24.3版本；将子图发布到节点库则需要前端版本1.27.7及以上。官方文档截图来自nightly前端，按钮位置可能随版本略有调整。如果在画布上选中节点后未看到子图图标，请先升级ComfyUI，再刷新前端并重新打开工作流。

选择适合封装的节点

从需要整理的工作流画布开始。使用框选或按住组合选择键，选中要封装的节点。关键步骤是只选择真正属于同一功能的部分，例如模型加载、提示词编码和采样流程。像Sa ve Image这类需要留在外部的节点，不应包含在选择范围内。如果所有目标节点都处于选中状态，画布上方会弹出浮动工具栏。如果工具栏未出现，先点击画布空白处取消选择，再重新框选。如果误选了节点，先取消该节点的选中状态再创建子图，避免将外部输入或最终输出节点也封装进去。

黄色箭头所指的四向收拢样式按钮就是子图按钮。该按钮仅在选中节点时有效，因此在创建前确认选择范围，可以避免后续拆解重建的麻烦。

创建子图并检查外部接口

将选中节点折叠为子图

选中节点后，点击子图图标。ComfyUI会根据所选节点与外部节点之间的现有连线，自动生成子图的输入和输出端口。原来的节点组会变成一个带有子图标识的新节点，外部连线仍正确连接在对应端口上，即表示创建成功。如果创建后发现端口过多，说明选中的节点跨了多个功能，应先撤销，缩小节点范围后重新创建。如果外部连线丢失或类型不匹配，需返回原节点组，检查连接方向和数据类型。

截图中的Text to Image已成为子图节点，常用参数保留在节点表面，IMAGE输出仍连接着外部的Sa ve Image。当看到“内部收拢、外部连线保留”的状态时，即表示创建完成。

进入内部编辑模式

双击子图内部的空白处（注意不要双击控件），即可进入内部编辑模式。也可以点击子图的编辑按钮。进入后检查左侧输入槽、右侧输出槽以及内部节点的连线是否正确。默认标有“1”的槽位可用于添加新的对外连接；已有槽位可右键重命名、删除或断开连接。成功进入的标志是：顶部出现当前子图的导航路径，画布上同时显示内部节点和左右两侧的对外槽位。如果双击后仍停留在父工作流，说明点到了文本框或其他控件，应换一个节点内部的空白处点击。如果连接被拒绝，需核对两端数据类型，子图槽位也遵守普通节点的类型校验规则。

图内编号1为返回父级的导航区域，编号2和3分别代表外部输入与输出槽。调整完内部结构后，点击顶部导航路径或按Esc返回父工作流，再次确认子图表面的参数和端口是否符合预期。

将子图发布为可复用蓝图

打开发布入口

在父工作流中选中子图节点后，点击浮动工具栏上的书本形状发布图标。也可以打开更多菜单，选择Add Subgraph to Library。如果成功，屏幕中央会弹出Sa ve Subgraph to Library对话框。如果工具栏中没有书本图标或菜单中找不到发布选项，请确认前端版本至少为1.27.7，并且当前选中的是子图节点而非普通节点。

浮动工具栏上的书本图标和更多菜单中的Add Subgraph to Library执行相同的发布动作。普通的复制或Duplicate只会复制当前节点，不会将其加入可搜索的蓝图库。

命名并确认保存

在Sa ve Subgraph to Library对话框中，将默认名称改为能清晰描述输入、处理内容和输出的名称，然后点击Confirm。例如，使用“文本转图像基础链”或“放大后锐化”等名称，便于后续识别。对话框关闭后，Nodes面板的Subgraph Blueprints区域会出现对应条目，即表示成功。如果确认后找不到条目，先打开Nodes面板展开My Blueprints查看；如果仍未出现，检查是否只修改了当前节点名称而未执行发布动作。

对话框默认沿用当前子图节点的名称。该名称将作为搜索和识别蓝图的依据，因此在确认前将临时名称改为清晰易记的名称，以便后续使用。

从节点库再次使用子图

在左侧Nodes面板的Subgraph Blueprints中，通常位于My Blueprints下方。展开分类，找到刚保存的蓝图，像拖拽普通节点一样将其拖到当前画布上，然后连接输入输出。画布上会出现新的子图节点，端口和公开参数与保存时一致，也可独立进入编辑模式。如果找到节点但无法连接，需核对蓝图暴露的端口类型；如果参数或端口不合适，可进入该新实例进行调整。从蓝图添加到工作流的子图是互相隔离的，修改其中一个实例不会影响其他实例。

截图左侧已展开My Blueprints，发布后的子图与普通节点一样，可直接找到并拖入使用。蓝图适合保存已稳定、反复使用的节点组合。如果仍在频繁改线的实验流程中，建议先保留为当前工作流中的普通子图，以节省时间。

完成检查清单

1. ComfyUI前端至少为1.24.3；需要发布蓝图时至少为1.27.7。
2. 创建前只选中了属于同一功能的节点，外部输入和最终输出节点未被误选。
3. 创建后外部连线仍在，子图表面的输入、参数和输出与任务边界一致。
4. 内部编辑模式能正常打开，顶部导航、输入槽和输出槽都能正确识别。
5. 发布对话框中的名称具体好搜索，Nodes面板的My Blueprints能找到对应条目。
6. 从蓝图库拖入的新实例能独立编辑，并能按原端口类型接回工作流。