安装前的准备工作

确保系统满足以下要求：Windows 10/11 或 Linux 系统，NVIDIA 显卡（推荐 4GB 显存以上），Python 3.10.6。关闭杀毒软件避免误拦截文件。

下载官方仓库代码：

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

依赖环境配置

安装Python依赖包时建议使用清华源加速：

pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

对于NVIDIA显卡用户需额外安装CUDA 11.8和cuDNN 8.6.0。Linux系统可能需要手动设置环境变量：

export LD_LIBRARY_PATH=/usr/local/cuda-11.8/lib64

模型文件部署

将下载的模型文件（如v1-5-pruned-emaonly.safetensors）放入正确路径：

• 主模型存放位置：models/Stable-diffusion/
• VAE模型存放位置：models/VAE/
• LoRA模型存放位置：models/Lora/

可通过修改webui-user.bat(Windows)或webui-user.sh(Linux)添加启动参数：

set COMMANDLINE_ARGS=--xformers --medvram

常见问题解决

出现Could not locate zlibwapi.dll错误时，需要手动下载该文件并放入C:\Windows\System32。若遇到OutOfMemoryError，可尝试添加--medvram或--lowvram参数。

对于ModuleNotFoundError，建议重建虚拟环境：

python -m venv venv
.\venv\Scripts\activate
pip install -r requirements.txt

自定义扩展安装

通过扩展列表页面或手动安装方式添加插件：

cd extensions
git clone https://github.com/hako-mikan/sd-webui-supermerger

安装后需重启WebUI并在设置中启用插件。部分插件如ControlNet需要额外下载预处理器模型。