一、前言
Stable Diffusion WebUI 是目前 AI 绘画最主流的本地部署工具,但 Windows 环境下因为 Python 版本、虚拟环境、Git 仓库、依赖包、CLIP 编译等问题,90% 的新手都会启动失败。本文包含标准 Windows 一键部署流程、常见报错汇总、每一种报错的原因及可直接复制可用的命令。
二、环境准备(标准安装流程)
1. 必备软件
- Python 3.10.11(必须 3.10,高版本必报错)
- Git(安装时勾选 Add to PATH)
- 模型文件(如 Realistic Vision V6.0)放入:
models/Stable-diffusion/
SD WebUI 源码
git clone https://github.com/AUTOMATIC1111/stable-diffusion-webui.git
2. 标准启动流程
- 进入目录
- 双击
webui-user.bat - 自动下载依赖、克隆仓库、安装 torch
- 出现
Running on local URL: http://127.0.0.1:7860成功
三、常见报错汇总
以下全部是真实部署时触发的错误,遇到任意一条,直接对照解决。
| 报错信息 | 核心原因 | 解决方案 |
|---|---|---|
| UnboundLocalError: sys 未定义 | 代码修改导致作用域异常 | 还原官方 launch_utils.py |
| SyntaxError: sys 全局声明错误 | 错误使用 global sys | 删除所有 global sys 语句 |
| fatal: not a git repository | 仓库缺失 / 不是 git 目录 | 手动克隆仓库到 repositories |
| Couldn't fetch Stable Diffusion | stable-diffusion-stability-ai 缺失 | 重新克隆指定版本仓库 |
| ModuleNotFoundError: clip | CLIP 未安装 / 安装错误 | 安装源码版 CLIP,非 pip clip |
| ModuleNotFoundError: sgm | 缺少 generative-models 仓库 | 克隆仓库 |
| ModuleNotFoundError: k_diffusion | 缺少 k-diffusion 仓库 | 克隆仓库 |
| ModuleNotFoundError: packaging | 虚拟环境缺少 packaging | pip install packaging --upgrade |
| Failed to initialize NumPy | numpy 损坏 | 强制重装 numpy |
| AssertionError: Couldn't find Stable Diffusion | 核心仓库被 --skip-install 屏蔽 | 移除 --skip-install |
| FutureWarning: timm.models.layers | timm 版本警告 | 升级 timm 到 0.9.8 |

