常见问题

安装问题

"CUDA is not available" 或 "Torch not compiled with CUDA"

原因： 安装的 PyTorch 不包含 CUDA 支持，或 CUDA 版本与 NVIDIA 驱动不匹配。

解决方法：

1. 检查你的 NVIDIA 驱动版本：在命令提示符中运行 nvidia-smi
2. 重新安装正确 CUDA 版本的 PyTorch：

pip uninstall torch torchvision torchaudio
pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu126

1. 如果你使用的是便携包，确保下载的是 NVIDIA 版本并且运行的是 run_nvidia_gpu.bat

ComfyUI Desktop 显示 "Unsupported device"

原因： Windows 上的 ComfyUI Desktop 需要支持 CUDA 的 NVIDIA GPU。Desktop 版本不支持 AMD 和 Intel GPU。

解决方法： 改用便携包或手动安装。

安装程序或应用被杀毒软件拦截

原因： Windows Defender 或第三方杀毒软件将 ComfyUI 标记为可疑程序。

解决方法：

1. 将 ComfyUI 的安装目录添加到杀毒软件的排除列表中
2. 对于 Windows Defender：设置 → 隐私和安全性 → 病毒和威胁防护 → 管理设置 → 排除项
3. 重新下载并再次尝试

7-Zip 解压失败

原因： 下载的文件被 Windows 锁定，或路径过长。

解决方法：

1. 右键点击 .7z 文件 → 属性 → 勾选 解除锁定 → 应用
2. 解压到较短的路径，例如 D:\ComfyUI，而非深层嵌套的文件夹
3. 确保你使用的是 7-Zip，而非 Windows 内置的解压工具

"Permission denied" 或包安装失败

原因： 以管理员身份运行 ComfyUI 或其安装程序，或安装到系统保护的文件夹。

解决方法：

1. 永远不要以管理员身份运行 ComfyUI — 这会导致 Python 包权限冲突
2. 不要安装到 C:\Program Files、C:\Windows 或 C:\ 根目录
3. 使用非系统路径，如 D:\ComfyUI 或 C:\Users\你的用户名\ComfyUI

Windows 长路径限制

原因： Windows 默认有 260 个字符的路径长度限制。自定义节点中的深层文件夹结构可能超出此限制。

解决方法： 在 Windows 10/11 中启用长路径：

1. 按 Win + R，输入 regedit，按回车
2. 导航到 HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem
3. 将 LongPathsEnabled 设置为 1
4. 重启计算机

或在 PowerShell 中运行（以管理员身份）：

New-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "LongPathsEnabled" -Value 1 -PropertyType DWORD -Force

---

运行时问题

CUDA 显存不足

原因： 你的 GPU 没有足够的 VRAM 来运行当前使用的模型或分辨率。参见系统要求获取各模型类型的 VRAM 指导。

解决方法（按顺序尝试）：

1. 关闭其他使用 GPU 的应用程序（浏览器、游戏、其他 AI 工具）
2. 降低图像分辨率（例如使用 512×512 替代 1024×1024）
3. 在启动命令中添加 --lowvram 参数
4. 使用 GGUF 量化模型（参见下载模型）
5. 对于视频模型：减少帧数和分辨率

工作流中出现红色节点

原因： 工作流使用了你尚未安装的自定义节点。

解决方法：

1. 安装 ComfyUI Manager
2. 在 Manager 中点击 Install Missing Custom Nodes
3. 重启 ComfyUI

"No checkpoint found" / 模型下拉菜单为空

原因： checkpoints 文件夹中没有模型文件，或文件放在了错误的位置。

解决方法：

1. 下载一个模型（参见下载模型）
2. 将 .safetensors 文件放入 ComfyUI/models/checkpoints/
3. 点击模型下拉菜单中的 Refresh，或重启 ComfyUI

浏览器显示空白页面或只有标题

原因： 浏览器兼容性问题。

解决方法： 使用最新版本的 Google Chrome。某些浏览器（特别是较旧版本的 Edge 或 Firefox）可能无法正确渲染 ComfyUI 界面。

生成速度极慢

原因： ComfyUI 可能在使用 CPU 而非 GPU 运行。

解决方法：

1. 检查控制台输出 — 启动时应该显示你的 GPU 名称
2. 如果使用便携包：确保你运行的是 run_nvidia_gpu.bat，而不是 run_cpu.bat
3. 如果使用手动安装：验证 PyTorch 是否支持 CUDA：

python -c "import torch; print(torch.cuda.is_available())"

应该输出 True。如果输出 False，请重新安装带 CUDA 支持的 PyTorch。

---

GPU 相关问题

RTX 50 系列（5070 Ti / 5080 / 5090）

参见 GPU 兼容性获取完整的驱动-CUDA-PyTorch 对照表。RTX 50 系列需要 CUDA 12.8+ 和特定的 PyTorch 构建：

1. 将 NVIDIA 驱动更新到最新版本
2. 安装 CUDA 13.0 版本的 PyTorch：

pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu130

1. 对于便携包，使用支持 CUDA 13.0 的最新版本

常见的 50 系列问题：

• SageAttention 编译错误 — 需要更新的构建工具
• Nunchaku 插件故障 — 检查是否有兼容 50 系列的版本
• xformers 崩溃 — 使用 PyTorch 内置的 attention（--use-pytorch-cross-attention）

Windows 上的 AMD GPU

参见 GPU 兼容性获取完整的 AMD 支持详情。Windows 上的 AMD 支持使用 DirectML，存在一些限制：

• 部分自定义节点不支持 DirectML
• 性能低于 CUDA
• 使用便携包的 run_cpu.bat 并添加 --directml 参数

---

网络问题

pip install 卡住或超时

原因： 网络限制、防火墙或代理阻止了 Python 包下载。

解决方法：

1. 尝试使用镜像源：

pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

1. 如果在代理后面，配置 pip：

pip install --proxy http://your-proxy:port -r requirements.txt

1. 在 ComfyUI Desktop 中：在设置向导中更改镜像设置

Git clone 失败

原因： GitHub 在你所在的地区被屏蔽或限速。

解决方法： 使用镜像或直接从 GitHub 发布页面下载 ZIP 文件。

---

没有找到你的问题？

尝试故障排除决策树进行系统性诊断。对于复杂的多插件环境，参见依赖冲突和工作流环境配置。

仍然无法解决？

如果以上方案都无法解决你的问题，你可以预约远程修复服务。我们通过屏幕共享连接并诊断你的具体配置 — 大多数问题在 30 分钟内即可解决。