这次我们聊的是 ComfyUI 中文整合包。如果你之前只玩过 Stable Diffusion WebUI刚开始接触 ComfyUI可能第一反应就是节点太多、界面全英文、不知道该从哪里下手。社区里流传的中文整合包就是专门解决这些问题来的。先给结论整合包做的事情是把 Python、PyTorch、ComfyUI 本体、常用自定义节点、模型管理、启动器和汉化扩展全部打包在一起。用户拿到手之后基本只需要解压、启动、进入浏览器页面不需要自己一步一步装依赖。Windows 和 Mac 都有对应的部署方式页面做了汉化中文提示词也有对应的处理思路。对于想从 WebUI 迁移到 ComfyUI、或者想跑别人工作流来做批量出图和可控生成的用户这套方案能省掉大量配置时间。这篇文章会把 ComfyUI 中文整合包的完整流程拆开讲核心能力、适用场景、环境准备、启动方式、功能测试、接口 API、批量任务、性能观察和常见问题排查都会覆盖。ComfyUI 本身迭代速度很快整合包的版本和细节在不同作者之间会有差异所以文中涉及具体路径、命令和参数的地方我会同时说明通用方法和需要按实际版本调整的部分。1. 核心能力速览能力项说明项目类型节点式 AI 图像生成工作流工具 中文社区整合包开源情况ComfyUI 本体开源中文整合包由社区维护主要功能文生图、图生图、局部重绘、ControlNet、Lora、批量出图、自定义工作流支持平台Windows / Mac具体以整合包版本为准显存需求视具体模型而定消费级显卡可跑常见模型低显存建议降低分辨率和批次数启动方式一键启动器 / 命令行启动界面语言整合包内置汉化扩展界面接近全中文中文提示词支持自动翻译节点或手动翻译后输入API 能力ComfyUI 自带 HTTP API可提交生成任务和查询历史记录批量任务支持工作流内批量出图也可通过 API 脚本批量调用适合场景工作流复用、可控出图、批量生成、AI 绘画学习与研究和 WebUI 相比ComfyUI 最大的区别是“节点式”。WebUI 更像一个填表界面选模型、写提示词、按生成ComfyUI 则是把生成流程拆成一个个节点再用连线把它们串起来。好处是流程透明、可复用、可精细控制坏处是刚上手时确实比 WebUI 陡。中文整合包的意义就是把最陡的安装和配置部分先解决掉。2. 适用场景与使用边界ComfyUI 中文整合包比较适合这几类人已经在用 WebUI但觉得批量出图、精细控制不够方便想转到 ComfyUI 的用户。想复用社区工作流文件又不想折腾依赖安装的新手。需要把图像生成接入到自己的脚本或服务里的开发者。需要使用 ControlNet、LoRA、角色一致性等复杂节点流程的研究者。整合包不适合的场景也要说清楚。ComfyUI 不是“输入一句话自动出图”的傻瓜工具它本质是一个流程编排工具。你仍然需要理解基础节点概念模型加载、正向提示词、反向提示词、采样器、解码器、保存图像。整合包只是把环境装好并不替你理解逻辑。如果你的目标只是偶尔生成一张头像WebUI 或在线工具可能更省事。使用边界方面有几点必须提醒生成图像涉及肖像、人脸、名字、人设时需要先确认授权。不要生成未经许可的真人肖像不要用 AI 图像制作证件、虚假信息或用于欺诈。下载模型和 LoRA 时注意检查模型来源的授权协议。商业用途前需要确认模型许可证允许商用。批量生成可能导致大量图片在无审核的情况下产出。公开使用前需要人工复核内容。不要用 ComfyUI 或其他生成工具制作违法、低俗、侵权内容。3. 环境准备与前置条件在下载整合包之前先确认机器环境能不能跑。3.1 Windows 检查清单64 位 Windows 系统建议 Windows 10 或 Windows 11。如果有 NVIDIA 独立显卡先更新驱动。驱动太老会导致 CUDA 相关报错。内存建议 16GB 起步8GB 能跑但会比较吃力。磁盘空间建议预留 20GB 以上。模型文件动辄几个 GB工作流也会占用空间。不需要手动安装 Python。整合包一般会自带便携版 Python 或依赖环境。启动前检查 8188 端口是否被占用。查看显卡信息nvidia-smi如果命令提示不是有效命令可以打开任务管理器在“性能”Tab 里查看 GPU 型号和显存大小。3.2 Mac 检查清单Apple SiliconM1/M2/M3/M4 系列或 Intel 芯片 Mac。尽量选择与芯片架构匹配的整合包版本。Apple Silicon 通常使用 MPS 加速Intel 芯片表现会弱一些。磁盘空间预留 20GB 以上。如果系统弹出来自未知开发者或安全提示先确认文件下载完整再按官方或整合包说明处理。查看 Mac 图形信息system_profiler SPDisplaysDataType3.3 公共检查点不管哪个平台都建议确认下面几项网络环境能稳定访问模型下载站点。模型下载慢或失败时先检查网络再检查磁盘空间。端口检查。ComfyUI 默认端口是 8188如果被占用可以换成其他端口启动。目录路径尽量不要带中文和空格。Windows 下把整合包放到纯英文路径能避免很多莫名其妙的报错。4. 安装部署与启动方式4.1 Windows 一键包启动社区常见的 Windows 整合包通常是“解压即用”形式。下载完成后整体流程是解压、双击启动器、等待依赖准备完成、进入浏览器。推荐路径规则D:\ComfyUI\ D:\ComfyUI\ComfyUI\ D:\ComfyUI\models\checkpoints\ D:\ComfyUI\models\loras\如果整合包提供了一键启动器双击启动等控制台出现类似地址后浏览器打开http://127.0.0.1:8188。如果是便携版且没有一键启动器可以参考命令cd /d D:\ComfyUI python_embeded\python.exe main.py --port 8188注意python_embeded是否存在于你的目录里取决于整合包结构。如果不存在说明不是便携版需要先安装依赖再启动。4.2 Mac 版本启动说明Mac 版整合包的启动方式有两种一种是官方源码配合汉化扩展另一种是社区维护的一键脚本包。这里给一套通用命令模板cd /path/to/ComfyUI source venv/bin/activate python main.py --port 8188如果你的包没有 venv 目录可能需要先创建虚拟环境并安装依赖cd /path/to/ComfyUI python3 -m venv venv source venv/bin/activate pip install -r requirements.txt python main.py --port 8188这里的路径、Python 版本、依赖安装方式都要按你实际下载的整合包说明调整不要直接照搬。4.3 不使用整合包手动启动 ComfyUI如果你不想用整合包也可以走手动安装流程。这个方法适合想要自己控制版本的开发者git clone https://github.com/comfyanonymous/ComfyUI.git cd ComfyUI python -m venv venv source venv/bin/activate # Windows 下执行 venv\Scripts\activate pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu121 pip install -r requirements.txt python main.py手动启动的好处是版本透明坏处是需要自己管理模型文件、自定义节点和依赖。对大多数想快速上手的用户来说整合包仍然更方便。5. ComfyUI 界面与中文提示词5.1 界面汉化与节点操作整合包内置汉化扩展后刚启动时的界面会接近全中文。常见的汉化扩展会翻译菜单、按钮和部分节点名称但不会翻译所有自定义节点的内部参数。原因是第三方节点的字段名来自不同作者不可能全部覆盖。进入页面后先认识几个核心区域节点区画布上的方块每个节点负责一个功能。连接线从一个节点的输出端口拖到另一个节点的输入端口表示数据流转。菜单按钮用于加载工作流、保存工作流、执行任务。模型选择器在“加载 Checkpoint”节点上选择要用的模型。拖动节点、拖线、双击空白处可以弹出节点搜索框。这些操作是所见即所得不需要写代码但需要理解数据流向。先跑通最小工作流再逐步加节点。5.2 中文提示词输入技巧“支持中文提示词”是很多人关注的重点。这里要先说明大多数 Stable Diffusion 系模型是基于英文训练数据训练的直接输入中文往往效果不稳定。整合包提供的中文提示词支持本质上是把流程改成了“中文输入 - 翻译成英文 - 再进入文本编码器”。常见做法有三种在节点链中加入翻译节点。中文输入进翻译节点翻译节点输出英文再连到 CLIP Text Encode。使用内置自动翻译扩展在正向提示词节点上直接输入中文由扩展自动翻译。手动写英文提示词。推荐的节点链结构是这样的中文提示词输入 - 翻译节点/自动翻译扩展 - 英文提示词 - CLIP Text Encode - KSampler测试时注意两点第一翻译节点的翻译质量会影响最终出图效果尤其是多义词、专有名词容易翻错第二如果你的整合包没有内置翻译节点安装自定义节点时优先选择社区常用的汉化和翻译扩展不要随便安装来源不明的插件。6. 功能测试与效果验证启动成功后先不要急着跑复杂工作流。用最小工作流验证基础能力。6.1 文生图测试这是 ComfyUI 最基础的功能测试。操作步骤加载默认工作流。整合包一般自带一个“文生图”初始工作流。在“加载 Checkpoint”节点选择一个已经下载的模型。正向提示词输入英文例如a cute cat, masterpiece, best quality。反向提示词输入常见负向词例如lowres, bad anatomy, bad hands, watermark。设置分辨率SD1.5 系列模型从 512x512 开始测试。采样步数设置 20 左右。点击“执行”或“Queue Prompt”。预期结果是控制台显示进度等待一段时间后Save Image 节点输出一张图片。判断成功的标准图片正常生成没有报错。控制台没有出现 CUDA out of memory。图片内容与提示词基本匹配。如果爆显存降低分辨率、减少批次数、减少采样步数然后再试。6.2 图生图测试图生图需要把输入图片编码到潜空间再交给采样器。操作步骤添加 Load Image 节点选择一张本地图片。把 Load Image 输出连接到 VAE Encode 节点。VAE Encode 的输出连接到 KSampler 的 latent 输入。设置一个适中的 denoise 值。denoise 是重绘强度。从 0.5 开始测试比较稳妥。denoise 越高结果变化越大也越可能破坏原图结构。6.3 局部重绘测试局部重绘是 ComfyUI 里很常用的功能。核心思路是加载图片、给出一张蒙版图蒙版白色区域就是要重绘的部分黑色区域保持原样。操作步骤Load Image 加载原图。Load Mask 加载蒙版图或者使用支持绘制蒙版的节点。把原图和蒙版分别输入到 Set Latent Noise Mask 相关节点。其余流程和图生图类似。判断标准是蒙版外区域基本不变蒙版内区域被重新生成且整体融合度可接受。如果蒙版边缘生硬可以调大羽化或增大重绘区域。6.4 常见失败判断文生图报错时先看控制台输出。如果错误信息里提到某个节点比如 “error report ## error details - node”说明是某个节点执行失败不是整个 ComfyUI 崩了。常见原因包括缺模型、节点参数错误、显存不足、自定义节点版本不兼容。先单独测试这一步逐节点排查。中文提示词不出效果时先检查翻译链路。可以在翻译节点后面加一个“预览文本”节点看翻译出来的英文是什么。如果翻译结果不对改中文描述再试。7. 工作流加载与自定义节点7.1 导入他人工作流ComfyUI 的工作流是一个 JSON 文件。社区分享的工作流有两种常见格式一种是 UI 页面能直接打开的完整格式另一种是 API 格式主要用于脚本调用。导入方式把工作流 JSON 文件拖到 ComfyUI 页面。页面会弹出包含节点和连线的完整工作流。点击“执行”看是否报“模型缺失”或“节点缺失”。导入别人的工作流最常见的失败原因是缺少模型、LoRA、VAE 文件。缺少自定义节点。工作流使用的 ComfyUI 版本比当前版本旧或新。工作流里的模型名称是写死的。如果本地没有对应模型在“加载 Checkpoint”节点里换成自己已有的模型。7.2 安装缺失节点整合包一般会预装一批常用自定义节点但社区工作流经常用到更多节点。安装缺失节点推荐通过 ComfyUI Manager 或整合包自带的管理器进行。管理器里通常能看到已安装节点列表可安装节点搜索节点更新按钮安装完成后需要重启 ComfyUI。不是所有节点都能在重启后立即生效部分节点还需要额外安装系统依赖。这里建议记录自己安装过的节点名称和版本出现问题时方便回溯。8. 接口 API 与批量任务ComfyUI 不只是可视化工具它本身带有 HTTP API。启动服务后可以通过接口提交工作流、查询任务状态、获取生成结果。这意味着可以把 ComfyUI 接入自己的 Python 脚本、自动化工具或者简单 Web 服务。8.1 启动 API 服务默认启动时服务地址就是http://127.0.0.1:8188启动参数可以控制监听地址python main.py --port 8188 --listen 127.0.0.1只监听 127.0.0.1 意味着只有本机能访问适合个人使用。如果需要局域网访问可以监听 0.0.0.0但要注意安全API 没有内置用户认证暴露到公网风险很大。不建议这么做。8.2 提交生成任务的通用模板ComfyUI 的 API 调用需要把工作流导出成 API 格式。UI 格式和 API 格式结构不同直接提交 UI JSON 通常不成功。这里给一个通用逻辑字段名需要按你使用的 ComfyUI 版本实际导出的 API 工作流来调整。先准备 API 格式的工作流文件例如workflow_api.json。Python 调用示例import json import requests import time BASE_URL http://127.0.0.1:8188 def load_api_workflow(path): with open(path, r, encodingutf-8) as f: return json.load(f) def submit_workflow(api_workflow): # 不同版本 ComfyUI 的端点可能不同常见为 /prompt 或 /api/prompt url f{BASE_URL}/prompt resp requests.post(url, json{prompt: api_workflow}, timeout30) resp.raise_for_status() return resp.json().get(prompt_id) def wait_for_completion(prompt_id, interval2, timeout600): start time.time() while time.time() - start timeout: r requests.get(f{BASE_URL}/history/{prompt_id}, timeout10) data r.json() if data.get(prompt_id) and data[prompt_id].get(status, {}).get(completed): return True time.sleep(interval) return False if __name__ __main__: workflow load_api_workflow(workflow_api.json) pid submit_workflow(workflow) print(prompt_id:, pid) ok wait_for_completion(pid) print(completed:, ok)这个脚本的端点、字段名、返回结构在不同 ComfyUI 版本里不完全一样。第一次跑通前建议先用浏览器页面手动执行一次同一个工作流再用脚本调用这样能减少排查范围。8.3 批量任务设计API 方式的批量任务重点不是“同时发起一堆请求”而是“按顺序提交、按状态轮询”。原因是显存有限并行任务多了必然爆显存。批量脚本的基本结构准备配置列表每个配置项包含需要替换的提示词、图片路径、输出名称等。读取一份基础 API 工作流深度拷贝后按配置替换节点参数。逐条提交任务。用 prompt_id 轮询历史状态。任务完成后从保存图片节点写入出来的文件名做后续处理。参考结构import copy import os import json import requests import time BASE_URL http://127.0.0.1:8188 def load_api_workflow(path): with open(path, r, encodingutf-8) as f: return json.load(f) def submit_workflow(workflow): resp requests.post(f{BASE_URL}/prompt, json{prompt: workflow}, timeout30) resp.raise_for_status() return resp.json().get(prompt_id) def wait_for_completion(prompt_id, interval2, timeout600): start time.time() while time.time() - start timeout: r requests.get(f{BASE_URL}/history/{prompt_id}, timeout10) data r.json() if data.get(prompt_id) and data[prompt_id].get(status, {}).get(completed): return True time.sleep(interval) return False def run_batch(base_workflow_path, configs): base_workflow load_api_workflow(base_workflow_path) results [] for idx, cfg in enumerate(configs): wf copy.deepcopy(base_workflow) # 按 cfg 替换节点参数例如把提示词写入指定节点的 inputs.text # 这一步取决于工作流的具体节点 ID 和字段结构 pid submit_workflow(wf) ok wait_for_completion(pid) results.append({index: idx, prompt_id: pid, ok: ok}) return results if __name__ __main__: configs [ {prompt: a red apple on a table, filename: 01.png}, {prompt: a green apple on a table, filename: 02.png}, ] results run_batch(workflow_api.json, configs) print(results)真正使用前必须搞清楚“提示词写在哪个节点 ID 的哪个字段”。不同工作流不同这一步没有统一写法。建议先导出一个最小 API 工作流用脚本单条测试成功后再扩展批量。如果批量任务中途卡住优先检查是否显存不足。是否单个任务超时。是否输出文件名重复导致覆盖。是否网络请求超时。9. 资源占用与性能观察ComfyUI 的资源占用主要看这几个因素模型大小、分辨率、采样步数、批次数、是否启用 ControlNet、是否加载多个 LoRA。显存占用观察方法Windows 任务管理器 - 性能 - GPU查看专用 GPU 内存。命令行nvidia-smi -l 2持续刷新显存占用。Mac 使用活动监视器查看内存压力。一台消费级显卡机器推荐测试顺序是先用 512x512 分辨率、batch 1、steps 20 跑通流程。记录生成一张图的时间和显存占用。逐步提高分辨率、步数、batch 数观察占用变化。如果显存不够降低占用优先尝试分辨率降到 512 以下。batch 保持 1。少选 ControlNet 或其他附加节点。关闭占用显存的其他程序。使用模型低精度加载选项具体以整合包或模型支持情况为准。Mac 平台的 MPS 加速对统一内存的依赖很高。内存小的 Mac 跑大模型同样会吃力建议优先测试小模型和低分辨率。性能观察不只看“能不能跑”还要看“稳不稳定”。批量任务建议固定一张测试图和一组参数跑完一个 batch 再上生产需求。如果跑 3 张就爆显存说明参数需要降级。10. 常见问题与排查方法问题现象可能原因排查方式解决方案双击启动器没反应依赖不完整或路径含中文查看启动器日志、确认路径移动到纯英文路径重新解压页面打不开服务未启动或端口被占用查看控制台日志、检查 8188 端口更换端口重启如--port 8189提示缺少模型文件models 目录下没有对应的 checkpoint检查控制台与节点模型名下载模型到正确目录或在节点内切换已有模型CUDA out of memory显存不足看控制台错误信息降低分辨率、步数、batch关闭多余程序中文提示词效果差模型基于英文训练或翻译链路断开检查翻译后英文文本优化翻译节点或手动输入英文提示词节点执行报错自定义节点缺失、版本不兼容或参数错误看 error report 中的 node 信息安装缺失节点、更新节点、重置节点参数Mac 提示应用来源不明系统安全策略拦截确认文件来源与下载完整性按官方或者整合包说明处理不要绕过系统安全机制批量任务卡住单个任务未完成或脚本轮询逻辑问题查看 history 接口状态增加超时、减少并发、添加失败重试下载模型速度慢网络问题或下载源不稳定检查下载工具状态选择稳定的下载网络环境必要时更换下载源还有一个容易忽略的问题手动安装自定义节点后ComfyUI 版本升级可能把节点兼容性破坏。建议每次升级前导出工作流备份、记录已安装节点列表。遇到问题可以回退到旧版本。11. 最佳实践与使用建议ComfyUI 用顺之后效率提升很明显。但工程化使用不能只靠“点按钮”下面这些经验值得提前建立。第一目录结构保持清晰。推荐把模型、LoRA、输入图片、输出图片、工作流备份分开管理D:\ComfyUI\ ├── ComfyUI\ │ └── models\ │ ├── checkpoints\ │ ├── loras\ │ ├── vae\ │ └── controlnet\ ├── workflows\ ├── inputs\ └── outputs\第二第一次使用先跑小参数测试。不要一上来就跑高分辨率大 batch先确认流程正确、模型正常、节点没缺失。第三工作流要勤保存。调整好一个可用流程后导出 JSON 存到自己的工作流目录。工作流文件名建议包含用途、模型名称、分辨率、日期例如text2img_sd15_512_20250125.json。第四批量任务要带日志和失败重试。脚本调用 API 时每个任务记录 prompt_id、时间、状态。失败任务可以在固定时间后重试但要避免无限重试拖垮服务。第五API 服务不建议暴露到公网。ComfyUI 的 API 没有内置鉴权默认只监听本地地址。需要局域网访问时建议通过有认证的反向代理或防火墙规则控制访问来源。第六模型和素材的合规问题要前置。使用真人照片、版权图片、受保护人脸做输入素材时要确认自己是否有权限。下载的模型和 LoRA 要看许可证是否允许商用不能默认所有模型都可以商业化。第七发布或商用前做效果复核。AI 生成的图片可能存在手指、结构、文字错误生成平台不能替代人工审核。12. 总结与下一步ComfyUI 最值得尝试的地方是把图像生成从“填表出图”变成了“流程搭建”能复用的工作流和可编程的接口让它同时适合个人学习和团队生产。中文整合包解决的是最前面的那一步安装部署、界面汉化、中文提示词让门槛降下来。如果你第一次部署先做三件事跑通文生图、验证中文提示词链路、保存一个最小可用工作流。最容易踩的坑是模型文件缺失和显存不足遇到先看控制台错误信息再逐步降低参数不要一上来就怀疑整合包有问题。跑通基础流程之后可以继续扩展这几个方向接入 ControlNet 做构图控制下载 LoRA 做风格复现用 API 把自己的业务脚本接进来甚至可以把 ComfyUI 作为一个小型内部服务给团队提供稳定的出图能力。建议收藏备用需要动手部署时再对照这篇文章一步步来。