LogoWonderful Launcher
  • 首页
  • 定价
  • 文档
  • 下载
ComfyUI 模型文件夹中 Safetensors 文件应放在哪里ComfyUI「工作流草稿保存失败」修复指南ComfyUI 缺失节点:修复红色工作流节点和节点包如何修复 ComfyUI 找不到模型文件的问题ComfyUI 模型路径未检测到:修复 extra_model_paths.yaml
模型与工作流

ComfyUI 模型文件夹中 Safetensors 文件应放在哪里

VerifiedLow riskTested on Windows 10, Windows 11 | launcher managed | Python 3.11+ | CUDA 12.x | Torch 2.x | ComfyUI portable and managed installLast verified 2026-05-19Estimated time 3-10 minutes

找到 safetensors 文件在 ComfyUI 模型文件夹中的正确位置:checkpoints、LoRA、VAE、ControlNet、Flux 扩散模型、文本编码器和放大模型。

如果你搜索的是 safetensors 文件在 comfyui 中放哪里、comfyui safetensors 文件夹 或 checkpoint 模型 safetensors 放哪里,简短的答案是:将文件放在 ComfyUI/models/ 目录下,但要根据模型类型选择子文件夹,而不是根据 .safetensors 扩展名来判断。

先使用下面的文件夹对照表。Checkpoint .safetensors 文件放在 models/checkpoints/,LoRA 文件放在 models/loras/,VAE 文件放在 models/vae/,Flux 扩散模型通常放在 models/diffusion_models/,文本编码器通常放在 models/text_encoders/ 或 models/clip/。

快速答案

models/checkpoints/ 只用于存放完整的 checkpoint 文件。大多数放错文件夹的问题,是因为 LoRA、VAE、Flux 扩散模型、文本编码器或放大模型文件也以 .safetensors 结尾,但它们应该放在不同的文件夹中。

大多数 .safetensors 文件应放在以下路径下:

ComfyUI/models/

如果文件放在错误的文件夹中,ComfyUI 可能正常启动,但模型下拉列表将为空,或者工作流验证将失败。

缺失模型通常发生在导入工作流或修复缺失节点之后。如果你刚刚修复了缺失节点,现在发现模型下拉列表为空,那么你很可能已经从插件问题转变为了模型放置问题。

快速文件夹对照表

模型类型放置位置常用加载器
CheckpointComfyUI/models/checkpoints/Load Checkpoint
LoRAComfyUI/models/loras/Load LoRA
VAEComfyUI/models/vae/Load VAE
ControlNetComfyUI/models/controlnet/Load ControlNet Model
Embedding / Textual InversionComfyUI/models/embeddings/在提示词文本中使用
CLIP / 文本编码器ComfyUI/models/text_encoders/ 或 models/clip/CLIP 加载器节点
Flux 扩散模型 / UNetComfyUI/models/diffusion_models/ 或 models/unet/UNet / 扩散模型加载器
放大模型ComfyUI/models/upscale_models/Upscale Model Loader

移动文件后,请重启 ComfyUI 或从相关下拉列表刷新模型列表。

如果只记住一条规则,请记住这条:.safetensors 扩展名本身无法告诉你正确的文件夹。checkpoint、LoRA、VAE、ControlNet、Flux 扩散模型 和 文本编码器 都可以使用 .safetensors 格式,但它们属于不同的位置。

测试环境

  • 操作系统: Windows 10 / 11
  • 启动器: Wonderful Launcher v1.x
  • ComfyUI: 便携版 / 托管安装
  • Python: 3.11+
  • CUDA / Torch: CUDA 12.x / Torch 2.x
  • 最后测试时间: 2026-05-19

如果你下载了模型但找不到其位置

如果你搜索的是 ComfyUI 下载的模型保存在哪里、ComfyUI models/checkpoints 文件夹在哪里 或 ComfyUI 模型文件放在哪个文件夹,请从当前正在运行的 ComfyUI 文件夹开始查找:

ComfyUI/models/

