30款热门AI模型一站整合DeepSeek/GLM/Qwen 随心用限时 5 折。 点击领海量免费额度ComfyUI作为当前最受欢迎的AI绘画工具之一以其节点式工作流和高度自定义能力吸引了大量用户。对于刚接触AI绘画的新手来说如何正确部署ComfyUI并避开常见陷阱是首要任务。本文将提供完整的Mac和Windows双平台部署指南涵盖从环境准备到插件安装的全流程。ComfyUI最大的优势在于其模块化设计用户可以通过连接不同节点构建复杂的图像生成流程。与WebUI相比ComfyUI对硬件要求更友好4GB显存即可运行基础功能同时支持CPU推理模式。本文将重点解决新用户在安装过程中遇到的依赖冲突、插件安装失败、工作流导入错误等典型问题。1. 核心能力速览能力项具体说明支持平台Windows 10/11、macOSIntel/Apple Silicon显存需求最低4GB推荐8GB以上启动方式命令行启动、一键启动脚本、Docker容器核心功能文生图、图生图、局部重绘、ControlNet、LoRA加载扩展能力自定义节点、工作流导入导出、API接口调用适合场景本地AI绘画、工作流实验、批量图像生成2. 环境准备与系统要求在开始安装前需要确保系统满足基本要求。Windows用户建议使用Windows 10或11系统macOS用户需要10.15或更新版本。两种平台都需要预留至少10GB的磁盘空间用于安装基础环境和模型文件。2.1 Windows环境准备Windows系统需要安装Python 3.10或3.11版本避免使用3.12等较新版本可能存在的兼容性问题。推荐使用Microsoft Store安装Python或从官网下载安装包。同时需要安装Git用于代码管理建议安装最新版Git for Windows。验证Python安装python --version # 应显示 Python 3.10.x 或 3.11.x pip --version # 确认pip包管理器可用2.2 macOS环境准备macOS用户需要安装Homebrew作为包管理器然后通过brew安装Python和Git。Apple Silicon芯片M1/M2用户需要确保使用ARM64版本的Python。安装Homebrew和依赖# 安装Homebrew /bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh) # 安装Python和Git brew install python git3. ComfyUI安装部署3.1 基础安装步骤两种平台的安装流程基本一致主要通过Git克隆代码库并安装依赖。# 克隆ComfyUI仓库 git clone https://github.com/comfyanonymous/ComfyUI.git cd ComfyUI # 安装依赖包 pip install -r requirements.txt对于国内用户如果下载速度较慢可以使用镜像源加速pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple3.2 模型文件准备ComfyUI需要基础的Stable Diffusion模型文件才能正常工作。将下载的模型文件.safetensors或.ckpt格式放置在ComfyUI/models/checkpoints目录下。推荐使用SD 1.5或SDXL基础模型作为起点。目录结构示例ComfyUI/ ├── models/ │ ├── checkpoints/ # 放置基础模型 │ ├── vae/ # VAE模型 │ ├── loras/ # LoRA模型 │ └── controlnet/ # ControlNet模型4. 启动与验证4.1 启动ComfyUI服务在ComfyUI目录下执行启动命令python main.py服务默认在127.0.0.1:8188启动在浏览器中访问该地址即可看到ComfyUI界面。首次启动时会自动下载必要的组件可能需要几分钟时间。4.2 基础功能测试启动后可以通过简单的工作流测试安装是否成功在左侧节点面板拖拽Load Checkpoint节点连接KSampler采样器节点添加CLIP Text Encode节点输入提示词连接VAE Decode和Save Image节点点击Queue Prompt生成测试图像如果能够正常生成图像说明基础安装成功。5. 自定义节点安装指南自定义节点是ComfyUI的核心扩展机制可以大幅增强软件功能。以下是三种主要的安装方法。5.1 使用ComfyUI Manager安装推荐ComfyUI Manager是管理自定义节点的图形化工具在较新版本的ComfyUI中已内置。通过Manager可以浏览、安装、更新社区节点。使用步骤启动ComfyUI后在界面中找到Manager按钮浏览可用节点列表或搜索特定功能点击安装Manager会自动处理依赖和配置重启ComfyUI使节点生效5.2 Git手动安装方法对于Manager中未收录的节点可以使用Git手动安装。以安装ControlNet预处理器节点为例# 进入custom_nodes目录 cd ComfyUI/custom_nodes # 克隆节点仓库 git clone https://github.com/comfyanonymous/ComfyUI_ControlNetPreprocessors.git # 安装依赖 cd ComfyUI_ControlNetPreprocessors pip install -r requirements.txt5.3 ZIP文件安装方法如果无法使用Git可以下载ZIP压缩包手动安装在GitHub页面点击Code → Download ZIP解压ZIP文件到ComfyUI/custom_nodes目录在节点目录中执行依赖安装重启ComfyUI服务6. 常见节点推荐与配置6.1 必备功能节点ComfyUI-Manager: 节点管理工具应优先安装Impact Pack: 提供大量实用节点包括分段、检测等功能ControlNet预处理器: 支持多种ControlNet预处理操作WD14标签器: 自动为图像生成标签便于图生图操作6.2 节点安装后的验证安装新节点后需要验证是否加载成功重启ComfyUI服务观察启动日志有无错误信息在节点搜索框中输入节点名称确认可以找到尝试使用节点构建简单工作流测试功能正常性7. 平台特定问题解决7.1 Windows常见问题端口占用问题 如果默认端口8188被占用可以指定其他端口启动python main.py --port 8190权限问题 某些操作可能需要管理员权限特别是在安装系统级依赖时。路径长度限制 Windows有260字符路径限制建议将ComfyUI安装在根目录下如C:\ComfyUI。7.2 macOS常见问题Apple Silicon芯片兼容性 M1/M2芯片用户需要确保使用ARM64版本的Python和依赖库。如果遇到架构错误可以尝试# 使用conda创建特定环境 conda create -n comfyui python3.10 conda activate comfyui权限设置 macOS可能阻止未知来源的脚本运行需要在系统偏好设置→安全性与隐私中允许相关操作。8. 性能优化建议8.1 显存优化配置对于显存有限的用户可以启用低显存模式python main.py --lowvram或者使用CPU卸载技术将部分计算转移到CPUpython main.py --cpu8.2 模型文件管理合理组织模型文件可以提升加载速度将常用模型放在SSD硬盘定期清理不使用的模型使用符号链接管理多个模型目录9. 工作流管理与分享9.1 工作流文件位置ComfyUI工作流文件.json可以保存在任意位置但建议建立专门目录进行管理。常见做法是在ComfyUI目录下创建workflows文件夹分类存放。9.2 工作流导入导出通过ComfyUI界面可以方便地导入导出工作流导出点击工作流界面右上角的Save按钮导入将.json文件拖拽到ComfyUI界面或使用Load按钮10. 故障排查指南10.1 启动失败排查问题现象可能原因解决方案启动时报Python错误依赖版本冲突创建新的虚拟环境重新安装页面无法访问端口占用或防火墙阻止更换端口或检查防火墙设置节点加载失败依赖未正确安装检查requirements.txt安装状态10.2 图像生成问题黑色图像输出 通常是VAE模型未正确加载检查VAE设置或重新下载VAE文件。显存不足错误 减小图像分辨率或启用低显存模式512x512是较安全的起始分辨率。节点连接错误 检查节点之间的数据类型匹配确保输入输出正确连接。11. 安全使用建议在安装自定义节点时务必注意安全性只从可信来源下载节点如官方仓库或知名开发者在安装前查看节点代码了解其功能实现定期更新节点和ComfyUI本体修复安全漏洞避免在生产环境直接使用未经测试的节点对于AI生成内容应遵守相关法律法规确保生成内容符合社会公序良俗不侵犯他人权益。ComfyUI的模块化设计为AI绘画提供了极大的灵活性虽然初期学习曲线较陡但一旦掌握就能发挥强大威力。建议新手从简单工作流开始逐步添加复杂功能同时积极参与社区交流能够更快掌握这一强大工具。 30款热门AI模型一站整合DeepSeek/GLM/Qwen 随心用限时 5 折。 点击领海量免费额度