最近在AI绘画社区中ComfyUI凭借其节点式工作流设计吸引了大量用户但很多新手在部署阶段就遇到了各种问题。本文基于实际部署经验整理了一套完整的避坑指南覆盖Windows和Mac双平台安装、插件管理、节点部署等核心环节帮助新人用户快速搭建可用的AI绘画环境。1. ComfyUI核心概念与优势1.1 什么是ComfyUIComfyUI是一款基于节点式工作流的AI图像生成工具与Stable Diffusion WebUI的线性操作不同它采用可视化节点连接的方式构建图像生成流程。每个节点代表一个处理步骤如加载模型、文本编码、图像生成等用户通过连线将这些节点组合成完整的工作流。1.2 为什么选择ComfyUI相比传统WebUIComfyUI具有以下优势可复现性工作流可以保存为JSON文件便于分享和重复使用灵活性可以精确控制每个生成步骤的参数和流程资源效率节点式设计允许更精细的内存管理和计算优化扩展性丰富的自定义节点生态系统支持各种高级功能1.3 核心组件解析基础节点内置的图像生成、处理基础功能自定义节点社区开发的扩展插件增强软件功能工作流节点连接形成的完整处理流程模型Stable Diffusion模型文件需要单独下载2. 环境准备与前置要求2.1 硬件要求最低配置操作系统Windows 10/11 或 macOS 10.15内存8GB RAM显卡支持CUDA的NVIDIA显卡4GB显存以上或Apple Silicon芯片存储空间至少20GB可用空间用于存放模型文件推荐配置内存16GB RAM或更高显卡NVIDIA RTX 3060以上8GB显存或M1/M2系列芯片存储SSD硬盘至少50GB可用空间2.2 软件依赖Windows系统Python 3.10.x推荐3.10.6-3.10.11版本Git for WindowsVisual Studio Build Tools可选用于编译某些依赖macOS系统Python 3.10.x通过Homebrew或官方安装包Git通常系统自带或通过Xcode Command Line Tools安装Homebrew推荐用于管理依赖2.3 模型文件准备在开始安装前建议提前下载必要的模型文件基础模型checkpoint如SD 1.5、SDXL等VAE模型可选提升图像质量LoRA模型可选用于风格控制ControlNet模型可选用于姿势控制3. Windows系统安装指南3.1 安装Python环境# 下载Python 3.10.11安装包 # 安装时务必勾选Add Python to PATH # 验证安装 python --version pip --version3.2 安装Git# 下载Git for Windows并安装 # 验证安装 git --version3.3 部署ComfyUI方法一直接克隆仓库推荐# 创建项目目录 mkdir AI_Projects cd AI_Projects # 克隆ComfyUI仓库 git clone https://github.com/comfyanonymous/ComfyUI.git cd ComfyUI # 安装依赖 pip install -r requirements.txt方法二使用秋叶整合包适合新手从秋叶官网下载最新整合包解压到指定目录路径不要包含中文或特殊字符双击运行run_nvidia_gpu.batN卡用户或run_cpu.bat无独立显卡用户3.4 首次运行配置# 启动ComfyUI python main.py # 浏览器访问 http://127.0.0.1:8188 # 如果端口冲突可指定其他端口 python main.py --port 78604. macOS系统安装指南4.1 安装Homebrew和Python# 安装Homebrew如果尚未安装 /bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh) # 安装Python 3.10 brew install python3.10 # 配置环境变量根据终端提示操作 echo export PATH/opt/homebrew/opt/python3.10/bin:$PATH ~/.zshrc source ~/.zshrc4.2 部署ComfyUI# 克隆仓库 git clone https://github.com/comfyanonymous/ComfyUI.git cd ComfyUI # 创建虚拟环境可选但推荐 python3.10 -m venv comfyenv source comfyenv/bin/activate # 安装依赖 pip install -r requirements.txt # M系列芯片额外安装加速库 pip install torch torchvision torchaudio4.3 解决macOS特有问题权限问题处理# 给予执行权限 chmod x run.sh # 如果遇到安全性阻止在系统设置-隐私与安全性中允许应用运行性能优化配置# 使用Metal后端加速M系列芯片 export PYTORCH_MPS_HIGH_WATERMARK_RATIO0.0 python main.py --use-mps5. 插件安装与管理5.1 ComfyUI Manager安装ComfyUI Manager是管理插件的核心工具大多数现代ComfyUI版本已内置检查是否已安装启动ComfyUI后在界面中寻找Manager或插件管理相关按钮。手动安装如果需要cd ComfyUI/custom_nodes git clone https://github.com/ltdrdata/ComfyUI-Manager.git5.2 通过Manager安装插件点击界面中的Manager按钮选择Install Custom Nodes标签页搜索需要的插件名称点击Install按钮自动安装5.3 常用必备插件推荐ComfyUI-Impact-Pack功能丰富的节点扩展包ComfyUI-Advanced-ControlNet高级ControlNet控制ComfyUI-Inspire-Pack灵感节点包ComfyUI-Allor图像放大和增强工具ComfyUI-AnimateDiff动画生成支持5.4 手动安装插件方法当插件不在Manager仓库中时需要手动安装# 进入自定义节点目录 cd ComfyUI/custom_nodes # 克隆插件仓库 git clone [插件GitHub地址] # 安装依赖 cd [插件目录名] pip install -r requirements.txt # 重启ComfyUI6. 节点部署与工作流管理6.1 理解节点架构ComfyUI的节点系统分为几个核心类别输入节点Text节点文本提示词输入Load Image加载图像Random Seed随机种子生成处理节点Checkpoint Loader模型加载CLIP Text Encode文本编码KSampler图像采样生成输出节点Save Image保存图像Preview Image预览图像6.2 基础工作流搭建以下是一个简单的文本生成图像工作流配置{ nodes: [ { id: 1, type: CheckpointLoaderSimple, inputs: {ckpt_name: v1-5-pruned-emaonly.safetensors} }, { id: 2, type: CLIPTextEncode, inputs: {text: beautiful landscape, mountains, sunset, clip: [1, 1]} }, { id: 3, type: KSampler, inputs: {seed: 12345, steps: 20, cfg: 7.5, sampler_name: euler, scheduler: normal} } ] }6.3 工作流文件管理保存工作流在界面中点击Save按钮保存为JSON文件建议使用有意义的文件名如portrait_generation_workflow.json加载工作流点击Load按钮选择JSON文件或直接拖拽JSON文件到界面中工作流存放位置ComfyUI/ ├── workflows/ # 推荐的工作流存放目录 ├── output/ # 生成图像输出目录 └── models/ # 模型文件目录7. 常见问题排查与解决7.1 启动阶段问题问题1Python版本不兼容症状ModuleNotFoundError或语法错误 解决确保使用Python 3.10.x版本问题2端口被占用症状Address already in use 解决更换端口 python main.py --port 7860问题3依赖安装失败症状pip install过程中报错 解决使用国内镜像源 pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple7.2 运行时问题问题4模型加载失败症状Could not load model或文件不存在 解决检查模型文件路径和文件名确保文件完整下载问题5显存不足症状CUDA out of memory 解决降低图像分辨率使用--low-vram模式启动或使用CPU模式问题6插件冲突症状启动时报import错误或界面显示异常 解决通过Manager禁用最近安装的插件逐一排查冲突源7.3 平台特定问题Windows特有问题路径长度限制避免过深的目录嵌套权限问题以管理员身份运行命令提示符杀毒软件拦截将ComfyUI目录添加到白名单macOS特有问题ARM架构兼容性确保使用适配M芯片的Python版本Gatekeeper阻止在系统偏好设置中允许来自任何来源的应用内存管理M系列芯片注意监控内存使用情况8. 性能优化与最佳实践8.1 启动参数优化# Windows NVIDIA显卡优化 python main.py --gpu-only --highvram # macOS M系列芯片优化 python main.py --use-mps --lowvram # 低配置设备优化 python main.py --cpu --lowvram8.2 模型管理策略按需下载模型避免占用过多磁盘空间定期清理不使用的模型文件使用模型分类存放便于管理models/ ├── checkpoints/ # 基础模型 ├── loras/ # LoRA模型 ├── controlnet/ # ControlNet模型 └── vae/ # VAE模型8.3 工作流组织建议模块化设计将常用功能封装为子工作流版本控制对重要工作流使用Git进行版本管理文档注释在工作流中添加注释节点说明功能备份策略定期备份关键工作流和配置8.4 安全使用指南只从可信来源下载插件和模型定期更新ComfyUI和插件到最新版本在沙箱环境中测试新插件后再用于生产注意模型文件的版权和使用许可9. 进阶技巧与资源推荐9.1 工作流调试技巧使用Debug模式查看节点执行详情利用Preview Image节点实时监控生成过程保存多个版本的工作流进行对比测试9.2 社区资源利用官方文档ComfyUI GitHub Wiki视频教程YouTube上的ComfyUI频道社区论坛Reddit的r/ComfyUI板块工作流分享Civitai等平台的ComfyUI专区9.3 自定义开发入门对于想要深度定制的用户可以学习基础Python编程ComfyUI节点开发APIGit版本控制基础JSON格式和工作流结构通过本指南的系统学习你应该能够顺利完成ComfyUI在Windows和macOS平台的部署掌握插件安装和节点使用的基本技能。记住AI绘画工具的学习是一个渐进过程建议从简单工作流开始逐步探索更复杂的功能组合。
ComfyUI部署全攻略：Windows与macOS双平台AI绘画环境搭建指南
发布时间：2026/7/25 9:54:13
最近在AI绘画社区中ComfyUI凭借其节点式工作流设计吸引了大量用户但很多新手在部署阶段就遇到了各种问题。本文基于实际部署经验整理了一套完整的避坑指南覆盖Windows和Mac双平台安装、插件管理、节点部署等核心环节帮助新人用户快速搭建可用的AI绘画环境。1. ComfyUI核心概念与优势1.1 什么是ComfyUIComfyUI是一款基于节点式工作流的AI图像生成工具与Stable Diffusion WebUI的线性操作不同它采用可视化节点连接的方式构建图像生成流程。每个节点代表一个处理步骤如加载模型、文本编码、图像生成等用户通过连线将这些节点组合成完整的工作流。1.2 为什么选择ComfyUI相比传统WebUIComfyUI具有以下优势可复现性工作流可以保存为JSON文件便于分享和重复使用灵活性可以精确控制每个生成步骤的参数和流程资源效率节点式设计允许更精细的内存管理和计算优化扩展性丰富的自定义节点生态系统支持各种高级功能1.3 核心组件解析基础节点内置的图像生成、处理基础功能自定义节点社区开发的扩展插件增强软件功能工作流节点连接形成的完整处理流程模型Stable Diffusion模型文件需要单独下载2. 环境准备与前置要求2.1 硬件要求最低配置操作系统Windows 10/11 或 macOS 10.15内存8GB RAM显卡支持CUDA的NVIDIA显卡4GB显存以上或Apple Silicon芯片存储空间至少20GB可用空间用于存放模型文件推荐配置内存16GB RAM或更高显卡NVIDIA RTX 3060以上8GB显存或M1/M2系列芯片存储SSD硬盘至少50GB可用空间2.2 软件依赖Windows系统Python 3.10.x推荐3.10.6-3.10.11版本Git for WindowsVisual Studio Build Tools可选用于编译某些依赖macOS系统Python 3.10.x通过Homebrew或官方安装包Git通常系统自带或通过Xcode Command Line Tools安装Homebrew推荐用于管理依赖2.3 模型文件准备在开始安装前建议提前下载必要的模型文件基础模型checkpoint如SD 1.5、SDXL等VAE模型可选提升图像质量LoRA模型可选用于风格控制ControlNet模型可选用于姿势控制3. Windows系统安装指南3.1 安装Python环境# 下载Python 3.10.11安装包 # 安装时务必勾选Add Python to PATH # 验证安装 python --version pip --version3.2 安装Git# 下载Git for Windows并安装 # 验证安装 git --version3.3 部署ComfyUI方法一直接克隆仓库推荐# 创建项目目录 mkdir AI_Projects cd AI_Projects # 克隆ComfyUI仓库 git clone https://github.com/comfyanonymous/ComfyUI.git cd ComfyUI # 安装依赖 pip install -r requirements.txt方法二使用秋叶整合包适合新手从秋叶官网下载最新整合包解压到指定目录路径不要包含中文或特殊字符双击运行run_nvidia_gpu.batN卡用户或run_cpu.bat无独立显卡用户3.4 首次运行配置# 启动ComfyUI python main.py # 浏览器访问 http://127.0.0.1:8188 # 如果端口冲突可指定其他端口 python main.py --port 78604. macOS系统安装指南4.1 安装Homebrew和Python# 安装Homebrew如果尚未安装 /bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh) # 安装Python 3.10 brew install python3.10 # 配置环境变量根据终端提示操作 echo export PATH/opt/homebrew/opt/python3.10/bin:$PATH ~/.zshrc source ~/.zshrc4.2 部署ComfyUI# 克隆仓库 git clone https://github.com/comfyanonymous/ComfyUI.git cd ComfyUI # 创建虚拟环境可选但推荐 python3.10 -m venv comfyenv source comfyenv/bin/activate # 安装依赖 pip install -r requirements.txt # M系列芯片额外安装加速库 pip install torch torchvision torchaudio4.3 解决macOS特有问题权限问题处理# 给予执行权限 chmod x run.sh # 如果遇到安全性阻止在系统设置-隐私与安全性中允许应用运行性能优化配置# 使用Metal后端加速M系列芯片 export PYTORCH_MPS_HIGH_WATERMARK_RATIO0.0 python main.py --use-mps5. 插件安装与管理5.1 ComfyUI Manager安装ComfyUI Manager是管理插件的核心工具大多数现代ComfyUI版本已内置检查是否已安装启动ComfyUI后在界面中寻找Manager或插件管理相关按钮。手动安装如果需要cd ComfyUI/custom_nodes git clone https://github.com/ltdrdata/ComfyUI-Manager.git5.2 通过Manager安装插件点击界面中的Manager按钮选择Install Custom Nodes标签页搜索需要的插件名称点击Install按钮自动安装5.3 常用必备插件推荐ComfyUI-Impact-Pack功能丰富的节点扩展包ComfyUI-Advanced-ControlNet高级ControlNet控制ComfyUI-Inspire-Pack灵感节点包ComfyUI-Allor图像放大和增强工具ComfyUI-AnimateDiff动画生成支持5.4 手动安装插件方法当插件不在Manager仓库中时需要手动安装# 进入自定义节点目录 cd ComfyUI/custom_nodes # 克隆插件仓库 git clone [插件GitHub地址] # 安装依赖 cd [插件目录名] pip install -r requirements.txt # 重启ComfyUI6. 节点部署与工作流管理6.1 理解节点架构ComfyUI的节点系统分为几个核心类别输入节点Text节点文本提示词输入Load Image加载图像Random Seed随机种子生成处理节点Checkpoint Loader模型加载CLIP Text Encode文本编码KSampler图像采样生成输出节点Save Image保存图像Preview Image预览图像6.2 基础工作流搭建以下是一个简单的文本生成图像工作流配置{ nodes: [ { id: 1, type: CheckpointLoaderSimple, inputs: {ckpt_name: v1-5-pruned-emaonly.safetensors} }, { id: 2, type: CLIPTextEncode, inputs: {text: beautiful landscape, mountains, sunset, clip: [1, 1]} }, { id: 3, type: KSampler, inputs: {seed: 12345, steps: 20, cfg: 7.5, sampler_name: euler, scheduler: normal} } ] }6.3 工作流文件管理保存工作流在界面中点击Save按钮保存为JSON文件建议使用有意义的文件名如portrait_generation_workflow.json加载工作流点击Load按钮选择JSON文件或直接拖拽JSON文件到界面中工作流存放位置ComfyUI/ ├── workflows/ # 推荐的工作流存放目录 ├── output/ # 生成图像输出目录 └── models/ # 模型文件目录7. 常见问题排查与解决7.1 启动阶段问题问题1Python版本不兼容症状ModuleNotFoundError或语法错误 解决确保使用Python 3.10.x版本问题2端口被占用症状Address already in use 解决更换端口 python main.py --port 7860问题3依赖安装失败症状pip install过程中报错 解决使用国内镜像源 pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple7.2 运行时问题问题4模型加载失败症状Could not load model或文件不存在 解决检查模型文件路径和文件名确保文件完整下载问题5显存不足症状CUDA out of memory 解决降低图像分辨率使用--low-vram模式启动或使用CPU模式问题6插件冲突症状启动时报import错误或界面显示异常 解决通过Manager禁用最近安装的插件逐一排查冲突源7.3 平台特定问题Windows特有问题路径长度限制避免过深的目录嵌套权限问题以管理员身份运行命令提示符杀毒软件拦截将ComfyUI目录添加到白名单macOS特有问题ARM架构兼容性确保使用适配M芯片的Python版本Gatekeeper阻止在系统偏好设置中允许来自任何来源的应用内存管理M系列芯片注意监控内存使用情况8. 性能优化与最佳实践8.1 启动参数优化# Windows NVIDIA显卡优化 python main.py --gpu-only --highvram # macOS M系列芯片优化 python main.py --use-mps --lowvram # 低配置设备优化 python main.py --cpu --lowvram8.2 模型管理策略按需下载模型避免占用过多磁盘空间定期清理不使用的模型文件使用模型分类存放便于管理models/ ├── checkpoints/ # 基础模型 ├── loras/ # LoRA模型 ├── controlnet/ # ControlNet模型 └── vae/ # VAE模型8.3 工作流组织建议模块化设计将常用功能封装为子工作流版本控制对重要工作流使用Git进行版本管理文档注释在工作流中添加注释节点说明功能备份策略定期备份关键工作流和配置8.4 安全使用指南只从可信来源下载插件和模型定期更新ComfyUI和插件到最新版本在沙箱环境中测试新插件后再用于生产注意模型文件的版权和使用许可9. 进阶技巧与资源推荐9.1 工作流调试技巧使用Debug模式查看节点执行详情利用Preview Image节点实时监控生成过程保存多个版本的工作流进行对比测试9.2 社区资源利用官方文档ComfyUI GitHub Wiki视频教程YouTube上的ComfyUI频道社区论坛Reddit的r/ComfyUI板块工作流分享Civitai等平台的ComfyUI专区9.3 自定义开发入门对于想要深度定制的用户可以学习基础Python编程ComfyUI节点开发APIGit版本控制基础JSON格式和工作流结构通过本指南的系统学习你应该能够顺利完成ComfyUI在Windows和macOS平台的部署掌握插件安装和节点使用的基本技能。记住AI绘画工具的学习是一个渐进过程建议从简单工作流开始逐步探索更复杂的功能组合。