手动下载的文件不会全部落入同一个通用文件夹。通过浏览器下载的文件通常会停留在浏览器的下载文件夹中,直到你手动移动它。启动器、工作流助手或自定义节点可能会将文件放在活动 ComfyUI 的 models/ 文件夹、Hugging Face 缓存或节点专属文件夹中。如果文件未显示在 ComfyUI 的下拉列表中,请先确认你编辑的是启动服务器的同一个 ComfyUI 安装。

当文件名包含量化标签(如 q8、fp8、fp16 或 gguf)时,不要假设它属于 models/checkpoints/。这些标签描述的是精度或格式,而不是 ComfyUI 加载器类型。应先查看工作流节点名称:checkpoint 文件放到 checkpoints,文本编码器放到 text_encoders 或 clip,VAE 文件放到 vae,扩散模型或 GGUF 模型文件通常放到 diffusion_models 或旧版 unet 路径。

如果你已经下载了模型文件

如果你的磁盘上已经有 .safetensors 文件,但不确定它应该放在哪里,当该模型与某个工作流绑定时,Wonderful Launcher 可以提供帮助。在工作流检测到缺失模型后,你可以将本地模型文件拖入缺失模型面板;应用会在导入前预览活动 ComfyUI models/ 文件夹下匹配的目标路径。

手动放置时,请以上方的表格作为参考依据。当你想避免编辑错误的 ComfyUI 安装、混淆模型类型或猜测工作流期望本地模型文件的位置时,请使用启动器。如果你需要拖放模型导入功能,请从 下载 Wonderful Launcher 开始。

如果你修复了缺失节点但模型仍然缺失

缺失节点和缺失模型文件是两个独立的修复阶段。

如果工作流首先显示红色节点,请先修复缺失的自定义节点或插件导入错误。待这些节点注册完成后,工作流可能仍会要求提供模型文件,例如 checkpoint、LoRA、CLIP 视觉模型、文本编码器、ControlNet 模型或 VAE 文件。

这并不意味着节点修复失败,而是说明工作流现在能够运行到足够深的程度,从而暴露出下一个缺失的资源。

发生的变化含义下一步参考页面
红色节点消失,但模型下拉列表为空节点存在,但模型文件缺失或放错文件夹使用本文件夹对照表
错误提示 checkpoint、LoRA、VAE 或文本编码器这是模型放置 / 下载问题将文件类型与 models/ 对应
错误提示自定义节点类仍然是节点 / 插件问题工作流缺失节点
错误提示 Python 包这是包 / 导入问题No module named 错误

常见文件示例

文件或命名模式通常放置位置原因
sd_xl_base_1.0.safetensors、realvisxl.safetensorsmodels/checkpoints/由 Load Checkpoint 加载的完整 checkpoint
Flux 工作流中的 ae.safetensorsmodels/vae/Flux 自动编码器 / VAE 组件
clip_l.safetensorsmodels/clip/ 或 models/text_encoders/CLIP / 文本编码器组件,不是 checkpoint
t5xxl_fp16.safetensors、t5xxl_fp8*.safetensorsmodels/text_encoders/Flux 风格工作流使用的 T5 文本编码器
umt5_xxl_fp8_e4m3fn_scaled.safetensorsmodels/text_encoders/新版 Flux 风格工作流使用的文本编码器
gemma_3_12b_it_fp4_mixed.safetensorsmodels/text_encoders/用于 LTX-2.3 视频生成的 Gemma 3 文本 / LLM 编码器
qwen_*.safetensors 文本编码器文件models/text_encoders/文本编码器,不是 checkpoint
Q8 / FP8 Flux 扩散文件models/diffusion_models/ 或 models/unet/量化扩散模型,通常由扩散模型 / UNet 加载器加载
4x_*.safetensors 或 ESRGAN 风格放大模型models/upscale_models/由 Upscale Model Loader 使用
Flux GGUF 或独立扩散模型文件models/diffusion_models/通过扩散模型、UNet 或 GGUF 加载器加载

当文件名包含 Flux 或 Qwen 等模型系列名称时,不要假设它属于 models/checkpoints/。请先检查工作流中的加载器节点。

快速诊断

