大家好，我是在部署 SD WebUI 过程中把几乎所有坑都踩了一遍的选手，从 Git 报错、模块缺失、依赖冲突到虚拟环境异常，全部踩完。今天把完整安装流程 + 我遇到的所有真实错误 + 一行一解全部整理出来，写成一篇能直接发 CSDN 的完整文章。

---

一、前言

Stable Diffusion WebUI 是目前 AI 绘画最主流的本地部署工具，但 Windows 环境下因为 Python 版本、虚拟环境、Git 仓库、依赖包、CLIP 编译 等问题，90% 的新手都会启动失败。本文包含：

• 标准 Windows 一键部署流程
• 我真实遇到的 10+ 种报错
• 每一种报错的 原因 + 直接复制可用的命令
• 最终测试出图提示词（中文）适合：新手、GTX1650 / 4G 显存、Windows10/11

---

二、环境准备（标准安装流程）

1. 必备软件

1. Python 3.10.11（必须 3.10，高版本必报错）
2. Git（安装时勾选 Add to PATH）
3. SD WebUI 源码

   plaintext

   git clone https://github.com/AUTOMATIC1111/stable-diffusion-webui.git
   

4. 模型文件（如 Realistic Vision V6.0）放入：models/Stable-diffusion/

2. 标准启动流程

1. 进入目录
2. 双击 webui-user.bat
3. 自动下载依赖、克隆仓库、安装 torch
4. 出现 Running on local URL: http://127.0.0.1:7860 成功

---

三、我遇到的所有报错 + 原因 + 解决方案（硬核汇总）

以下全部是我真实部署时触发的错误，你遇到任意一条，直接对照解决。

报错总览表（可直接放 CSDN）

表格

报错信息	核心原因	解决方案
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

---

四、逐行报错详解

1. UnboundLocalError: local variable 'sys' referenced before assignment

原因：手动修改代码时破坏了 sys 模块作用域。

解决：还原 modules/launch_utils.py 为官方原版。

---

2. SyntaxError: name 'sys' is used prior to global declaration

原因：错误添加 global sys 导致语法冲突。

解决：删除所有 global sys 语句。

---

3. fatal: not a git repository + Couldn't fetch Stable Diffusion

原因：repositories/stable-diffusion-stability-ai 目录无效。

解决：

bash

运行

git clone https://github.com/Stability-AI/stablediffusion.git repositories/stable-diffusion-stability-ai
git -C repositories/stable-diffusion-stability-ai checkout cf1d67a6fd5ea1aa600c4df58e5b47da45f6bdbf

---

4. ModuleNotFoundError: No module named 'clip'

原因：pip 的 clip 包不是 OpenAI 官方 CLIP。

解决：

bash

运行

pip install https://github.com/openai/CLIP/archive/d50d76daa670286dd6cacf3bcd80b5e4823fc8e1.zip

---

5. ModuleNotFoundError: No module named 'sgm'

原因：缺少 SDXL 核心仓库。

解决：

bash

运行

git clone https://github.com/Stability-AI/generative-models.git repositories/generative-models

---

6. ModuleNotFoundError: No module named 'k_diffusion'

原因：缺少采样器仓库。

解决：

bash

运行

git clone https://github.com/crowsonkb/k-diffusion.git repositories/k-diffusion

---

7. ModuleNotFoundError: No module named 'packaging'

原因：虚拟环境缺少基础依赖。

解决：

bash

运行

venv\Scripts\activate
pip install packaging --upgrade

---

8. Failed to initialize NumPy: _ARRAY_API not found

原因：numpy 安装损坏。

解决：

bash

运行

pip install --force-reinstall numpy
pip install pytorch-lightning

---

9. AssertionError: Couldn't find Stable Diffusion

原因：--skip-install 屏蔽了仓库克隆。

解决：删除 webui-user.bat 里的 --skip-install。

---

10. FutureWarning: Importing from timm.models.layers

原因：timm 库版本警告，不影响运行。

解决：

bash

运行

pip install timm==0.9.8 --upgrade

---

五、最容易失败的关键点（新手必看）

1. 必须用 Python3.10，3.11/3.12 必报错
2. Git 必须安装并加入 PATH
3. 路径不能有中文、空格
4. 所有依赖必须装在 venv 虚拟环境
5. CLIP 必须装 源码版，不能装 pip 的 clip
6. repositories 目录下 5 个仓库缺一不可

---

六、部署成功测试：中文提示词（直接复制）

正向

plaintext

(最高画质, 杰作, 超精细细节), 写实照片, 1个女孩, 微笑, 窗边自然光, 细腻皮肤, 高清质感, 8k

反向

plaintext

卡通, 动画, 丑陋, 变形, 模糊, 低分辨率, 水印, 文字, 色差, 失真, 坏手, 多余肢体

参数

• 采样器：DPM++ 2M Karras
• 步数：25
• 分辨率：512×768
• CFG：7

---

七、总结

Stable Diffusion WebUI 启动失败 99% 都是：

• Git 仓库缺失
• 依赖包版本不对
• CLIP 安装错误
• 虚拟环境异常
• Python 版本不兼容

我把所有坑全部踩完，整理成这一篇，你遇到任何报错，都能在本文找到答案。

八、附件

stable-diffusion-stability-ai资源-CSDN下载