本机实测
ComfyUI-GGUF 节点怎么安装？Unet Loader (GGUF) 找不到怎么办
ComfyUI-GGUF 安装踩坑：Manager 装完找不到 Unet Loader？GGUF 不是 checkpoint，要重启。
先说结论
FLUX 的 GGUF 量化模型（比如 flux1-dev-Q6_K.gguf）不能用 ComfyUI 自带的 Load Checkpoint 或普通 UNET Loader 加载。必须安装 ComfyUI-GGUF 这个自定义节点，然后用它提供的 Unet Loader (GGUF) 节点来加载。
如果你在 ComfyUI 的节点菜单里搜不到 Unet Loader (GGUF)，这篇文章就是我踩过的坑和排查记录。
以下内容基于 RTX 4060 Laptop 8GB + ComfyUI 0.24.0 + ComfyUI-Manager。其他版本操作类似，但界面细节可能不同。
为什么会找不到 Unet Loader (GGUF)
原因通常就几个：
- 根本没装 ComfyUI-GGUF — ComfyUI 原版不带这个节点，需要手动安装
- 装了但没重启 ComfyUI — 自定义节点安装后不会自动生效
- 通过 Manager 装了但失败 — 网络问题或依赖冲突导致安装不完整
- 模型文件放错目录 — 节点能加载但选不到模型文件，容易误以为是节点没装好
下面按顺序解决。
通过 ComfyUI-Manager 安装
最省事的安装方式是走 ComfyUI-Manager。前提是你已经有 Manager——如果你的 ComfyUI 右侧没有 Manager 面板，需要先安装 Manager，这个不在本文范围内。
安装步骤：
- 打开 ComfyUI，右侧找到 ComfyUI-Manager 面板
- 点击 Install Custom Nodes
- 在弹出的搜索框里输入 ComfyUI-GGUF
- 找到 ComfyUI-GGUF（作者一般是 city96 或类似），点 Install
- 等待安装完成，终端会显示下载和安装进度
- 安装完成后，关闭 ComfyUI 并重新启动
我在安装时遇到过 ComfyUI-Manager 联网超时（raw.githubusercontent.com 连接失败）。这个不是 GGUF 节点本身的问题，是 Manager 获取节点列表的网络问题。如果遇到，换个时间段重试，或者用科学上网。
安装后为什么要重启
ComfyUI 在启动时扫描 custom_nodes 目录下的所有节点并注册。你通过 Manager 安装的节点，文件已经下载到了 ComfyUI/custom_nodes/ 里，但正在运行的 ComfyUI 进程不会自动识别新增的节点。
必须完全关闭 ComfyUI 再重新启动。只是刷新浏览器页面没用。
模型文件应该放在哪里
节点装好之后，它需要找到对应的 .gguf 模型文件。以下是各文件的标准放置路径：
| 文件 | 路径 | 用途 |
|---|---|---|
| flux1-dev-Q6_K.gguf | ComfyUI/models/unet/ | UNet 扩散模型 |
| t5xxl_fp8_e4m3fn_scaled.safetensors | ComfyUI/models/text_encoders/ | T5 FP8 文本编码器 |
| clip_l.safetensors | ComfyUI/models/text_encoders/ | CLIP-L 文本编码器 |
| ae.safetensors | ComfyUI/models/vae/ | VAE 编解码器 |
注意：
- GGUF 文件放在 models/unet/，不是 models/checkpoints/
- T5 和 CLIP 放在 models/text_encoders/，不是 models/clip/
- VAE 放 models/vae/，这个和别的模型一样
放错目录的话，节点能正常显示，但在下拉菜单里选不到对应文件。不要因为选不到文件就以为是节点没装好。
正确节点应该叫什么
正确节点名称是 Unet Loader (GGUF)，节点左上角会显示 GGUF 标记，下拉框里能选到 flux1-dev-Q6_K.gguf。
安装成功后，在 ComfyUI 里右键 -> Add Node，搜索 GGUF，应该能看到以下节点：
- Unet Loader (GGUF) — 这是加载 FLUX GGUF 模型的关键节点
- 可能还有其他 GGUF 相关节点，如 CLIP Loader (GGUF) 等
如果你看到的是 Load Checkpoint、UNET Loader（不带 GGUF 字样）、Load Diffusion Model，这些都不是正确的节点。不要用它们去加载 .gguf 文件——会报错或加载失败。
如果节点还是找不到，按顺序检查
1. 确认 custom_nodes 目录里有 ComfyUI-GGUF
打开文件管理器，进入 ComfyUI 安装目录下的 custom_nodes/。看看有没有一个叫 ComfyUI-GGUF（或类似名称）的文件夹。里面有 .py 文件（如 nodes.py）就说明文件已下载。
如果文件夹不存在，说明 Manager 安装没成功。重试安装，或者手动 git clone。
2. 确认完全重启了 ComfyUI
不是关闭浏览器标签页，是关掉运行 ComfyUI 的那个命令行窗口（通常是黑色的 Python 终端）。关掉后再重新运行 run_nvidia_gpu.bat 或你的启动脚本。
3. 看终端有没有报错
启动 ComfyUI 时，终端会输出加载 custom_nodes 的日志。搜一下有没有 ComfyUI-GGUF 相关的错误信息。常见的有：
- ModuleNotFoundError: No module named ‘xxx’ — 依赖没装全
- ImportError — Python 版本不兼容或文件损坏
如果有这类报错，把错误信息截图或复制下来对照排查。本文不展开每种报错的解法，但大多数情况下重新安装能解决。
4. 尝试手动 git clone
如果 Manager 反复安装失败，可以手动安装：
- 关闭 ComfyUI
- 打开命令行，进入 ComfyUI/custom_nodes/
- 运行：git clone https://github.com/city96/ComfyUI-GGUF
- 进入 ComfyUI-GGUF 目录，运行：pip install -r requirements.txt（如果有）
- 重启 ComfyUI
上面这个 git 地址是社区常用地址，我没在其他源上测试过，不能确定是否还有其他 fork 版本。如果 clone 失败，去 GitHub 上搜 ComfyUI-GGUF，找当前最新的仓库地址。
常见错误
用 Load Checkpoint 加载 .gguf 文件
现象：点击 Queue Prompt 后，终端报错或直接没反应。 原因：.gguf 不是标准 checkpoint 格式，ComfyUI 自带的 Load Checkpoint 无法识别。 正确做法：用 Unet Loader (GGUF)。
只装了节点没放模型
现象：节点能看到，但 unet_name 的下拉菜单是空的。 原因：flux1-dev-Q6_K.gguf 没放在 models/unet/ 里。 正确做法：下载模型文件并放到正确目录，然后点节点上的 Refresh 或重启 ComfyUI。
模型放对了目录但选不到
现象：文件确实在 models/unet/ 里，但下拉菜单里没有。 原因：节点不会实时扫描文件系统。加载过一次后，可能需要手动触发刷新。 正确做法：节点上通常有一个 Refresh 按钮，点一下。或者在 ComfyUI 启动时它会扫描。还不行就重启。
把 T5 放到了 models/clip/
现象：DualCLIPLoader 的 clip_name2 下拉菜单里找不到 t5xxl_fp8 文件。 原因：T5 不是 CLIP 模型，应该放在 models/text_encoders/。 正确做法：移动文件到 models/text_encoders/，重启 ComfyUI。
常见问题 FAQ
为什么我没有 Unet Loader (GGUF)？
因为你还没安装 ComfyUI-GGUF 自定义节点。ComfyUI 原版不带这个节点。通过 ComfyUI-Manager 的 Install Custom Nodes 安装后重启即可。
GGUF 能不能用 Load Checkpoint 加载？
不能。格式不兼容。必须用 Unet Loader (GGUF)。
安装 ComfyUI-GGUF 后为什么还看不到节点？
先确认是否完成了整个 ComfyUI 进程的重启。只刷新浏览器不会重新加载后端自定义节点；如果重启后仍然没有，再检查终端里的依赖或导入报错。
模型文件放错目录会怎样？
节点能正常加载，但下拉菜单里选不到你的模型文件。这不是节点的问题，是路径不对。
8GB 显卡为什么要用 GGUF？
原版 FLUX FP16 UNet 超过 11GB，8GB 显存直接加载不了。GGUF 是量化格式，Q6_K 级别的 UNet 文件更小、显存占用更低，让 8GB 显卡也能加载 FLUX 模型。原理不在这里展开，简单理解就是“压缩了但还能用”。
Manager 安装失败怎么办？
试着手动 git clone 到 custom_nodes/ 目录。地址见上文“手动 git clone”部分。如果手动安装也不行，检查 Python、pip、git 是否正常。
核对来源
- ComfyUI-GGUF 项目 README：安装命令、
Unet Loader (GGUF)节点和models/unet路径以项目当前说明为准。 - ComfyUI 官方模型说明：模型目录、刷新和重启规则可能随 Desktop、Portable 或手动安装方式不同。
本文截图对应本站测试时的版本。如果节点名称与当前 README 不一致，应优先采用项目维护者的最新说明。