你看到的情况通常含义首先检查
模型文件从未出现在下拉列表中文件夹错误将文件类型与上方表格匹配
Flux 或 UNet 文件在 Load Checkpoint 中缺失加载器错误且文件夹错误将其移至 diffusion_models 并使用扩散模型加载器
LoRA 文件不在 checkpoint 列表中它不是 checkpoint将其放入 models/loras 并使用 Load LoRA
文本编码器文件未被检测到CLIP / 文本编码器位置错误检查 models/text_encoders 或 models/clip
文件在正确文件夹中但仍然缺失ComfyUI 安装路径错误或文件列表过时重启 ComfyUI 并确认你编辑的是正在运行的那个安装

工作流导入检查清单

当共享工作流报告模型缺失时,请按以下顺序检查:

  1. 先确认红色 / 缺失节点已修复。
  2. 阅读加载器节点名称:checkpoint、LoRA、VAE、CLIP、ControlNet、扩散模型、GGUF 或放大模型。
  3. 将文件放入该加载器对应的文件夹,而不是仅凭文件扩展名推断的文件夹。
  4. 确认你将文件移入的是当前正在运行的 ComfyUI 安装。
  5. 在判断文件仍然缺失之前,先重启 ComfyUI 或刷新模型列表。

如果下一个错误从"模型缺失"变为 Python 导入或插件错误,请切换到 No module named 错误 或 插件导入失败。不要继续为包导入问题移动模型文件。

扩展名不等于模型类型

这是大多数"safetensors 放哪里"困惑的根源。

以下这些文件都可以以 .safetensors 结尾,但它们不属于同一个文件夹:

  • 完整的 checkpoint
  • LoRA
  • VAE
  • ControlNet 模型
  • Flux 扩散模型
  • 文本编码器

如果你只按文件扩展名排序,最终一定会将正确的文件放入错误的文件夹。

Checkpoints

将标准 Stable Diffusion 或 SDXL checkpoint 文件放在这里:

ComfyUI/models/checkpoints/

示例:

realvisxl.safetensors
dreamshaper.safetensors
sd_xl_base_1.0.safetensors

使用 Load Checkpoint 节点。如果 ckpt_name 显示模型不在列表中,请确认文件在 models/checkpoints/ 中,而不是在 models/loras/ 或 models/diffusion_models/ 中。

LoRA 文件

将 LoRA 文件放在这里:

ComfyUI/models/loras/

使用 Load LoRA 节点。LoRA 不是完整的 checkpoint,它需要一个兼容的基础模型。

如果 LoRA 是针对 SD 1.5 训练的,请与 SD 1.5 checkpoint 一起使用。如果是针对 SDXL 训练的,请与 SDXL checkpoint 一起使用。

VAE 文件

将 VAE 文件放在这里:

ComfyUI/models/vae/

使用 Load VAE 或工作流中的 VAE 插槽。VAE 错误会导致颜色、解码或模型不匹配问题。

ControlNet 文件

将 ControlNet 文件放在这里:

ComfyUI/models/controlnet/

ControlNet 文件必须与模型系列匹配。SD 1.5 的 ControlNet 模型与 SDXL 的 ControlNet 模型不可互换。

Flux、UNet 和扩散模型

许多较新的工作流,包括 Flux 风格的工作流,不使用旧版 SD 1.5 模式中的单一 checkpoint 文件。

对于独立的扩散模型文件,请使用:

ComfyUI/models/diffusion_models/

部分旧版工作流或自定义节点可能仍引用:

ComfyUI/models/unet/

ComfyUI 会将旧版 unet 路径映射到 diffusion_models,因此两种模式都可能出现在教程和自定义节点中。

如果你的文件是 Flux 风格的模型,而你一直在检查 Load Checkpoint,看起来模型消失了。实际上,你通常是在为该文件类型检查错误的加载器。

GGUF 模型

GGUF 文件通常是用于低显存工作流的量化模型文件。使用 ComfyUI-GGUF 时,Flux GGUF 扩散模型通常放在:

ComfyUI/models/diffusion_models/

许多 ComfyUI-GGUF 示例也使用向后兼容的文件夹:

