LogoWonderful Launcher
  • 产品
  • 价格
  • 解决方案
  • 文档
  • 博客
  • 获取帮助
  • 下载
自定义节点插件导入失败Manager 节点列表失败
插件与自定义节点
这篇翻译尚未标记为与英文已验证来源同步。它可以作为参考阅读,但不会被加入站点地图。

自定义节点

Needs verification

使用社区构建的插件和自定义节点扩展 ComfyUI。

你可以手动修复,也可以下载 Windows 版 Wonderful Launcher 自动诊断插件报错、依赖缺失和环境损坏,不用盲目重装。

免费下载 Windows 版

自定义节点是社区构建的插件,为 ComfyUI 添加新功能 — 从面部修复到视频生成再到高级超分辨率。

安装自定义节点

方法一:ComfyUI Manager(推荐)

ComfyUI Manager 是一个插件,可以让你直接在 ComfyUI 界面中浏览、安装和更新自定义节点。

安装 ComfyUI Manager:

  1. 在 ComfyUI/custom_nodes/ 文件夹中打开终端
  2. 运行:
git clone https://github.com/ltdrdata/ComfyUI-Manager.git
  1. 重启 ComfyUI

安装后,点击 ComfyUI 工具栏中的 Manager 按钮可以:

  • 浏览可用的自定义节点
  • 一键安装节点
  • 更新已安装的节点
  • 安装导入工作流中缺失的节点

方法二:手动 Git Clone

  1. 在 ComfyUI/custom_nodes/ 中打开终端
  2. 克隆节点仓库:
cd ComfyUI/custom_nodes
git clone https://github.com/[author]/[node-name].git
  1. 安装依赖(如果节点有 requirements.txt):
cd [node-name]

不要盲目运行 pip install -r requirements.txt。

  1. 先确认当前激活的 Python 环境(where python 或 which python)
  2. 检查 requirements.txt —— 看是否锁定了 torch、numpy、opencv 的版本
  3. 尽量只安装缺失的包:pip install <包名>
  4. 安装后运行 pip check 验证没有引入冲突
  1. 重启 ComfyUI

方法三:复制文件

一些简单的节点只是一个 .py 文件。直接将其复制到 custom_nodes/ 中:

ComfyUI/
└── custom_nodes/
    └── my_node.py

重启 ComfyUI 即可加载。

热门自定义节点

节点功能
ComfyUI-Manager浏览和安装其他自定义节点
ComfyUI-GGUF加载量化 GGUF 模型以降低 VRAM 使用
ComfyUI-Impact-Pack面部检测、分割、细节增强
ComfyUI-AnimateDiff将图片动画化为短视频
ComfyUI-IPAdapter使用参考图像引导生成风格
ComfyUI-ControlNet高级 ControlNet 支持(姿态、深度、边缘检测)
ComfyUI-VideoHelperSuite加载、预览和保存视频文件
ComfyUI-KJNodes实用工具节点合集
rgthree-comfy工作流组织和生活质量改善节点
efficiency-nodes-comfyui批处理和工作流效率工具

修复"红色节点"

工作流中的红色节点表示 ComfyUI 找不到所需的自定义节点。这通常发生在导入使用了你未安装的节点的工作流时。

使用 ComfyUI Manager:

  1. 点击 Manager 按钮
  2. 点击 Install Missing Custom Nodes
  3. Manager 会识别并安装所需内容
  4. 重启 ComfyUI

不使用 Manager:

  1. 阅读红色节点上显示的节点名称
  2. 在 GitHub 上搜索该节点
  3. 通过 git clone 手动安装

更新自定义节点

使用 ComfyUI Manager: 点击 Manager → Update All

手动更新:

cd ComfyUI/custom_nodes/[node-name]
git pull
pip install -r requirements.txt  # if exists

更新后重启 ComfyUI。

故障排除

问题解决方案
导入工作流后出现红色节点通过 Manager 或手动安装缺失的节点
节点已安装但不显示重启 ComfyUI。检查控制台是否有导入错误
启动时出现 ModuleNotFoundError节点需要额外的 Python 包。在节点文件夹中运行 pip install -r requirements.txt
节点冲突/崩溃某些节点之间不兼容。通过重命名文件夹来禁用(例如添加 .disabled)。参见依赖冲突
Manager 无法安装检查你的网络连接。某些网络会屏蔽 GitHub

深入了解

关于高级插件管理 — 节点映射、仓库迁移、批量安装和 Git LFS 问题 — 参见插件管理指南。如果你正在搭建复杂的多工作流环境,参见工作流环境配置。

如需系统性的错误诊断,请使用故障排除决策树。

你可以手动修复,也可以下载 Windows 版 Wonderful Launcher 自动诊断插件报错、依赖缺失和环境损坏,不用盲目重装。

免费下载 Windows 版
Keep reading:Fix Manager custom node list errorsCustom nodes broke the environmentFix plugin import failures

你可以手动修复,也可以下载 Windows 版 Wonderful Launcher 自动诊断插件报错、依赖缺失和环境损坏,不用盲目重装。

免费下载 Windows 版

Did this fix your issue?

Your answer helps prioritize verified ComfyUI repairs.

OpenCV / cv2 缺失

解决 ComfyUI 启动时出现 No module named cv2 错误的完整指南。

插件导入失败

Fix ComfyUI plugin import failed errors, missing custom nodes, red workflow nodes, and dependency drift without reinstalling your environment.

目录

安装自定义节点
方法一:ComfyUI Manager(推荐)
方法二:手动 Git Clone
方法三:复制文件
热门自定义节点
修复"红色节点"
更新自定义节点
故障排除
深入了解