装完模型、调好工作流之后，ComfyUI最好用的地方开始显现了：自定义节点（Custom Nodes）。
简单说，自定义节点就是社区开发者写的扩展插件——别人写好了，你装了就能用。目前ComfyUI社区有上千个自定义节点，覆盖了动画生成、人脸修复、视频处理、3D出图等等各种场景。
但自定义节点也是ComfyUI最让人崩溃的地方之一。装了报错、装不上、装好了不显示、版本冲突、依赖缺失——这些问题发生的频率远比你想象的高。
这篇文章不是列一堆节点让你照着装（那种文章太多了），而是把安装和排查的方法讲清楚，让你不管装哪个节点，出了问题知道怎么修。
---
在装任何其他节点之前，先装ComfyUI Manager。它是节点管理器，有了它，你可以直接在ComfyUI界面上搜索、安装、更新、卸载其他节点——不用再手动去GitHub下载文件。
安装方法：
1. 打开命令行，进入ComfyUI的custom_nodes文件夹（路径大概是ComfyUI/custom_nodes/）
2. 运行：
``
git clone https://github.com/ltdrdata/ComfyUI-Manager.git
`
3. 重启ComfyUI
重启后，界面右侧会出现一个"Manager"按钮。点进去，就能看到"Install Custom Nodes"、"Update All"等选项。
为什么一定要装它？ 因为手动装节点的流程是这样的：找到GitHub仓库→复制URL→进custom_nodes文件夹→执行git clone→手动pip装依赖→重启→测试。任何一个环节出错都不知道错在哪。有了Manager，它帮你做掉"git clone + pip install + 重启"这一整条链。
但Manager也有解决不了的问题，下面会说到。
---
打开ComfyUI→点Manager→"Install Custom Nodes"→搜索节点名→点Install→等它自动下载和安装依赖→重启。
这种方式的坑：
1. 网络问题。 Manager从GitHub下载节点代码，如果你的网络访问GitHub不稳定，下载会超时或失败。解决：换个时间段重试，或者用方式三手动装。
2. 依赖安装失败。 Manager安装完节点后会自动运行pip install -r requirements.txt来装依赖库。如果你的Python环境不标准（比如用anaconda、或者pip路径不对），这步会静默失败——节点装上了但运行时报"ModuleNotFoundError"。排查方法：在黑框（运行ComfyUI的命令行窗口）里看好红色报错信息，找到缺失的模块名，手动pip install <模块名>。
3. Manager自己可能不是最新版。 Manager也会更新，旧版Manager可能搜索不到新节点。如果搜不到你确定存在的节点，先进Manager更新一下它自己。
进custom_nodes文件夹，执行：
`
git clone <节点仓库URL>
`
然后进到节点文件夹，手动装依赖：
`
cd <节点文件夹名>
pip install -r requirements.txt
`
重启ComfyUI。
这种方式的坑：
1. 装错了依赖版本。 有些节点的requirements.txt里写死了某个库的版本，但你的Python环境已经装了更新版本，两者冲突。表现是安装时报错"dependency conflict"或者ComfyUI启动后闪退。解决：创建独立Python虚拟环境（venv），专给ComfyUI用，别跟系统Python混在一起。
2. 节点代码和ComfyUI版本不兼容。 ComfyUI更新很快，有些节点还停留在半年前的API上，更新后就用不了了。去看节点的GitHub页面，看"最近一次提交"的时间。如果超过6个月没更新，大概率用不了。 在Manager里安装的话，页面会显示"Last Updated"，同样看一眼再决定装不装。
在GitHub页面点"Download ZIP"，解压到custom_nodes文件夹里。
这种方式的坑：
1. 文件夹名多了一层。 GitHub的zip包解压后，外层文件夹名通常是项目名-branch名（比如ComfyUI-Manager-main），这会导致ComfyUI找不到节点文件。解压后进去看一眼，如果里面只有一个同名的子文件夹，把子文件夹复制到custom_nodes下，别留外面那层壳。
2. 不包含依赖。 git clone方式可以把依赖也拉下来（有些节点用git submodule管理依赖），zip包下来就只有节点本身的代码。依赖缺失了，运行报错，还得手动补。
---
1. 忘了重启。
装完节点必须重启ComfyUI。Manager有时候提示"Restart"按钮，点一下就好。手动装的，关掉黑框重新运行python main.py。
2. 节点被禁用了。
有些管理器版本中，节点会默认安装但不激活。在Manager的"Install Custom Nodes"里找到那个节点，看有没有"Enable"或"Disabled"的标记。如果是Disabled，点一下Enable再重启。
3. 节点在特定的菜单分类里。
ComfyUI的节点菜单是按分类组织的，不同的自定义节点会出现在不同的类别下（比如"image"、"loaders"、"WAS Suite"等）。如果你按习惯在"Add Node"里往下翻，可能会错过它。用搜索功能：在"Add Node"弹出的面板顶部输入节点名的一部分，直接搜。
4. 节点作者改了节点名称。
有些节点更新后改了类名——比如从"Load Image (Advanced)"改成了"Load Image Plus"。你按旧名字找不到，但新名字已经有了。去看节点的GitHub页面，README里通常会列出所有节点的名字和用途。
---
报错：ImportError: No module named 'xxx'
这是最常见的问题，意味依赖没装好。在ComfyUI的命令行窗口里看到这个报错后，记下缺失的模块名，打开新命令行窗口，激活你的Python环境，然后运行pip install <模块名>。
如果pip装好之后依然报这个错，说明你装依赖的Python环境和运行ComfyUI的Python环境不是同一个。 这种情况在使用Anaconda或便携版Python时很常见。确认ComfyUI在哪个Python环境下运行，然后找到对应的pip.exe路径，用它来装（比如C:\Users\你的用户名\AppData\Local\Programs\Python\Python310\Scripts\pip.exe install xxx`）。
报错：CUDA out of memory
某个节点运行时显存爆了。不是节点坏了，是你同时加载了太多东西。解决：降低图片分辨率、减少batch size、或者换个显存更小的模型。
报错：Failed to validate prompt
通常是工作流参数不匹配。比如某个节点要求输入是图像，但连给它的是文本。检查连接线和输入输出的类型标签，确保匹配。
---
不要一次性装太多节点。 有些人看到Manager里几百个节点，一口气全装上。结果是启动ComfyUI要5分钟，而且任意两个节点的依赖冲突就能把整个环境搞崩。
保留一份纯净的ComfyUI副本。 在你已经能正常出图的ComfyUI上，复制一份作为备份。以后折腾节点装坏了，直接还原。
看评论再装。 Manager里每个节点页面底部有GitHub的Issues链接。装之前点进去看一眼，看看最近有没有人说"坏了"、"不兼容"之类的反馈，能省掉很多排查时间。
评论区