需将Checkpoint文件放入models/Stable-diffusion目录，优先用.safetensors格式，刷新WebUI模型列表，正确配置VAE，并确保文件完整及磁盘格式兼容。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您已下载 Stable Diffusion 的 Checkpoint 大模型文件，但 WebUI 界面中未显示或加载失败，则可能是由于文件未放置在正确路径、后缀不兼容或未刷新模型列表所致。以下是具体操作步骤：
一、确认正确的存放路径
Stable Diffusion WebUI 要求 Checkpoint 文件必须严格置于指定目录下，否则无法识别。该路径为 WebUI 根目录内的子文件夹，与安装方式无关，所有主流整合包（如秋叶、AUTOMATIC1111、星空等）均遵循此结构。
1、打开 Stable Diffusion WebUI 所在的根文件夹（例如 D:\sd-webui 或 /home/user/stable-diffusion-webui）。
2、进入 models 文件夹。
3、确认其中存在名为 Stable-diffusion 的子文件夹（注意大小写和连字符）。
4、将下载的 Checkpoint 文件（.ckpt 或 .safetensors）直接复制到该 models/Stable-diffusion 目录内，不得嵌套在任何子文件夹中。
二、优先选用 .safetensors 格式文件
.safetensors 是当前推荐格式，具备加载更快、安全性更高、内存占用更低等优势；.ckpt 文件虽仍可被支持，但存在潜在反序列化风险且加载耗时更长。若同时存在同名的 .ckpt 与 .safetensors，WebUI 默认优先加载 .safetensors。
1、检查下载的模型是否包含 .safetensors 后缀文件（如 realisticVisionV60.safetensors）。
2、若仅有 .ckpt 文件，建议前往 Civitai 或 Hugging Face 查找对应模型的 .safetensors 版本并重新下载。
3、若模型附带同名 .yaml 配置文件（如 realisticVisionV60.yaml），也需一并放入同一目录，否则部分模型可能无法正确解析参数。
三、手动刷新模型列表
WebUI 不会自动扫描新增文件，必须通过界面操作触发模型重载，否则新放入的 Checkpoint 将始终不可见。
1、确保 WebUI 已完全启动并进入主界面（地址通常为 http://127.0.0.1:7860）。
2、点击顶部导航栏的 “Checkpoint” 下拉菜单右侧的 “刷新”图标（?）。
3、等待右上角弹出提示 “Model list updated.”。
4、再次点击 Checkpoint 下拉菜单，确认新模型名称已出现在列表中。
四、验证 VAE 关联设置
部分 Checkpoint 模型依赖特定 VAE（变分自编码器）才能输出正常色彩与细节。若加载后图像发灰、过暗或边缘模糊，很可能是 VAE 未正确绑定。
1、检查模型介绍页是否注明推荐 VAE（如 vae-ft-mse-840000-ema-pruned.safetensors）。
2、将对应 VAE 文件放入 models/VAE 目录（非 Stable-diffusion 目录）。
3、在 WebUI 右侧“Settings”选项卡中，搜索 "VAE" ，启用 "Auto-select VAE" 或手动选择匹配的 VAE 文件。
4、点击 “Apply settings” 并重启 WebUI 生效。
五、排查文件权限与完整性
Windows/Linux/macOS 系统对大文件读取权限或磁盘格式可能存在限制，尤其当模型体积超过 4GB 且存储于 FAT32 分区时，会导致加载中断或静默失败。
1、右键检查模型文件属性，确认大小是否与下载页标注一致（如 3.82 GB），若明显偏小（如仅几百 MB），说明下载未完成。
2、在 Windows 上，确认目标磁盘为 NTFS 格式；在 macOS 上，避免使用 exFAT 分区存放 >4GB 模型。
3、若使用网盘客户端（如夸克、百度网盘）下载，务必等待“传输完成”提示后再移动文件，禁止直接拖拽正在下载中的临时文件。
