入门启蒙ComfyUI 是什么从零搭建你的第一个 AI 绘图环境本文为系列第 1 篇带你从零认识 ComfyUI完成环境搭建并生成第一张 AI 图像。目录一、引言为什么选择 ComfyUI1.1 生成式 AI 工具对比ComfyUI 的核心优势1.2 本系列博客学习路线预告从入门到高阶1.3 适合人群与学习前提二、ComfyUI 核心介绍2.1 软件定位节点式生成 AI 界面与推理引擎2.2 核心特性可定制、开源、本地/云端双部署2.3 官方文档框架解读三、本地自托管安装全流程3.1 前置准备环境依赖与必备组件安装3.2 Windows 系统安装步骤3.3 macOS 系统安装步骤3.4 Linux 系统安装步骤3.5 本地启动与基础入口熟悉四、Comfy Cloud 部署与使用4.1 Comfy Cloud 注册与登录4.2 Cloud 平台基础导航4.3 本地与 Cloud 部署的选择建议五、自定义节点安装与首次 AI 绘图5.1 自定义节点的作用与常用节点推荐5.2 本地/Cloud 两种方式安装自定义节点5.3 加载默认工作流完成首次绘图5.4 首次操作常见问题排查六、总结与下一篇预告6.1 本章核心知识点回顾6.2 下一篇核心基础认知——读懂工作流与界面操作官方参考链接一、引言为什么选择 ComfyUI1.1 生成式 AI 工具对比ComfyUI 的核心优势在生成式 AI 飞速发展的今天AI 绘图工具早已从专业领域走进大众视野。从日常图片创作、设计原型到商业海报、影视素材制作AI 绘图正在重塑我们的创作方式。但面对市面上五花八门的工具——有的操作简单但自由度极低有的功能强大但门槛极高有的依赖云端且收费昂贵——很多学习者陷入了选工具难、学工具更难的困境。ComfyUI 的出现打破了这种困境。它兼顾了专业级 AI 绘图的高自由度和可定制性通过独特的节点式操作降低了学习门槛同时支持本地部署与云端使用双重模式完全开源免费。对比维度Stable Diffusion WebUIMidJourneyComfyUI操作门槛较高参数复杂需理解采样器、步长、CFG Scale 等概念低只需输入提示词即可生成低节点拖拽式操作无需编码直观易用自由度中等可调参数多但创作流程不够灵活极低无法控制中间流程只能被动接受结果高完全可自定义工作流与节点精准控制每个环节部署方式本地部署云端需科学上网本地 云端双模式成本免费收费基础版 10/月高级版10/月高级版60/月完全免费开源适合人群有一定基础的用户休闲用户、快速出图需求新手到专业用户全覆盖简单总结零基础新手想快速上手 AI 绘图 → ComfyUI 比 SD WebUI 更简单比 MidJourney 更自由、更省钱。专业设计师或开发者想实现精准控制 → ComfyUI 比 SD WebUI 更灵活比 MidJourney 更可控。1.2 本系列博客学习路线预告从入门到高阶很多新手在接触 ComfyUI 时都会陷入不知从何学起的困境。为此我们精心规划了从入门到高阶的完整学习系列共 6 篇遵循认知 → 实操 → 进阶 → 精通的逻辑循序渐进篇章标题核心内容博客 1本文入门启蒙ComfyUI 基础认知、本地与 Cloud 部署、自定义节点安装、首次 AI 绘图博客 2基础夯实核心概念工作流、节点、连线、界面全功能与基础设置详解博客 3实操精通上文生图、图生图、ControlNet、图像修复、3D 生成等案例拆解博客 4实操精通下视频生成、音频结合、Comfy Hub 生态、自定义节点进阶博客 5高阶进阶自定义节点开发、本地/Cloud API 集成、批量生成与工程化博客 6收尾总结故障排查、社区融入、学习路线复盘与持续提升整个系列严格对齐 ComfyUI 官方中文文档每篇都包含详细的实操步骤、案例解析和官方参考链接。1.3 适合人群与学习前提适合人群零基础新手对 AI 绘图感兴趣想快速上手生成第一张 AI 图像无需编程或设计基础设计师 / 创作者需要更灵活、更精准的 AI 绘图工具提升创作效率自媒体从业者 / 电商运营需要快速制作海报、封面、素材降低创作成本开发者 / 技术爱好者想深入了解 AI 绘图底层逻辑进行二次开发或功能扩展学生 / 职场人想掌握一项实用的 AI 技能提升个人竞争力学习前提无需编程基础、无需设计基础具备基本的电脑操作能力鼠标拖拽、网页浏览、文件下载本地部署硬件要求可选建议显卡显存 ≥ 4GB内存 ≥ 8GB硬盘预留 ≥ 20GB若选择 Comfy Cloud 云端部署则无需考虑硬件配置学习建议AI 绘图的核心是实践。多拖拽节点、调整参数、尝试不同的工作流才能真正掌握 ComfyUI。本系列每个实操步骤都详细易懂跟着操作即可轻松上手。二、ComfyUI 核心介绍在正式开始安装和实操之前先全面了解 ComfyUI 的核心定位与基本框架建立清晰认知避免盲目操作。2.1 软件定位节点式生成 AI 界面与推理引擎根据 ComfyUI 官方文档 的定义ComfyUI 是一个基于节点的生成式 AI 界面和推理引擎由 comfyanonymous 和其他贡献者共同开发完全开源可在本地设备上运行。这一定义包含三个核心定位节点式生成 AI 界面将 AI 绘图流程拆解为独立的功能节点如模型加载、提示词输入、图像生成等用户通过拖拽节点、连接线路形成工作流无需编写代码即可实现 AI 绘图。推理引擎不仅是一个操作界面更具备强大的底层计算能力支持 Stable Diffusion 等多种主流模型高效处理推理过程快速生成高质量图像。完全开源源代码公开可免费使用、修改、分发社区持续更新迭代功能不断完善。类比理解ComfyUI 就像AI 绘图的乐高积木——节点是积木块工作流是用积木搭建的作品你可以自由组合不同的积木搭建属于自己的创作流程。2.2 核心特性可定制、开源、本地/云端双部署① 高度可定制工作流可定制自由组合节点调整参数和连接方式创建专属工作流节点可定制可创建自定义节点添加新功能或修改现有节点甚至发布到社区② 完全开源免费所有源代码公开可免费下载、安装、使用无任何功能限制社区活跃更新迭代快自定义节点和工作流资源丰富③ 本地/云端双部署部署模式优势适合人群本地自托管不依赖网络、数据本地保存、零成本、可优化运行参数电脑配置较好、需离线使用、注重隐私的用户Comfy Cloud 云端无需配置环境、无需下载模型、开箱即用、随时随地访问电脑配置较低、移动办公、不想折腾环境的用户此外ComfyUI 还具备兼容性强支持 Windows / macOS / Linux、操作灵活节点拖拽、工作流导入导出、快捷键、社区活跃大量优质工作流和教程资源等特性。2.3 官方文档框架解读ComfyUI 官方中文文档 是我们最权威的参考资料主要分为 8 个核心模块模块内容适用阶段开始使用下载安装、首次生成新手入门基础概念工作流、节点和连接新手入门Comfy Hub优质工作流浏览与发布进阶提升学习与教程界面指南、教程示例新手入门内置节点所有内置节点功能与参数进阶提升开发与扩展开发指南、自定义节点、API开发需求获取帮助联系支持、故障排除遇到问题时社区资源加入社区、交流分享持续学习阅读建议新手重点关注开始使用基础概念学习与教程三个模块有开发需求时再关注开发与扩展遇到问题优先查看获取帮助→故障排除。三、本地自托管安装全流程本地部署是大多数用户最常用的方式——免费使用所有功能、保护隐私、熟悉完整安装流程。本部分针对三大主流系统分别讲解确保零基础新手也能顺利完成安装。硬件前提显卡显存 ≥ 4GB内存 ≥ 8GB硬盘预留 ≥ 20GB 空间。请确保电脑已连接网络。3.1 前置准备环境依赖与必备组件安装安装 Python 3.10ComfyUI 的运行依赖 Python 环境建议安装 Python 3.10 版本过高可能存在兼容性问题过低则缺少必要功能。下载安装包Python 3.10 官方下载Windows选择 Windows Installer (64-bit)macOS选择 macOS 64-bit universal2 installerLinux选择 Gzipped source tarballWindows 注意安装时务必勾选Add Python 3.10 to PATH验证安装打开命令行终端输入python --version显示Python 3.10.x即成功安装 Git通过 Git 下载 ComfyUI 的源代码。下载安装包Git 官方下载macOS M1/M2 芯片用户需下载适配芯片的版本Linux 可用命令安装sudo apt-get install gitUbuntu或sudo yum install gitCentOS验证安装git --version显示版本号即成功提前准备 AI 模型ComfyUI 本身不包含 AI 模型需自行下载。新手建议先下载Stable Diffusion 1.5或Stable Diffusion XL模型可从 Hugging Face 或官方文档推荐渠道获取。下载后记住模型保存路径后续需放入指定文件夹。3.2 Windows 系统安装步骤Step 1创建安装文件夹在磁盘中创建一个文件夹如D:\ComfyUI命名不要包含中文、空格或特殊字符。Step 2下载 ComfyUI 源代码cd D:\ComfyUI git clone https://github.com/comfyanonymous/ComfyUI.git网络不稳定可直接访问 GitHub 仓库点击 Code → Download ZIP解压到安装文件夹。Step 3安装依赖组件python -m venv venv venv\Scripts\activate pip install -r requirements.txt常见问题pip不是内部命令 → 重新安装 Python 并勾选 Add Python to PATH下载缓慢或失败 → 使用清华源pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simpleStep 4放置 AI 模型将下载好的模型文件.ckpt或.safetensors格式复制到models\checkpoints文件夹中。不要修改文件名不要放在中文路径下。建议新手先只放一个模型。Step 5启动 ComfyUIpython main.py启动成功后命令行显示Running on local URL: http://127.0.0.1:8188。打开浏览器访问该地址即可看到 ComfyUI 界面。启动失败若提示ImportError重新安装依赖若提示模型加载失败检查模型路径若端口被占用关闭占用 8188 端口的其他程序。Step 6创建快捷启动脚本可选新建文本文件写入以下内容保存为启动ComfyUI.bat保存类型选所有文件后续双击即可启动echo off cd /d D:\ComfyUI venv\Scripts\activate python main.py3.3 macOS 系统安装步骤Step 1创建安装文件夹在应用程序或桌面创建文件夹命名为ComfyUI不要包含中文、空格或特殊字符。Step 2下载 ComfyUI 源代码cd ~/Desktop/ComfyUI git clone https://github.com/comfyanonymous/ComfyUI.gitStep 3安装依赖组件python3 -m venv venv source venv/bin/activate pip3 install -r requirements.txtM1/M2 芯片用户注意如遇到依赖安装失败先安装适配 PyTorchpip3 install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cpu pip3 install -r requirements.txt权限不足在命令前加sudo如sudo pip3 install -r requirements.txt。Step 4放置 AI 模型将模型文件复制到models/checkpoints文件夹中。Step 5启动 ComfyUIpython3 main.py启动后在浏览器访问http://127.0.0.1:8188。Step 6创建启动脚本可选# 创建脚本文件 echo #!/bin/bash cd ~/Desktop/ComfyUI source venv/bin/activate python3 main.py start_comfyui.sh # 赋予执行权限 chmod x start_comfyui.sh后续双击start_comfyui.sh即可启动。3.4 Linux 系统安装步骤Ubuntu 示例Step 1创建安装文件夹mkdir -p ~/ComfyUI cd ~/ComfyUIStep 2安装前置依赖sudo apt update sudo apt install python3.10 python3.10-venv git -y验证python3.10 --version和git --version。Step 3下载 ComfyUI 源代码git clone https://github.com/comfyanonymous/ComfyUI.gitStep 4安装依赖组件python3.10 -m venv venv source venv/bin/activate pip install -r requirements.txt无显卡 / 无 NVIDIA 驱动安装 CPU 版 PyTorchpip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cpuStep 5放置 AI 模型cp /path/to/your/model.ckpt ~/ComfyUI/models/checkpoints/Step 6启动 ComfyUIpython3.10 main.py远程访问如需在其他设备访问启动时加--listen参数python3.10 main.py --listen确保防火墙开放 8188 端口sudo ufw allow 81883.5 本地启动与基础入口熟悉启动后访问http://127.0.0.1:8188进入主界面先熟悉以下核心区域区域位置用途工作流区域界面中央拖拽节点、连接线路、搭建工作流的核心区域节点列表区域界面左侧按分类排列的内置/自定义节点拖拽使用控制区域界面右上角Queue Prompt运行、Clear清空、Load加载、Save保存结果显示区域界面右下角显示生成结果支持保存、下载、重新生成模型选择区域Load Checkpoint 节点中选择放置在models/checkpoints中的 AI 模型四、Comfy Cloud 部署与使用4.1 Comfy Cloud 注册与登录通过 Comfy 官方云端平台使用 ComfyUI无需配置本地环境无需下载模型。注册访问 Comfy Cloud 官网使用邮箱或第三方账号注册登录登录后自动进入云端工作台注意事项基础功能免费部分高级功能如高级模型、批量生成可能收费4.2 Cloud 平台基础导航Cloud 平台的核心功能区域工作流编辑器与本地版一致支持节点拖拽操作模型库预置了常用 AI 模型开箱即用无需手动下载工作流市场浏览、导入社区分享的优质工作流生成历史查看和管理历史生成结果账户中心管理订阅、用量、API Key 等4.3 本地与 Cloud 部署的选择建议需求场景推荐部署方式原因电脑配置较好显卡 ≥ 4GB本地部署完全免费数据本地保存离线可用电脑配置较低 / 无独立显卡Cloud 部署无需下载模型和配置环境经常移动办公 / 多设备使用Cloud 部署随时随地访问无需携带设备注重隐私 / 数据保密要求高本地部署数据完全保存在本地不上传云端长期高频使用 / 批量生成本地部署零成本无用量限制五、自定义节点安装与首次 AI 绘图5.1 自定义节点的作用与常用节点推荐自定义节点是社区开发者创建的扩展节点可以大大扩展 ComfyUI 的功能官方节点ComfyUI 内置的基础节点满足核心绘图需求社区节点由社区贡献提供 ControlNet、视频生成、图像修复等高级功能推荐插件管理器ComfyUI Manager - 最常用的插件管理工具支持在 ComfyUI 界面中直接搜索、安装、更新、卸载自定义节点。5.2 本地/Cloud 两种方式安装自定义节点本地安装方式一通过 Git 手动安装cd custom_nodes git clone https://github.com/author/plugin-name.git # 重新启动 ComfyUI 即可生效本地安装方式二通过 ComfyUI Manager确保已安装 ComfyUI Manager 插件在 ComfyUI 界面中点击 Manager 按钮选择 Install Custom Nodes搜索需要的节点 → 点击 InstallCloud 安装方式Cloud 平台一般预装了常用节点可在工作流编辑器中直接添加需要的节点如节点缺失会有提示5.3 加载默认工作流完成首次绘图启动 ComfyUI默认会加载一个示例工作流在Load Checkpoint节点中选择已放置的 AI 模型在CLIP Text Encode (Positive)节点中输入正向提示词如a beautiful mountain landscape, sunshine, 4k在CLIP Text Encode (Negative)节点中输入反向提示词如blurry, low quality点击Queue Prompt按钮等待生成完成查看结果关键参数说明参数说明推荐初始值Steps步长生成图像的迭代次数越高细节越丰富但耗时更长20-30CFG Scale提示词遵循程度越高越贴近提示词但可能过度7-8Sampler采样器采样算法不同算法效果不同Euler / DPM 2M KarrasSize尺寸生成图像的宽度和高度512×5125.4 首次操作常见问题排查问题可能原因解决方法无法访问 127.0.0.1:8188ComfyUI 未启动 / 端口被占用检查命令行是否显示 URL关闭占用端口的程序模型加载失败模型路径错误 / 文件损坏检查模型是否在models/checkpoints目录下重新下载模型生成图像全黑/全灰模型选择错误 / 提示词问题切换模型检查提示词是否合理生成速度极慢显卡显存不足 / 未使用 GPU降低图像尺寸检查是否启用了 GPU 加速自定义节点不生效安装路径错误 / 未重启检查节点是否在custom_nodes目录下重启 ComfyUI六、总结与下一篇预告6.1 本章核心知识点回顾通过本文的学习你已经掌握了✅ ComfyUI 的核心定位——节点式生成 AI 界面与推理引擎✅ ComfyUI 的核心特性——高度可定制、完全开源免费、本地/云端双部署✅ 官方文档框架及各模块的查阅方法✅ 本地安装的全流程Windows / macOS / Linux✅ Comfy Cloud 云端部署的注册与使用✅ 自定义节点的安装方法手动安装 / Manager 安装✅ 首次 AI 绘图的完整操作步骤与参数解读6.2 下一篇核心基础认知——读懂工作流与界面操作下一篇我们将深入学习 ComfyUI 的核心基础概念——工作流、节点和连接全面掌握界面所有功能与基础设置学会看懂并简单调整工作流为后续的实操学习奠定坚实基础。官方参考链接关于 ComfyUI — 关于 ComfyUI本地自托管安装 → 开始使用 → 下载安装Comfy Cloud → Comfy Cloud自定义节点安装 → 开发与扩展 → 自定义节点安装相关首次生成 → 开始使用 → 首次生成ComfyUI Manager — 自定义节点管理器