ComfyUI 裡的 safetensors 應該放哪裡

快速找到 ComfyUI 中 .safetensors 文件的正確目錄：checkpoint、LoRA、VAE、ControlNet、Flux/Q8 diffusion model、clip_l/t5xxl text encoder 和 upscaler。

已核對環境

OS: Windows 10 / 11
Launcher: Wonderful Launcher v1.x
ComfyUI: Portable / Managed install
Python: 3.11+
CUDA / Torch: CUDA 12.x / Torch 2.x
Last tested: 2026-06-04

如果你搜的是 where to put safetensors in comfyui、where do safetensors go in comfyui 或 comfyui safetensors folder，最短答案是：

先把文件放到 ComfyUI/models/ 下面，但具體子目錄要按模型類型分，不要只看它是不是 .safetensors。

比如：

checkpoint 放 models/checkpoints/
LoRA 放 models/loras/
VAE 放 models/vae/
Flux diffusion model 常放 models/diffusion_models/
text encoder 常放 models/text_encoders/ 或 models/clip/

如果文件放錯目錄，ComfyUI 可能能正常啟動，但模型下拉框是空的，或者工作流校驗失敗。

最容易搞錯的一點

.safetensors 只是文件擴展名，不是模型類型。

這些文件都可能是 .safetensors，但它們不該放在同一個目錄：

完整 checkpoint
LoRA
VAE
ControlNet 模型
Flux diffusion model
text encoder

如果你只按擴展名分類，最後很容易把正確的文件放進錯誤的目錄。

常見文件例子

文件名或模式	通常放哪裡	為什麼
`sd_xl_base_1.0.safetensors`、`realvisxl.safetensors`	`models/checkpoints/`	標準完整 checkpoint
`ae.safetensors`（Flux 工作流）	`models/vae/`	Flux autoencoder / VAE
`clip_l.safetensors`	`models/clip/` 或 `models/text_encoders/`	CLIP / text encoder 組件，不是 checkpoint
`t5xxl_fp16.safetensors`、`t5xxl_fp8*.safetensors`	`models/text_encoders/`	Flux 類工作流常用的 T5 text encoder
`umt5_xxl_fp8_e4m3fn_scaled.safetensors`	`models/text_encoders/`	Flux 類工作流 text encoder
`qwen_*.safetensors`	`models/text_encoders/`	text encoder，不是 checkpoint
Q8 / FP8 Flux diffusion 文件	`models/diffusion_models/` 或 `models/unet/`	量化 diffusion model，通常由 diffusion / UNet loader 加載
`4x_*.safetensors` 或 ESRGAN 風格文件	`models/upscale_models/`	給 Upscale Model Loader 用
Flux GGUF 或獨立 diffusion model	`models/diffusion_models/`	給 diffusion / UNet / GGUF loader 用

如果文件名裡帶 Flux、Qwen 之類的模型家族名，不要默認把它丟進 models/checkpoints/。先看工作流用的是哪個 loader。

已經下載了模型，但不知道保存在哪裡

如果你搜的是“ComfyUI 下載的模型在哪”“ComfyUI/models/checkpoints 文件夾在哪”或“模型應該放進 ComfyUI 哪個文件夾”，先從正在運行的那個 ComfyUI 目錄開始看：

ComfyUI/models/

手動下載的文件不會自動進入統一目錄。瀏覽器下載通常還在下載文件夾裡；Launcher、工作流輔助工具或 custom node 可能會把文件放到當前 ComfyUI 的 models/ 目錄、Hugging Face cache，或者某個節點自己的目錄。下拉框裡看不到模型時，先確認你改的是正在運行的那個 ComfyUI 安裝。

如果文件名裡有 q8、fp8、fp16 或 gguf，不要只憑這些標籤判斷目錄。它們描述的是精度或格式，不是 loader。先看工作流節點：checkpoint 放 checkpoints，text encoder 放 text_encoders 或 clip，VAE 放 vae，diffusion / GGUF 模型通常放 diffusion_models 或兼容舊路徑的 unet。

快速判斷

你看到什麼	通常意味著什麼	第一檢查項
文件明明在磁盤裡，但下拉框看不到	放錯目錄了	對照上面的目錄表
Flux 或 UNet 文件在 Load Checkpoint 裡看不到	你在用錯 loader，也常常放錯目錄	放到 `diffusion_models` 並使用對應 loader
LoRA 文件完全不出現在 checkpoint 列表裡	它本來就不是 checkpoint	放進 `models/loras/`
text encoder 文件不顯示	text encoder 路徑不對	檢查 `models/text_encoders/` 或 `models/clip/`
放對目錄還是不顯示	你改錯了 ComfyUI 安裝目錄，或者模型列表沒刷新	重啟 ComfyUI，確認你改的是正在運行的那個實例

常見目錄說明

Checkpoint

標準 Stable Diffusion / SDXL checkpoint 放這裡：

ComfyUI/models/checkpoints/

常見例子：

realvisxl.safetensors
dreamshaper.safetensors
sd_xl_base_1.0.safetensors

它們通常配合 Load Checkpoint 節點使用。

LoRA

LoRA 放這裡：

ComfyUI/models/loras/

LoRA 不是完整模型，需要配合兼容的 base model。 SD 1.5 的 LoRA 要配 SD 1.5 checkpoint，SDXL 的 LoRA 要配 SDXL checkpoint。

VAE

VAE 放這裡：

ComfyUI/models/vae/

錯誤的 VAE 會導致顏色、解碼或模型匹配問題。

ControlNet

ControlNet 文件放這裡：

ComfyUI/models/controlnet/

還要注意模型家族匹配：SD 1.5 的 ControlNet 不能直接拿去給 SDXL 用。

Flux / UNet / Diffusion Models

較新的 Flux 風格工作流往往不是“一個老式 checkpoint 文件走天下”。

獨立 diffusion model 常放在：

ComfyUI/models/diffusion_models/

有些舊工作流或舊節點文檔還會寫：

ComfyUI/models/unet/

這兩種寫法在資料裡都可能出現。

Text Encoder / CLIP

text encoder 常放在：

ComfyUI/models/text_encoders/

一些舊資料裡也會出現：

ComfyUI/models/clip/

如果你放的是 Qwen、T5、CLIP 這類文本編碼器，就不要再去 checkpoint 列表裡找它。

什麼時候不是目錄問題

如果你已經確認目錄沒錯，但模型仍然不顯示，再排這些：

你改的是不是當前正在運行的那套 ComfyUI
相關 custom node / loader 有沒有安裝
文件名和工作流要求的格式是否匹配
重啟之後模型列表有沒有刷新

如果你正在排 GGUF loader，繼續看 ComfyUI GGUF。如果工作流導入後大量紅節點，一起看 ComfyUI Workflow Red Nodes。

先按上面的步驟定位根因。還卡住時，可以下載 Wonderful Launcher 檢查目前機器；啟動器原生修復、任務日誌和執行階段檢查會集中在一起。credits 只用於圖片生成和按量工具。

下載 Wonderful Launcher 查看 credits 方案

這篇文件解決了你的問題嗎？

你的回饋會幫助我們優先補強真實 ComfyUI 排障文件。