Stable Diffusion 使用记录

一段时间没有使用生图，本地的 Stable Diffusion 环境（Forge 和 ComfyUI）都出现问题。借此机会重新整理一遍使用要点，以便后续快速恢复。

主流 UI 对比

Stable Diffusion 的官方 WebUI 已停止维护，主要替代方案有两种：

Forge

继承自官方 WebUI，保持了类似的操作方式
界面直观，上手难度低
功能完整，支持大部分扩展插件
适合快速生成和实验

ComfyUI

采用工作流（workflow）方式，以节点图表组织操作
灵活性强，可精细控制每一步参数
学习曲线陡峭，使用复杂度较高
适合需要精细调试和工程化应用

ComfyUI 复用模型

如果已有 Stable Diffusion WebUI 的模型库，ComfyUI 可以直接复用，避免重复下载。

配置步骤：

找到 ComfyUI 根目录中的 extra_model_paths.yaml.example 文件
重命名为 extra_model_paths.yaml
编辑 base_path，指向 stable-diffusion-webui 所在目录（支持相对路径）

示例配置：

checkpoints: models/Stable-diffusion
configs: models/Stable-diffusion
vae: models/VAE
loras: |
  models/Lora
  models/LyCORIS
upscale_models: |
  models/ESRGAN
  models/RealESRGAN
  models/SwinIR
embeddings: embeddings
hypernetworks: models/hypernetworks
controlnet: models/ControlNet

配置后重启 ComfyUI，即可在 UI 中看到已有的模型。

常见问题

VRAM 不足警告

错误信息： This number is lower than the safe threshold; This may cause extreme slow performance

解决方案： 增加启动参数 --reserve-vram 2

bash ./webui.sh --reserve-vram 2

这会为系统保留 2GB 显存，降低 OOM 风险，但代价是生成速度会变慢。根据显卡显存调整数值。

生成黑色图像

原因： 模型使用了错误的 VAE

解决方案：

查看模型说明文档，确认使用的 VAE 类型
检查 VAE 文件是否已下载到正确位置（models/VAE/）
在 WebUI 或 ComfyUI 中显式选择正确的 VAE
重新生成

常见的 VAE 类型有 vae-ema-pruned.safetensors（通用）和模型特定的 VAE。模型作者通常会在模型页面备注。

恢复建议

环境出现问题时，按以下顺序排查：

重新安装依赖：pip install -r requirements.txt
检查 Python 和 CUDA 版本：确保兼容性
清理缓存：删除生成的临时文件
更新到最新版本：UI 和依赖库可能有修复
参考官方文档：Forge 和 ComfyUI 的 GitHub 仓库都有详细的故障排查指南

最后修改于 2026-06-17