Windows安装ComfyUI常见问题 - AI技术

Windows 安装 ComfyUI 常见问题与排查清单
一环境与安装方式

建议使用官方 Windows 便携版（Portable）：解压即用，内置 Python 3.10+ 与所需依赖，避免系统环境冲突。下载地址：GitHub Releases 的 ComfyUI_windows_portable_nvidia.7z，解压到纯英文路径（避免中文与空格），双击 run_nvidia_gpu.bat 启动；无独显可用 run_cpu.bat。如需更新，运行 update/update_comfyui.bat。若使用源码或桌面版，需提前准备 Python 3.10+ 与 Git，桌面版还会在安装向导中引导安装依赖与镜像源。以上路径、启动方式与更新方法均为官方常见做法。

二启动与依赖报错

首次启动若报 No module named 'torch' 等缺包错误：保持网络可用，让启动脚本自动安装；若失败，进入 ComfyUI_windows_portablepython_embeded，执行安装命令（示例，按你的 CUDA 版本选择）：
便携版：python_embededpython.exe -m pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu118
源码/venv：pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu118

仍失败时，检查是否被防火墙/代理拦截，或换用稳定镜像源重试。

显存不足与性能问题：优先降低分辨率（如 1024→768）、减小 batch size；必要时启用低显存模式：在启动脚本参数末尾追加 --lowvram，或在命令行执行 python main.py --lowvram（便携版用 python_embededpython.exe 运行）。显存优化能显著降低 CUDA out of memory 概率。

三模型路径与共享

模型放置规范：将主模型放到 ComfyUI/models/checkpoints，VAE 放到 models/vae，LoRA 放到 models/loras，ControlNet 放到 models/controlnet，否则节点会报找不到模型。路径错误是新手最常见的问题之一。
与 Automatic1111 共享模型：复制 extra_model_paths.yaml.example 为 extra_model_paths.yaml，在 a111 段落设置 base_path 为你的 WebUI 根目录，即可复用同一套模型文件，避免重复占用磁盘。

四自定义节点与网络问题

大量红框“缺失节点/Missing Custom Nodes”：优先用 ComfyUI-Manager 的 “Install Missing Custom Nodes” 自动安装；若国内网络不稳定导致拉取失败，需学会手动安装：在 ComfyUI/custom_nodes 下执行
git clone https://github.com/作者/仓库名.git

或使用镜像加速：git clone https://ghproxy.com/https://github.com/作者/仓库名.git（如 http://mirror.ghproxy.com 也可用）。安装后重启，确认 custom_nodes 目录下已生成对应文件夹。

某些节点需额外步骤，务必阅读说明文档。

常见网络报错如 [WinError 121] 信号灯超时时间已到 或无法连接 raw.githubusercontent.com:443：多由 GitHub/raw 域名访问不稳定引起。可尝试更换网络、使用上述 GHProxy 镜像，或在 hosts 层面做临时解析优化（不建议长期关闭 SSL 验证）。

五端口占用与访问异常

打不开 http://127.0.0.1:8188：先检查是否已有多个 ComfyUI 实例占用端口；用命令查看 netstat -ano | findstr :8188 找到占用进程并结束。若端口冲突，换端口启动：
python main.py --port 8189（便携版用 python_embededpython.exe 运行）

随后访问 http://127.0.0.1:8189。同时排查防火墙/杀软是否拦截 Python 网络访问。