Stable Diffusion 模型加载失败：CheckpointLoaderSimple 错误修复

Stable Diffusion 模型加载失败排查

遇到 CheckpointLoaderSimple 报错，提示 ckpt_name 指定的模型文件不在当前可用列表中，这通常意味着工作流配置的模型与实际文件夹内的文件不匹配，或者关键的基础模型缺失。

核心原因

系统试图加载 v1-5-pruned-emaonly-fp16.safetensors，但检测到目录下只有其他模型（如 anything-v5），或者根本找不到对应的 v1-5 基座。

解决方案

1. 获取基础模型

你需要下载官方的 Stable Diffusion v1-5 权重文件。 访问官方仓库：https://huggingface.co/runwayml/stable-diffusion-v1-5/tree/main 找到 v1-5-pruned-emaonly.safetensors 并点击下载箭头保存。将文件重命名为 v1-5-pruned-emaonly-fp16.safetensors（如果配置强制要求 fp16 后缀）或直接确保文件名与工作流一致，然后放入 models/checkpoints 文件夹。

2. 补充 VAE 文件

标准的 VAE 对色彩还原至关重要，缺少它会导致画面发灰。 下载地址：https://huggingface.co/stabilityai/sd-vae-ft-mse-original/tree/main 下载 vae-ft-mse-840000-ema-pruned.safetensors，放置到 models/vae 目录中。

调试建议

环境配置完成后重启程序。初次生成的图像质量可能不稳定，这是正常的迭代过程。建议先固定种子数测试，再逐步调整采样器和步长。只要模型路径正确，后续生成效率会显著提升。