ComfyUI 教程
修复 ComfyUI 启动失败、缺包报错、插件错误和依赖冲突。
我想要...
Wonderful Launcher 快速开始
选择 ComfyUI 运行时包，从 Home 启动它，查看启动日志，并打开内嵌 Workspace。
ComfyUI 启动失败？如何更快地诊断和恢复
修复由损坏插件、依赖漂移、缺失包和脆弱环境导致的 ComfyUI 启动失败问题。
ComfyUI 插件导入失败：修复自定义节点错误
修复 ComfyUI 插件导入失败错误、损坏的自定义节点导入、工作流红色节点以及依赖漂移问题，无需重新安装环境。
ComfyUI 依赖冲突：无需重装即可修复
修复自定义节点安装、Torch 降级、pip 冲突、插件导入失败或 sensevoice-onnx、setuptools 等包版本锁定后引发的 ComfyUI 依赖冲突。
修复 ComfyUI 中的 No module named 错误
按包名、Python 环境、自定义节点依赖项以及 CUDA 或 PyTorch 不匹配问题诊断 ComfyUI ModuleNotFoundError 和 No module named 错误。
ComfyUI 模型文件夹中 Safetensors 文件应放在哪里
找到 safetensors 文件在 ComfyUI 模型文件夹中的正确位置：checkpoints、LoRA、VAE、ControlNet、Flux 扩散模型、文本编码器和放大模型。
ComfyUI 出问题了？故障排查决策树
系统化诊断 ComfyUI 故障——判断问题属于启动崩溃、插件冲突、依赖错误还是模型问题。
按分类浏览
入门
第一次使用 ComfyUI？从这里开始：
故障排除
修复常见问题：
缺包报错
修复 Python 导入错误：
ComfyUI ModuleNotFoundError: No module named 'torch' 修复
修复 ComfyUI 便携版、venv 和托管安装中的 ModuleNotFoundError: No module named 'torch'，并验证修复后的 Torch 构建仍然支持 CUDA。
修复 ComfyUI 中的 No module named 错误
按包名、Python 环境、自定义节点依赖项以及 CUDA 或 PyTorch 不匹配问题诊断 ComfyUI ModuleNotFoundError 和 No module named 错误。
ModuleNotFoundError: No module named 'cv2' in ComfyUI
修复 ComfyUI 中的 ModuleNotFoundError: No module named 'cv2'，解决 opencv-python-headless、opencv-contrib-python 缺失及 OpenCV 包冲突问题。
ComfyUI ModuleNotFoundError: No module named 'insightface' 修复
修复 ComfyUI 中 ReActor、IPAdapter FaceID、InstantID、PuLID 及其他换脸或人脸分析节点在 Windows 上报告 No module named 'insightface' 的问题。
模型与工作流
使用 AI 模型：
需要帮助？
先按上面的步驟定位根因。还卡住时，可以下载 Wonderful Launcher 检查目前机器；启动器原生修复、任务日誌和執行階段检查会集中在一起。credits 只用於图片生成和按量工具。