Stable Diffusion 模型加载失败排查与修复指南

错误现象

启动时控制台抛出 CheckpointLoaderSimple 验证失败，提示指定的 checkpoint 文件名不在当前模型列表里。简单来说，就是配置文件里写的模型名，在你的 models/checkpoints 文件夹中找不到。

核心原因

通常是因为模型文件缺失，或者文件名不匹配。这里需要补充两个关键文件才能正常运行。

解决方案

1. 补全主模型 你需要下载 v1-5-pruned-emaonly-fp16.safetensors。 下载地址：https://huggingface.co/runwayml/stable-diffusion-v1-5/tree/main 操作：点击右侧下载箭头，将文件放入 models/checkpoints 目录。

2. 补全 VAE 文件 为了获得正常的色彩还原，建议搭配标准 VAE 使用。 文件名：vae-ft-mse-840000-ema-pruned.safetensors 下载地址：https://huggingface.co/stabilityai/sd-vae-ft-mse-original/tree/main 操作：放入 models/vae 目录。

后续建议

配置好上述文件后，重启程序即可。刚开始生成的图片可能不够完美，这很正常。多尝试几次调整参数，很快就能得到满意的结果。