跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
编程语言AI算法

Stable Diffusion 报错排查:CheckpointLoaderSimple 模型文件缺失修复

遇到 Stable Diffusion 启动时 CheckpointLoaderSimple 报错提示模型文件不在列表中,通常是因为本地检查点文件夹缺少对应的 ckpt 或 safetensors 文件。解决方法是前往 HuggingFace 下载官方推荐的 v1-5-pruned-emaonly 模型并放入 models/checkpoints 目录,同时补充标准 VAE 文件到 models/vae 目录。配置完成后重新生成,初期效果可能不理想,持续调整参数即可得到满意结果。

Ne0发布于 2026/4/9更新于 2026/10/25100 浏览

Stable Diffusion 报错排查:CheckpointLoaderSimple 模型文件缺失修复

最近不少朋友在运行 Stable Diffusion 时遇到了类似的报错信息:

text
提示输出验证失败:CheckpointLoaderSimple: - 值不在列表中:ckpt_name: 'v1-5-pruned-emaonly-fp16.safetensors' 不在 ['anything-v5-PrtRE.safetensors'] 中

这通常意味着你的模型文件夹里缺少了当前工作流指定的核心模型文件。别急,按照以下步骤补全环境即可。

确认缺失的主模型

你需要的是官方标准的 v1-5-pruned-emaonly.safetensors 模型。可以通过以下链接获取:

https://huggingface.co/runwayml/stable-diffusion-v1-5/tree/main

进入页面后,找到对应文件点击下载箭头,然后将文件放入项目的 models/checkpoints 目录下。

补充标准 VAE 文件

为了保证出图色彩正常,建议同时下载标准的 VAE 文件:vae-ft-mse-840000-ema-pruned.safetensors。

下载地址:

https://huggingface.co/stabilityai/sd-vae-ft-mse-original/tree/main

将该文件放入 models/vae 文件夹中。

开始生成

现在你已经拥有运行所需的一切了。重启界面后再次尝试生成。

刚开始生成的图片可能不太理想,这是正常的。保持耐心,多尝试几次,很快你就能得到很棒的结果。

目录

  1. Stable Diffusion 报错排查:CheckpointLoaderSimple 模型文件缺失修复
  2. 确认缺失的主模型
  3. 补充标准 VAE 文件
  4. 开始生成

更多推荐文章

查看全部
  • Cursor 编辑器 C/C++ 代码跳转问题解决方案
  • Rust 错误处理与测试:打造健壮可维护应用的核心实践
  • Java 项目中基于 Log4j 的日志工具类封装实践
  • PostgreSQL 动态分区裁剪技术:查询性能优化解析
  • 数据结构与算法:C++ 堆的实现与原理详解
  • NASA 火星任务软件测试:利用 AIGC 模拟极端环境攻击
  • 前端文件下载实战:从原理到最佳实践
  • AI Agent 基础架构与核心组件详解
  • C++11 核心特性:列表初始化与右值引用移动语义详解
  • 5 款开源 PPT 生成大模型实测对比:从技术原理到实战效果
  • RocketMQ 5.0 延时消息架构:时间轮算法与分布式调度实践
  • AI Agent 推理架构对比:ReAct 与 Plan-and-Execute 的选择
  • AI 图像生成指南:从原理到实战
  • C++ 位运算详解:基础题解与思维分析
  • Node.js 安装指南(macOS 版)
  • 2024 年转行 AI 产品经理的时机与准备指南
  • Python 数据科学工具链入门:NumPy、Pandas、Matplotlib 实战指南
  • Python PyQt5 安装与配置及界面设计教程
  • 基于 ChatGLM-6B 的医疗领域大模型微调实战指南
  • 内容创作模式解析:UGC、PGC、PUGC、OGC、MGC、BGC 与 AIGC

相关免费在线工具

  • 加密/解密文本

    使用加密算法(如AES、TripleDES、Rabbit或RC4)加密和解密文本明文。 在线工具,加密/解密文本在线工具,online

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Gemini 图片去水印

    基于开源反向 Alpha 混合算法去除 Gemini/Nano Banana 图片水印,支持批量处理与下载。 在线工具,Gemini 图片去水印在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online