ComfyUI/models/unet/

然后使用 Unet Loader (GGUF) 或工作流所需的 GGUF 加载器。GGUF 扩散模型不是普通的 checkpoint。

如果你搜索的是 comfyui unet loader gguf 或 comfyui gguf loader,请同时检查模型文件夹以及 ComfyUI-GGUF 自定义节点是否已安装。完整的加载器设置请参阅 ComfyUI GGUF。

文本编码器和 CLIP

将文本编码器文件放在:

ComfyUI/models/text_encoders/

部分工作流和旧版教程使用:

ComfyUI/models/clip/

ComfyUI 在当前文件夹路径配置中同时支持这两个文本编码器位置。

为什么下拉列表仍然为空

如果文件在正确的文件夹中但仍未显示:

  1. 检查扩展名。.safetensors 是受支持的格式,但部分下载的文件可能不受支持。
  2. 刷新下拉列表或重启 ComfyUI。
  3. 确保文件不在 zip 压缩包或浏览器下载临时文件中。
  4. 确认你编辑的 ComfyUI 文件夹与正在运行的是同一个。
  5. 如果模型位于 ComfyUI 文件夹之外,请检查 extra_model_paths.yaml。
  6. 如果 ComfyUI 在启动时崩溃,或后端日志在加载模型时显示环境错误,请参阅 ComfyUI Torch Not Compiled With CUDA Enabled 故障排除指南。

避免的常见错误

请避免以下常见错误:

  • 将所有 .safetensors 文件都放入 models/checkpoints
  • 使用 Load Checkpoint 加载 Flux 扩散模型
  • 将 LoRA 文件与完整 checkpoint 放在一起
  • 编辑一个 ComfyUI 安装,却启动的是另一个
  • 移动大量模型后认为刷新浏览器就足够了

便携版安装示例

对于便携版安装:

ComfyUI_windows_portable/
  ComfyUI/
    models/
      checkpoints/
      loras/
      vae/
      controlnet/
      diffusion_models/

如果你的启动 .bat 文件启动的是不同的 ComfyUI 文件夹,模型将不会显示。请始终验证运行中的终端或启动器设置中显示的文件夹。

Wonderful Launcher 如何提供帮助

当模型放置问题与环境问题混合时,Wonderful Launcher 非常有用:

  • 在重建 ComfyUI 之前保留模型文件夹
  • 将稳定版和实验性模型库分开存放
  • 在修复缺失自定义节点时避免丢失工作流
  • 在模型下拉列表或工作流验证失败时收集日志

如果模型文件正确,但工作流使用了缺失的自定义节点,请从 安装自定义节点 开始。

如果将模型放到正确位置后工作流仍然无法打开,请在更改更多文件之前保存工作流 JSON。请参阅 如何在 ComfyUI 中保存工作流。

常见问题

ComfyUI 中的 .safetensors 文件放在哪里?

它们通常放在 ComfyUI/models/ 的某个子目录下,但具体文件夹取决于该文件是 checkpoint、LoRA、VAE、ControlNet 模型、Flux 扩散模型还是文本编码器。

可以把所有 .safetensors 文件都放在 models/checkpoints 中吗?

不可以。这是最常见的错误。许多 .safetensors 文件根本就不是 checkpoint。

Flux .safetensors 模型在 ComfyUI 中放在哪里?

通常放在 ComfyUI/models/diffusion_models/ 或旧版 models/unet/ 路径下,然后使用相应的扩散模型或 UNet 加载器加载。

Q8 或 FP8 ComfyUI 模型放在哪里?

Q8、FP8 和 FP16 描述的是量化或精度,本身并不决定文件夹。如果文件是 Flux 扩散模型或 GGUF 风格的模型,请检查 models/diffusion_models/ 或 models/unet/。如果是 clip_l、t5xxl、Qwen 或其他文本编码器,请使用 models/text_encoders/ 或 models/clip/。

ComfyUI 下载的模型保存在哪里?

ComfyUI 模型文件应位于活动安装的 ComfyUI/models/ 目录树下,但手动通过浏览器下载的文件通常会留在 ComfyUI 之外,直到你手动移动它们。如果是工作流助手或自定义节点下载的文件,在盲目移动文件之前,还应检查该节点的 README 和缓存行为。

