桌面应用
在 Windows 上安装 ComfyUI 桌面版——最简单的入门方式。
ComfyUI 桌面版是官方的一键安装程序。它内置 Python，自动管理依赖项并处理更新。这是大多数用户推荐的安装方式。
请勿以管理员身份运行
安装或启动 ComfyUI 时，不要右键点击 → "以管理员身份运行"。以管理员身份运行会导致 Python 包权限冲突，可能会破坏你的安装。请使用普通用户账户。
第 1 步：下载
从 ComfyUI 官方网站下载安装程序：
comfy.org/download → 点击 "Download for Windows (NVIDIA)"
下载文件是标准的 .exe 安装程序，大约 100 MB。首次启动将下载额外的依赖项（约 15 GB）。
第 2 步：安装
- 双击下载的
.exe文件 - 按照 Windows 安装向导提示操作
- 桌面上将创建一个 ComfyUI 快捷方式
第 3 步：首次启动设置
双击桌面快捷方式启动 ComfyUI。首次启动会打开一个设置向导：
1. 欢迎界面
点击 "Get Started" 开始。
2. GPU 选择
选择 NVIDIA（应该会被自动检测到）。点击 Next。
3. 安装位置
选择存储 Python 环境、模型和自定义节点的位置。
提示
选择至少有 50 GB 可用空间的驱动器。强烈建议使用 SSD 以加快模型加载速度。完整硬件建议请参阅系统要求。
4. 迁移（可选）
如果你已有 ComfyUI 安装（便携版或手动安装），可以导入现有的：
- 模型和 checkpoints
- 自定义节点
- 工作流和设置
首次使用的用户：留空并点击 Next。
5. 桌面应用设置
配置：
- 自动更新 — 保持启用
- 使用统计 — 可选，匿名分析数据
- 镜像设置 — 如果你在中国或网络连接较慢，请选择替代镜像
镜像 URL 旁边显示绿色勾号表示连接正常。如果看到红色 X，请尝试其他镜像。
6. 安装完成
设置向导将下载并配置 Python 及所有依赖项。根据你的网速，这可能需要 5-15 分钟。
完成后，ComfyUI 会自动启动，你将看到节点编辑器界面。
更新
ComfyUI 桌面版在启动时会自动检查更新。你也可以通过应用菜单手动检查。
卸载
通过 Windows 设置 → 应用 → ComfyUI 卸载。请注意，这会删除应用，但可能会在安装目录中保留你的模型和自定义节点。如需彻底删除，请手动删除这些文件。
故障排查
| 问题 | 解决方案 |
|---|---|
| 安装程序被杀毒软件拦截 | 在杀毒软件设置中为 ComfyUI 安装程序添加例外 |
| "Unsupported device" 错误 | 你的 GPU 可能不支持 CUDA。查看 GPU 兼容性或尝试使用便携包搭配 --cpu 参数 |
| 镜像连接失败（红色 X） | 尝试其他镜像，或检查你的防火墙/代理设置 |
| 设置卡在 "Installing Python" | 检查你的网络连接。下载大小约 15 GB |
| 安装后应用无法启动 | 查看终端窗口中的错误日志。参阅常见问题 |
文件位置
安装后，你的文件结构如下：
[你的安装目录]/
├── python/ # 内置 Python（请勿修改）
├── ComfyUI/
│ ├── models/ # AI 模型存放位置
│ │ ├── checkpoints/ # 主模型文件
│ │ ├── loras/ # LoRA 文件
│ │ ├── vae/ # VAE 文件
│ │ └── ...
│ ├── custom_nodes/ # 社区插件
│ ├── input/ # 输入图片
│ └── output/ # 生成的图片
└── resources/ # 应用内部文件（请勿修改）重要提示
切勿修改 python/ 或 resources/ 目录中的文件。只操作 ComfyUI/ 文件夹中的内容。
下一步
如果这个问题已经碰到你真实在用的 ComfyUI 环境，先用 Wonderful Launcher 接管和检查当前机器，再配合文档决定怎么修。
下载 Wonderful LauncherDid this fix your issue?
Your answer helps prioritize verified ComfyUI repairs.