ComfyUI 模型文件夹中 Safetensors 文件应放在哪里
找到 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 可能正常启动,但模型下拉列表将为空,或者工作流验证将失败。
缺失模型通常发生在导入工作流或修复缺失节点之后。如果你刚刚修复了缺失节点,现在发现模型下拉列表为空,那么你很可能已经从插件问题转变为了模型放置问题。
快速文件夹对照表
| 模型类型 | 放置位置 | 常用加载器 |
|---|---|---|
| Checkpoint | ComfyUI/models/checkpoints/ | Load Checkpoint |
| LoRA | ComfyUI/models/loras/ | Load LoRA |
| VAE | ComfyUI/models/vae/ | Load VAE |
| ControlNet | ComfyUI/models/controlnet/ | Load ControlNet Model |
| Embedding / Textual Inversion | ComfyUI/models/embeddings/ | 在提示词文本中使用 |
| CLIP / 文本编码器 | ComfyUI/models/text_encoders/ 或 models/clip/ | CLIP 加载器节点 |
| Flux 扩散模型 / UNet | ComfyUI/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.safetensors | models/checkpoints/ | 由 Load Checkpoint 加载的完整 checkpoint |
Flux 工作流中的 ae.safetensors | models/vae/ | Flux 自动编码器 / VAE 组件 |
clip_l.safetensors | models/clip/ 或 models/text_encoders/ | CLIP / 文本编码器组件,不是 checkpoint |
t5xxl_fp16.safetensors、t5xxl_fp8*.safetensors | models/text_encoders/ | Flux 风格工作流使用的 T5 文本编码器 |
umt5_xxl_fp8_e4m3fn_scaled.safetensors | models/text_encoders/ | 新版 Flux 风格工作流使用的文本编码器 |
gemma_3_12b_it_fp4_mixed.safetensors | models/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 并确认你编辑的是正在运行的那个安装 |
工作流导入检查清单
当共享工作流报告模型缺失时,请按以下顺序检查:
- 先确认红色 / 缺失节点已修复。
- 阅读加载器节点名称:checkpoint、LoRA、VAE、CLIP、ControlNet、扩散模型、GGUF 或放大模型。
- 将文件放入该加载器对应的文件夹,而不是仅凭文件扩展名推断的文件夹。
- 确认你将文件移入的是当前正在运行的 ComfyUI 安装。
- 在判断文件仍然缺失之前,先重启 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 在当前文件夹路径配置中同时支持这两个文本编码器位置。
为什么下拉列表仍然为空
如果文件在正确的文件夹中但仍未显示:
- 检查扩展名。
.safetensors是受支持的格式,但部分下载的文件可能不受支持。 - 刷新下拉列表或重启 ComfyUI。
- 确保文件不在 zip 压缩包或浏览器下载临时文件中。
- 确认你编辑的 ComfyUI 文件夹与正在运行的是同一个。
- 如果模型位于 ComfyUI 文件夹之外,请检查
extra_model_paths.yaml。 - 如果 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 上缺失或不可用
参考来源
先按上面的步驟定位根因。还卡住时,可以下载 Wonderful Launcher 检查目前机器;启动器原生修复、任务日誌和執行階段检查会集中在一起。credits 只用於图片生成和按量工具。
下载 Wonderful Launcher查看 credits 方案这篇文件解決了你的問题嗎?
你的回饋会帮助我们優先補強真實 ComfyUI 排障文件。