ComfyUI 教程

25. 自定义节点开发入门

参考Comfy官方开发文档，使用Python编写自定义节点： 1. 定义节点输入、输出数据类型； 2. 编写推理逻辑函数； 3. 注册节点，放置到custom_nodes目录； 4. 测试调试，打包发布至Comfy Registry官方节点库。

附录

A. 常用模型资源清单

• Flux.1 / Flux.2 Klein / FLUX3 Video：HuggingFace Black Forest Labs
• SDXL、SD1.5：Stability AI官方仓库
• ControlNet、LoRA、LoKr：Civitai、HuggingFace

  注意：部分模型需要阅读并同意协议后才可下载。

B. 常见报错速查表

1. Out of memory 显存溢出：使用FP8量化、开启KV Cache、降低分辨率；
2. 节点红色报错：自定义节点缺失依赖、模型路径错误；
3. 模型加载失败：文件损坏、后缀不是safetensors、路径含中文；
4. Flux生成黑图：T5/CLIP文本编码器缺失，VAE和模型不匹配。

C. 推荐学习路线

1. 安装ComfyUI，跑通基础SD文生图，熟悉界面与基础概念；
2. 手动搭建文生图、图生图、局部重绘工作流，吃透数据流；
3. 安装ComfyUI Manager，掌握自定义节点安装、更新；
4. 学习ControlNet、IP-Adapter、LoRA风格控制；
5. 上手Flux系列模型，掌握低显存优化技巧；
6. 学习视频工作流、API自动化，对接业务系统。