GGUF 量化模型加载失败：节点缺失、放错目录、与 fp8 混用

When loading the graph, the following node types were not found: UnetLoaderGGUF
ERROR: Could not detect model type of: <path>
Mixing scaled FP8 with GGUF is not supported! Use regular CLIP loader or switch model(s)

现象与触发场景

常见触发场景：

• 没装 ComfyUI-GGUF 自定义节点包，或装了但 gguf 依赖版本太低
• 把 .gguf 文件放进 models/checkpoints 用普通 Load Checkpoint 加载
• comfyui 的 models/unet 下建了子目录，节点读不到子目录里的文件
• 同一工作流里一边用 GGUF 的 CLIP 加载器，一边用 fp8_scaled 的扩散模型

根因

• GGUF 扩散模型支持不是 ComfyUI 核心功能：官方 requirements.txt 里并没有 gguf 这个包，必须装 ComfyUI-GGUF 自定义节点包（依赖 gguf>=0.13.0）。没装就会在打开工作流时报节点类型缺失。
• GGUF 文件要用专用加载器（UnetLoaderGGUF / UnetLoaderGGUFAdvanced，文本编码器用 CLIPLoaderGGUF / DualCLIPLoaderGGUF 等），并且要放在该包约定的模型目录（models/unet，新版本对应 models/diffusion_models）。放错目录或给错加载器，会报 Could not detect model type of。
• 自定义节点包安装时，pip install 的 Python 可能不是 ComfyUI 自己用的那个解释器，于是「明明装了」却依然缺节点。
• GGUF 与 scaled fp8 是两套不同的量化执行路径，混用会被节点直接拒绝。

解决步骤

已按「最可能有效」排序。请从上往下做，每做完一步用「验证」确认，不要一次改五处。

1. 第一步：装好 ComfyUI-GGUF 并确认依赖装在 ComfyUI 的 Python 里
   通过 ComfyUI Manager 安装 city96/ComfyUI-GGUF，或手动克隆到 custom_nodes 后用 ComfyUI 自己的 Python 执行 pip install -r requirements.txt（便携版用 embedded python，别用系统 python）。装完重启，日志里应看到该包节点注册成功。
   cd ComfyUI/custom_nodes && git clone https://github.com/city96/ComfyUI-GGUF
   python_embeded\python.exe -m pip install -r ComfyUI\custom_nodes\ComfyUI-GGUF\requirements.txt
2. 第二步：把 .gguf 放进正确目录并用专用节点加载
   扩散模型 GGUF 放 models/unet（旧名）或 models/diffusion_models（新名），用 UnetLoaderGGUF 加载；文本编码器 GGUF 用 CLIPLoaderGGUF / DualCLIPLoaderGGUF / TripleCLIPLoaderGGUF / QuadrupleCLIPLoaderGGUF 加载。注意该节点包对 models/unet 下的子目录支持有限，文件尽量直接放在该目录根下，避免多层子目录导致扫描不到。不要用 Load Checkpoint 加载 .gguf。
   ComfyUI/models/unet/
   ComfyUI/models/diffusion_models/
3. 第三步：整条链路统一格式，不要 GGUF 与 scaled fp8 混用
   若扩散模型是 GGUF，文本编码器也用对应的 GGUF 版本（GGUF 的 CLIP 加载器），不要一边 GGUF 一边 scaled fp8，否则会直接报 Mixing scaled FP8 with GGUF is not supported。如果坚持用 scaled fp8 扩散模型，就把文本编码器换成普通 safetensors 版并用常规 CLIPLoader。
4. 第四步：确认 GGUF 文件本身可用
   如果报 Could not detect model type of 或 ERROR UNSUPPORTED UNET，先量文件大小确认没被截断；再核对文件是否是该节点包支持的模型系列（新发布的模型可能尚未支持）。量化工具链层面的 GGML_ASSERT 报错（如 llama.cpp 量化步骤失败）属于生成 GGUF 时的错误，建议换用其它已发布的量化文件或换量化精度重做。
   Get-Item .\models\unet\model-Q4_K_M.gguf | Select-Object Length

验证是否修好

补充说明

GGUF 扩散模型不是 ComfyUI 核心支持（官方 requirements.txt 中不含 gguf 包），因此「节点类型缺失」是这类问题最常见的第一表现。

来源

1. [106] （社区）　ComfyUI Quant Load Errors: GGUF, fp8, NVFP4, INT8　https://localaimaster.com/blog/comfyui-quantization-format-errors
2. [107] （节点仓库 issue）　Unable to load UnetLoaderGGUF · Issue #117 · city96/ComfyUI-GGUF　https://github.com/city96/ComfyUI-GGUF/issues/117
3. [108] （节点仓库 issue）　Subdirectories inside \models\unet, are not read · Issue #130 · city96　https://github.com/city96/ComfyUI-GGUF/issues/130
4. [109] （节点仓库 issue）　ComfyUI-GGUF/tools/llama.cpp/ggml/src/ggml.c:22112: GGML_ASSERT(info->　https://github.com/city96/ComfyUI-GGUF/issues/345

本条报错提到的目录

本条报错的原文或解决步骤里出现了下面这些 models/ 子目录。 权重库里放在这些目录下的文件已按目录列好，可对照确认自己缺的是哪几个。

本条报错提到的节点仓库

下面这些节点仓库的名字出现在本条报错的正文里。这里只说「名字出现过」，没有断定问题就是它引起的； 点进去可以看这个包的用途、适配模型与下载量。

这条报错要用到的东西

按本条报错所属的类别（模型与权重文件加载）列出站内相关的下载包与板块入口。 它们不是「必须下载才能修好」，而是这一类问题里最常要动到的东西；具体怎么做，以上面的解决步骤为准。

同一类别的其他条目

返回报错库