ComfyUI安装教程：本地部署步骤详解

想在本地电脑上零门槛部署强大的AI图像生成工具ComfyUI？这篇手把手教程从环境准备、仓库克隆、依赖安装到服务启动和路径优化，全程覆盖Python与Git配置、CUDA兼容性处理、防火墙设置等易错细节，帮你避开90%新手踩坑点，5分钟内即可在浏览器打开专属可视化工作流界面——无论你是AI绘画爱好者还是技术探索者，都能快速拥有完全可控、高效稳定的本地ComfyUI运行环境。

如果您希望在本地计算机上运行ComfyUI，但尚未完成环境初始化与主程序部署，则可能是由于缺少Python运行时、Git工具或未正确执行克隆与依赖安装流程。以下是完成ComfyUI本地部署的完整步骤：

一、准备基础运行环境

ComfyUI依赖Python 3.10–3.12及Git命令行工具，缺失任一组件将导致后续克隆失败或依赖安装中断。系统需预先验证这两个核心组件的可用性与版本兼容性。

1、打开终端（Windows用户使用PowerShell或CMD，macOS/Linux用户使用Terminal）。

2、输入 python --version 检查Python版本，若未安装或版本低于3.10，请前往python.org下载并安装Python 3.11.x（推荐）。

3、输入 git --version 验证Git是否已安装；若提示“command not found”，请访问git-scm.com下载安装最新版Git。

4、确保Python安装时勾选了“Add Python to PATH”选项，否则需手动将Python及Scripts目录加入系统环境变量。

二、克隆ComfyUI主程序仓库

该步骤从官方GitHub仓库获取最新稳定版ComfyUI源码，所有功能模块与默认工作流均由此目录启动。必须在目标安装路径下执行克隆操作，避免路径嵌套错误。

1、在终端中切换至期望安装目录，例如：cd D:\AI\comfyui（Windows）或 cd ~/comfyui（macOS/Linux）。

2、执行克隆命令：git clone https://github.com/comfyanonymous/ComfyUI.git。

3、等待下载完成，确认当前目录下生成 ComfyUI 子文件夹，其内部包含 main.py、requirements.txt 等关键文件。

三、安装Python依赖包

ComfyUI运行依赖约30+个第三方库（如torch、numpy、Pillow），需通过pip批量安装。使用--ignore-installed参数可规避已有系统级包冲突，保障环境纯净性。

1、进入ComfyUI根目录：cd ComfyUI。

2、执行依赖安装命令：pip install -r requirements.txt --ignore-installed。

3、若出现CUDA相关报错（如torch版本不匹配），请先卸载现有torch：pip uninstall torch torchvision torchaudio，再根据显卡型号安装对应CUDA版本的torch（参考pytorch.org）。

四、启动ComfyUI服务

启动过程将初始化Web服务器、加载默认节点库，并绑定本地监听地址。默认端口为8188，支持局域网内其他设备通过IP访问（需开启防火墙放行）。

1、确保仍在ComfyUI根目录，执行启动命令：python main.py --listen。

2、终端输出日志中出现 Starting server 及 To see the GUI go to: http://0.0.0.0:8188 表示服务已就绪。

3、在浏览器中访问 http://127.0.0.1:8188，加载成功即显示ComfyUI工作流编辑界面。

五、配置存储路径与模型目录

默认情况下，模型文件（Checkpoint）、插件（Custom Nodes）及输出图片均存于ComfyUI根目录下，易造成空间占用混乱。建议显式指定独立路径，提升可维护性与跨设备迁移能力。

1、在ComfyUI根目录新建文件夹：models（用于存放所有模型）、custom_nodes（用于插件）、output（用于生成结果）。

2、编辑 ComfyUI/startup_script.py（若不存在则新建），添加以下两行：

import os

os.environ['COMFYUI_MODEL_PATH'] = 'D:/AI/comfyui/models'（路径按实际修改）

3、重启ComfyUI服务，新路径将在日志中以 Model path set to... 提示确认生效。

今天关于《ComfyUI安装教程：本地部署步骤详解》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！