详细整理了 Stable Diffusion WebUI 在 Windows 环境下的标准部署流程及常见报错解决方案。涵盖 Python 版本选择、Git 仓库克隆、依赖包安装等关键步骤。针对 UnboundLocalError、ModuleNotFoundError 等 10 余种典型错误提供了具体原因分析与修复命令。最后给出了测试出图的提示词参数配置，帮助新手快速完成本地 AI 绘画工具搭建并解决启动失败问题。
Stable Diffusion WebUI 是目前 AI 绘画最主流的本地部署工具，但 Windows 环境下因为 Python 版本、虚拟环境、Git 仓库、依赖包、CLIP 编译等问题，90% 的新手都会启动失败。本文包含：
models/Stable-diffusion/SD WebUI 源码
git clone https://github.com/AUTOMATIC1111/stable-diffusion-webui.git
webui-user.batRunning 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 |
原因：手动修改代码时破坏了 sys 模块作用域。
解决：还原 modules/launch_utils.py 为官方原版。
原因：错误添加 global sys 导致语法冲突。
解决：删除所有 global sys 语句。
原因：repositories/stable-diffusion-stability-ai 目录无效。
解决：
git clone https://github.com/Stability-AI/stablediffusion.git repositories/stable-diffusion-stability-ai
git -C repositories/stable-diffusion-stability-ai checkout cf1d67a6fd5ea1aa600c4df58e5b47da45f6bdbf
原因：pip 的 clip 包不是 OpenAI 官方 CLIP。
解决：
pip install https://github.com/openai/CLIP/archive/d50d76daa670286dd6cacf3bcd80b5e4823fc8e1.zip
原因：缺少 SDXL 核心仓库。
解决：
git clone https://github.com/Stability-AI/generative-models.git repositories/generative-models
原因：缺少采样器仓库。
解决：
git clone https://github.com/crowsonkb/k-diffusion.git repositories/k-diffusion
原因：虚拟环境缺少基础依赖。
解决：
venv\Scripts\activate pip install packaging --upgrade
原因：numpy 安装损坏。
解决：
pip install --force-reinstall numpy pip install pytorch-lightning
原因：--skip-install 屏蔽了仓库克隆。
解决：删除 webui-user.bat 里的 --skip-install。
原因：timm 库版本警告，不影响运行。
解决：
pip install timm==0.9.8 --upgrade
repositories 目录下 5 个仓库缺一不可(最高画质，杰作，超精细细节), 写实照片，1 个女孩，微笑，窗边自然光，细腻皮肤，高清质感，8k
卡通，动画，丑陋，变形，模糊，低分辨率，水印，文字，色差，失真，坏手，多余肢体
Stable Diffusion WebUI 启动失败 99% 都是：
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
使用加密算法（如AES、TripleDES、Rabbit或RC4）加密和解密文本明文。 在线工具，加密/解密文本在线工具，online
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具，curl 转代码在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online