安装 ComfyUI 自定义节点而不破坏 ComfyUI

如果你搜索的是 install ComfyUI custom nodes、ComfyUI custom nodes 或 ComfyUI Manager failed to get custom node list，请将本页作为安装的核心参考。正常安装自定义节点时请留在本页。当 Manager、导入或依赖项已经出现故障时，请跳转到对应的专项错误页面。

自定义节点是社区构建的插件，可为 ComfyUI 添加新功能，涵盖人脸修复、视频生成、高级放大等各类能力。它们同时也是破坏原本正常运行环境的最快方式之一。

这种情况通常发生在把安装当作简单的复制操作来处理时——而实际上，每个自定义节点都可能带来新的 Python 包、二进制依赖、版本冲突，或者只有在重启后才会暴露的导入问题。

快速答案

如果你搜索的具体是 ComfyUI Manager failed to get custom node list，本页属于背景知识，修复路径请参考 ComfyUI 自定义节点列表获取失败。

你实际遇到的是哪类自定义节点问题？

安装自定义节点

方法一：ComfyUI Manager（推荐）

ComfyUI Manager 是近期 ComfyUI 版本的官方包管理层。当前 Desktop 版本已内置。近期的便携版或手动安装版已将其集成到核心中，但可能需要先安装其依赖项并启用 manager 标志。

Desktop 用户

ComfyUI Desktop 默认已启用 Manager。重启应用后，在工具栏中找到 Manager 按钮即可。

近期便携版用户

在便携包根目录下，安装 manager 依赖项并启用 Manager 启动 ComfyUI：

.\python_embeded\python.exe -m pip install -r .\ComfyUI\manager_requirements.txt
.\python_embeded\python.exe -s .\ComfyUI\main.py --windows-standalone-build --enable-manager

近期手动安装用户

激活你用于启动 ComfyUI 的 venv，然后运行：

python -m pip install -r manager_requirements.txt
python main.py --enable-manager

旧版回退方案

如果你的版本仍使用旧式插件安装方式，请使用 ComfyUI Manager 团队文档中的旧版克隆方法：

cd ComfyUI/custom_nodes
git clone https://github.com/ltdrdata/ComfyUI-Manager.git comfyui-manager

Manager 可用后，使用 ComfyUI 工具栏中的 Manager 按钮来：

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

方法二：手动 Git 克隆

1. 在 ComfyUI/custom_nodes/ 目录下打开终端
2. 克隆节点仓库：

cd ComfyUI/custom_nodes
git clone https://github.com/[author]/[node-name].git

3. 仅当节点包含 requirements.txt 时才安装依赖项，并使用启动 ComfyUI 所用的同一 Python 环境：

4. 重启 ComfyUI

如果 Git 克隆失败

克隆失败意味着插件文件未能下载。安装 Python 包无法解决这部分问题。

克隆成功后，先重启 ComfyUI 再判断工作流情况。如果文件夹存在但启动日志显示 IMPORT FAILED，请切换到 插件导入修复 而非再次克隆同一仓库。

方法三：复制文件

一些简单节点只是单个 .py 文件。直接将其复制到 custom_nodes/ 目录下：

ComfyUI/
+-- custom_nodes/
    +-- my_node.py

重启 ComfyUI 以加载它。

常用自定义节点

如果你的工作流明确需要 Easy Use、Layer Style、rgthree 或 VideoHelperSuite，完成本安装概述后请前往 常用 ComfyUI 自定义节点包 路由页面。

修复"红色节点"

工作流中的红色节点表示 ComfyUI 找不到该工作流所需的后端节点类。这与插件有关，但与插件成功安装并不是同一回事。

实际的执行链如下：

1. 工作流请求某个节点类。
2. 某个自定义节点插件必须在启动时注册该类。
3. 插件只有在 Python 导入成功的情况下才能完成注册。
4. 这些导入可能依赖包、原生 wheel、CUDA、PyTorch 或平台特定的二进制文件。

因此，红色节点可能意味着"插件未安装"，也可能意味着"插件文件夹存在，但插件导入失败"。

使用 ComfyUI Manager：

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

不使用 Manager：

1. 读取红色节点上显示的节点名称
2. 在 GitHub 上搜索它
3. 通过 git clone 手动安装
4. 重启后检查启动日志中的 IMPORT FAILED

更新自定义节点

使用 ComfyUI Manager： 点击 Manager > Update All

手动更新：

cd ComfyUI/custom_nodes/[node-name]
git pull
python -m pip install -r requirements.txt  # 仅当此 Python 是启动 ComfyUI 所用的 Python 时

对于官方 Windows 便携包，请在便携包根目录下使用 .\python_embeded\python.exe -s -m pip ... 运行依赖安装，而不是依赖随机的系统 pip。

更新后重启 ComfyUI。

降低风险安装自定义节点

如果这台机器很重要，请按以下顺序操作：

1. 每次只安装一个节点或一个节点系列
2. 每次更改后重启 ComfyUI
3. 检查启动日志中的 IMPORT FAILED
4. 避免在未经测试的情况下叠加多个 requirements.txt 安装
5. 一旦发现依赖漂移立即停止

这种方式初期较慢，但远比事后修复损坏的环境快得多。

故障排查

进一步了解

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

如需系统性错误诊断，请使用 故障排查决策树。

如果当前环境已不稳定，请先保存完整 traceback、插件 requirements、当前 Python 路径和最近一次安装命令，再按最小化修复路径继续。

常见问题

安装 ComfyUI 自定义节点最安全的方式是什么？

在可用时优先使用 ComfyUI Manager。手动安装时，将节点克隆到 ComfyUI/custom_nodes/，仅在启动 ComfyUI 所用的 Python 环境中安装该节点的依赖项，然后在测试前重启。

为什么安装自定义节点会破坏 ComfyUI？

该节点可能更改了共享的 Python 包，例如 Torch、NumPy、OpenCV、Pillow、Transformers 或 Diffusers。如果 ComfyUI 在安装后失败，请在运行更多包命令之前先阅读第一条 IMPORT FAILED 或报错堆栈。

如果 Manager 无法获取自定义节点列表，我应该怎么做？

这通常是 Manager 注册表、网络、缓存或 GitHub 访问问题，而非正常的自定义节点安装步骤。请使用 ComfyUI 自定义节点列表获取失败。

相关指南

• ComfyUI 自定义节点列表获取失败
• 安装自定义节点后 ComfyUI 损坏
• 如何修复 ComfyUI 插件导入失败错误
• ComfyUI 依赖冲突

参考来源

• ComfyUI 官方自定义节点安装指南
• ComfyUI Manager 官方安装指南
• ComfyUI Manager 官方概述
• ComfyUI-Manager GitHub 仓库