为什么我的 .safetensors 文件没有显示出来?

通常是因为它在错误的文件夹中、你查看的是错误的加载器,或者你编辑的 ComfyUI 安装与当前正在运行的不是同一个。

如何在 ComfyUI 中安装 .safetensors 模型?

没有安装器——安装 safetensors 模型就是把文件移动到对应的 ComfyUI/models/ 子文件夹(checkpoints、loras、vae、controlnet、diffusion_models、text_encoders 或 upscale_models),然后重启 ComfyUI 或刷新下拉列表。决定文件夹的是加载器节点,而不是文件名。

如何在 ComfyUI 中打开或使用 .safetensors 文件?

不需要直接打开文件。在工作流中添加加载器节点(Load Checkpoint、Load LoRA、Load VAE、Load ControlNet Model、UNet/扩散模型加载器或 Upscale Model Loader),然后从下拉列表中选择文件。如果文件没有出现,说明放错了文件夹或 ComfyUI 尚未刷新模型列表。

ComfyUI 中的 safetensors 文件夹在哪里?

没有单一的 "safetensors 文件夹"——位置是 ComfyUI/models/,具体子文件夹取决于模型类型:checkpoints/、loras/、vae/、controlnet/、diffusion_models/、text_encoders/、embeddings/ 或 upscale_models/。Windows 便携版的路径是 ComfyUI_windows_portable\ComfyUI\models\。

相关指南

  • 下载模型
  • ComfyUI GGUF
  • ComfyUI GGUF 和模型加载基础
  • 安装自定义节点
  • ComfyUI 常见问题
  • ComfyUI Torch Not Compiled With CUDA Enabled 修复
  • ComfyUI Triton 在 Windows 上缺失或不可用

参考来源

  • ComfyUI 官方模型故障排除
  • ComfyUI 官方模型概念
  • ComfyUI 文件夹路径源码
相关指南:Download and place ComfyUI modelsLoad GGUF models in ComfyUISave workflows before moving files

先按上面的步驟定位根因。还卡住时,可以下载 Wonderful Launcher 检查目前机器;启动器原生修复、任务日誌和執行階段检查会集中在一起。credits 只用於图片生成和按量工具。

下载 Wonderful Launcher查看 credits 方案

这篇文件解決了你的問题嗎?

你的回饋会帮助我们優先補強真實 ComfyUI 排障文件。

如何修复 ComfyUI 自定义节点 requirements.txt 未安装的问题

修复因 requirements.txt 依赖项未安装到正确 Python 环境而导致加载失败的 ComfyUI 自定义节点。

ComfyUI「工作流草稿保存失败」修复指南

修复 ComfyUI「Failed to Save Workflow Draft」错误:先导出工作流 JSON,再排查重连问题、浏览器存储、localhost 及 PNG 元数据。

目录

快速文件夹对照表
如果你下载了模型但找不到其位置
如果你已经下载了模型文件
如果你修复了缺失节点但模型仍然缺失
常见文件示例
快速诊断
工作流导入检查清单
扩展名不等于模型类型
Checkpoints
LoRA 文件
VAE 文件
ControlNet 文件
Flux、UNet 和扩散模型
GGUF 模型
文本编码器和 CLIP
为什么下拉列表仍然为空
避免的常见错误
便携版安装示例
Wonderful Launcher 如何提供帮助
常见问题
ComfyUI 中的 .safetensors 文件放在哪里?
可以把所有 .safetensors 文件都放在 models/checkpoints 中吗?
Flux .safetensors 模型在 ComfyUI 中放在哪里?
Q8 或 FP8 ComfyUI 模型放在哪里?
ComfyUI 下载的模型保存在哪里?
为什么我的 .safetensors 文件没有显示出来?
如何在 ComfyUI 中安装 .safetensors 模型?
如何在 ComfyUI 中打开或使用 .safetensors 文件?
ComfyUI 中的 safetensors 文件夹在哪里?
相关指南
参考来源