ComfyUI文件结构：专业级模型与节点管理方法

1. 核心概念：ComfyUI 如何使用文件

ComfyUI 是一款基于节点的 Stable Diffusion 工具，它依靠结构清晰的文件系统来加载模型、保存生成结果、运行扩展功能。所有文件都存放在 ComfyUI 主文件夹（下载解压后得到的文件夹）内。

文件系统遵循两条简单规则：

ComfyUI 会自动扫描指定文件夹来识别模型/节点（大部分文件无需手动关联）。
你只需要把文件放到正确的子文件夹里，基础使用无需复杂配置。

2. ComfyUI 完整文件结构（自上而下）

以下是 Windows 标准目录结构（macOS/Linux 基本一致，只是没有 .exe 这类文件）。

ComfyUI/
├── models/                  # 核心：所有 AI 模型（大模型、LoRA、VAE 等）
    ├── checkpoints/
    ├── diffusion_models/
    ├── unet/
    ├── vae/
    ├── loras/
    ├── text_encoders/
    ......
├── custom_nodes/            # 扩展：已安装的自定义节点（额外功能）
├── outputs/                 # 存储：生成的图片、日志、元数据
├── config/                  # 设置：ComfyUI 配置文件
├── main.py                  # 启动脚本（不使用 exe 时运行）
├── ComfyUI.exe              # Windows 一键启动器（整合包版本）
├── requirements.txt         # 依赖列表（手动安装时用）
└── web/                     # 内部：前端界面文件（不懂不要修改）

3. 关键文件夹详细说明

3.1 `models/` —— ComfyUI 的“大脑”

这是最重要的文件夹，存放所有用于图像生成的 AI 模型。 ComfyUI 会自动扫描这里的子文件夹，只要放对位置，模型就会出现在节点菜单里。

千万不要重命名系统自带子文件夹（比如不要把 checkpoints 改成 models），否则 ComfyUI 无法识别。

子文件夹名称	这里放什么	重要说明
`checkpoints/`	Stable Diffusion 大模型（如 `v1-5-pruned-emaonly.safetensors`、`Flux1-dev.safetensors`）	完整模型，自带 CLIP 和 VAE，现在已较少单独使用
`diffusion_models/`	扩散模型（如 `z-image-turbo`）	用于图像生成，不包含 CLIP 或 VAE
`unet/`	UNet 模型	负责图像生成核心计算，部分大模型已自带 UNet
`vae/`	VAE 模型（如 `vae-ft-mse-840000-ema-pruned.safetensors`）	改善色彩与画质，部分模型已自带
`loras/`	LoRA 模型（风格/角色微调，体积小）	轻量级，配合 `Apply LoRA` 节点使用
`embeddings/`	文本反转/嵌入（如 EasyNegative）	用于提示词/负面提示词，现在使用较少
`controlnet/`	ControlNet 模型	控制构图、姿态、边缘、深度等
`upscale_models/`	高清放大模型	无损放大图片，配合放大节点使用

专业小技巧：你可以在这些文件夹里再建子文件夹分类，例如：

models/loras/anime/
models/checkpoints/flux/

ComfyUI 依然能正常识别，方便你管理大量模型。

重要注意：

放在 checkpoints 里的模型，通常自带 UNet + VAE（老模型如 SDXL 尤其如此）。
放在 diffusion_models 里的模型，一般不带 UNet 或 VAE。
把模型拆分成扩散模型、VAE、UNET，是为了获得更好的生成效果。

3.2 `custom_nodes/` —— 扩展 ComfyUI 功能

这个文件夹存放自定义节点，相当于插件，可以给 ComfyUI 增加新功能：新采样器、图片处理器、IP-Adapter、工具联动等。

使用方法：

下载自定义节点（ZIP 或 Git 仓库），解压/复制到 custom_nodes/。
重启 ComfyUI，新节点就会出现在节点菜单里（可用搜索快速找到）。

示例结构：

custom_nodes/
├── ComfyUI-IP-Adapter/      # 图片引导生成
├── ComfyUI-Custom-Samplers/ # 新采样方法
└── ComfyUI-Image-Utils/     # 图片编辑工具（裁剪、缩放等）

重要提醒：

部分节点需要额外依赖，请看节点里的 README.md，用 pip install 安装。
如果节点加载失败，看控制台报错，通常是缺依赖或版本不兼容。

3.3 `outputs/` —— 保存你的作品

这个文件夹保存所有生成的图片及其元数据（提示词、参数、Seed 等），ComfyUI 会自动分类建文件夹。

子文件夹	内容
`outputs/img2img/`	图生图生成的图片
`outputs/txt2img/`	文生图生成的图片
`outputs/extras/`	其他工作流（放大、局部重绘等）
`outputs/logs/`	日志文件（排错非常有用）

核心特点：

文件名带时间戳，不会覆盖旧图。
图片内嵌生成信息，可在 ComfyUI 内或 ExifTool 查看。

3.4 `config/` —— 调整 ComfyUI 设置

存放配置文件，新手一般只需要用到 config.py。

常用修改：

修改默认输出目录：把 output_directory = "outputs" 改成自定义路径。
开启 CUDA 加速：确保 cuda = True（大幅提速）。
调整图片格式、压缩率等。

警告：不懂代码不要乱改其他文件，会直接导致 ComfyUI 无法启动。

3.5 其他不太重要的文件

文件名	作用
`main.py`	Python 主启动文件，用 `python main.py` 启动
`ComfyUI.exe`	Windows 一键启动器
`requirements.txt`	Python 依赖清单，缺失模块时安装

4. 文件管理最佳实践（避坑必备）

按类别分类模型：在 models/ 内建子文件夹，查找更快。
定期清理输出文件夹：outputs/ 会越来越大。
备份自定义节点：重装系统/软件时很有用。
优先用 safetensors 格式：比 ckpt 更安全、加载更快。
不要重命名核心系统文件夹：models、custom_nodes、outputs 不能改名。

5. 文件相关常见问题排查

问题	原因	解决方法
模型在 ComfyUI 里不显示	放错文件夹	放到对应文件夹并重启 ComfyUI
自定义节点加载失败	缺依赖 / 版本不兼容	按 README 安装依赖，更新 ComfyUI
图片不保存	文件夹无写入权限	Windows 以管理员运行，或修改文件夹权限
启动就崩溃	模型损坏 / 显存不足	删除损坏模型，关闭占用显存的软件

ComfyUI Tutorial