安装ComfyUI到Windows的注意事项

Windows 安装 ComfyUI 的关键注意事项
一 安装方式与路径

• 优先选择官方的 Windows 独立整合包（Portable Standalone Build），自带嵌入式 Python 与 CUDA 运行环境，解压即用，避免系统级环境冲突。下载后解压到路径短且无中文/空格的位置，例如：D:ComfyUI。如使用安装器，尽量保持默认路径，避免后续节点/依赖调用异常。为后续模型与节点预留充足磁盘空间。安装或首次启动过程需稳定网络以下载依赖与模型索引。

二 硬件与软件前置条件

• 系统建议：Windows 10/11（64 位）。显卡建议使用 NVIDIA（支持 CUDA）；无独显也可 CPU 模式运行，但速度很慢。内存建议 ≥16 GB，显存建议 ≥8 GB（复杂工作流/大模型需更高）。存储建议 ≥50 GB 可用空间（模型体积大）。安装 Git（用于插件/节点管理）。如使用原生源码方式，需准备 Python 3.10+ 与匹配的 CUDA（或 CPU 版 PyTorch）。

三 模型与插件管理

• 模型目录结构：将主模型（Checkpoint）放入 ComfyUI/models/checkpoints，其他如 VAE/LoRA/ControlNet 放入对应子目录。便携包默认模型目录在 ComfyUI_windows_portableComfyUImodels。如需与 A1111 WebUI 共享模型，复制 extra_model_paths.yaml.example 为 extra_model_paths.yaml，按示例配置 a1111 路径段并指向 WebUI 的模型目录，注意使用固态硬盘 + USB 3.0/Type‑C 以获得更快加载速度。插件建议先安装 ComfyUI-Manager（放于 custom_nodes），便于一键安装缺失节点与依赖；若网络不佳，可使用 镜像源或 GitHub 代理（如 ghproxy）进行克隆，必要时改为离线安装。

四 启动与网络常见问题

• 启动方式：便携包双击 run_nvidia_gpu.bat（有独显）或 run_cpu.bat（无独显）；原生方式在目录中执行 python main.py。成功后浏览器访问 http://127.0.0.1:8188。如端口被占用，启动命令追加 --port 端口号；如需局域网访问，追加 --listen。显存紧张时可加 --lowvram 降低显存占用（会牺牲速度）。更新维护可运行便携包目录 update 下的 update_comfyui.bat 或使用 Manager 的自检更新。常见网络报错（如 raw.githubusercontent.com 443、DNS 解析异常）可通过配置 hosts、切换 DNS 或使用代理解决；依赖缺失（ImportError/No module named xxx）按插件 README 执行安装，便携包可用 ......python_embededpython -m pip install -r requirements.txt 或执行节点提供的 install.py 完成补装。