【2025最新AI说明书】Windows 系统上安装和配置 Stable Diffusion WebUI_stable-diffusion-webui windows 下如何安装
Windows系统安装与配置Stable Diffusion WebUI(AUTOMATIC1111)权威指南
本指南将为您详细介绍如何在Windows操作系统上安装和配置广受欢迎的Stable Diffusion WebUI(由AUTOMATIC1111开发),助您开启本地AI图像生成之旅。
一、硬件与软件要求
在开始安装之前,请确保您的电脑满足以下基本要求,以获得流畅的体验:
重要提示: 目前,Stable Diffusion WebUI对NVIDIA显卡的支持最为完善。虽然在AMD和Intel显卡上也有运行方案,但配置过程更为复杂,且性能可能不及NVIDIA显卡。
二、安装前准备
在正式安装Stable Diffusion WebUI之前,您需要先在系统中安装两个必要的软件:Python 和 Git。
1. 安装 Python
Stable Diffusion WebUI需要特定版本的Python。截至目前,强烈推荐安装Python 3.10.6。过高或过低的版本都可能导致兼容性问题。
点击查看Pyhton安装说明书
2. 安装 Git
Git是一个版本控制系统,我们将用它来下载和更新Stable Diffusion WebUI的源代码。
点击查看Git安装说明书
三、安装Stable Diffusion WebUI
完成上述准备工作后,现在可以开始安装WebUI本体。
1. 克隆WebUI仓库
-
选择一个磁盘分区,创建一个用于存放Stable Diffusion相关文件的文件夹,例如
D:\\StableDiffusion
。
-
进入该文件夹,在地址栏输入
cmd
并回车,以在此处打开命令提示符窗口。 -
在命令提示符窗口中,输入以下命令并回车:
git clone https://github.com/AUTOMATIC1111/stable-diffusion-webui.git
此命令会从GitHub上下载最新的WebUI文件到您的文件夹中。下载完成后,您会看到一个名为 `stable-diffusion-webui` 的新文件夹。
2. 下载基础模型
Stable Diffusion需要一个基础模型(Checkpoint)才能生成图像。推荐初学者使用官方的 v1-5-pruned-emaonly.safetensors
模型。
-
下载地址: Hugging Face模型下载页面
-
存放路径: 将下载好的模型文件(
.ckpt
或.safetensors
格式)放入以下路径:D:\\StableDiffusion\\stable-diffusion-webui\\models\\Stable-diffusion
(请将D:\\StableDiffusion
替换为您自己的安装路径)
3. 首次启动与安装依赖
-
进入
stable-diffusion-webui
文件夹。 -
找到并双击运行
webui-user.bat
文件。
-
首次运行时,程序会自动下载并安装所有必需的依赖库(如PyTorch等)。这个过程耗时较长(可能需要10-30分钟,具体取决于您的网络速度),请耐心等待,期间请勿关闭命令提示符窗口。
-
当您在命令提示符窗口中看到类似以下的输出时,代表安装和启动已成功:
Running on local URL: http://127.0.0.1:7860
- 此时,打开您的浏览器(推荐使用Chrome或Edge),访问
http://127.0.0.1:7860
,即可看到Stable Diffusion WebUI的操作界面。
四、基础配置与优化
为了提升性能和易用性,您可以对 webui-user.bat
文件进行一些简单的配置。
-
在
stable-diffusion-webui
文件夹中,右键点击webui-user.bat
文件,选择 “编辑” (或使用记事本打开)。 -
您会看到一行
set COMMANDLINE_ARGS=
。您可以在等号后面添加一些启动参数,例如:--xformers
:能够显著提升NVIDIA显卡的生图速度并降低显存消耗。强烈推荐添加。--medvram
:适用于显存较低(如4GB-6GB)的显卡,会以牺牲部分速度为代价来减少显存使用。--autolaunch
:启动完成后自动在浏览器中打开WebUI界面。git pull
:在每次启动时自动检查并更新WebUI到最新版本。
示例配置:
@echo offset PYTHON=set GIT=set VENV_DIR=set COMMANDLINE_ARGS=--xformers --autolaunchgit pullcall webui.bat
- 修改完成后,保存并关闭文件。之后每次启动都通过双击
webui-user.bat
来运行。
五、开始您的创作之旅
现在,您已经成功搭建了本地的Stable Diffusion环境。在WebUI界面中:
- 选择模型: 在左上角的 “Stable Diffusion checkpoint” 下拉菜单中,确保您下载的模型已被选中。
- 输入提示词(Prompt): 在 “txt2img” (文生图) 标签页的 “Prompt” 输入框中,用英文描述您想生成的画面内容。
- 点击生成: 点击橙色的 “Generate” 按钮,等待片刻,您的第一张AI作品就会呈现在右侧。
祝您在AI艺术创作的道路上玩得开心!
BUG记录
1、找到并双击运行 webui-user.bat
文件出现Couldn’t launch python
解决方案一,重启电脑
如果安装python中环境变量那里没问题,就重启一下电脑
解决方案二:重新安装Python (最简单、推荐)
这是最直接也是最不容易出错的方法。
-
找到您之前下载的Python 3.10.6安装包(文件名类似
python-3.10.6-amd64.exe
)。如果找不到了,可以重新下载。 -
双击运行安装程序。
-
您会看到一个\"Modify Setup\"(修改安装)的界面。请确保点击 “Modify”。
-
在下一个\"Optional Features\"(可选功能)界面,直接点击 “Next”。
-
现在是最关键的一步! 在 “Advanced Options”(高级选项)界面,务必勾选 “Add Python to environment variables” (将Python添加到环境变量)。如下图所示:
-
点击 “Install”,等待安装完成即可。
解决方案三:手动添加环境变量 (适合有一定经验的用户)
如果您不想重新安装,也可以手动将Python路径添加到系统环境变量中。
-
找到Python安装路径:
- 如果您是按默认设置安装的,路径通常是:
C:\\Users\\您的用户名\\AppData\\Local\\Programs\\Python\\Python310
- 请注意将
您的用户名
替换为您自己的Windows用户名。AppData
可能是隐藏文件夹,您需要在文件资源管理器的“查看”选项中勾选“隐藏的项目”。
- 如果您是按默认设置安装的,路径通常是:
-
打开环境变量设置:
- 在Windows搜索栏中搜索“环境变量”,然后选择“编辑系统环境变量”。
- 在弹出的“系统属性”窗口中,点击“环境变量(N)…”按钮。
-
编辑Path变量:
- 在下方的“系统变量(S)”区域,找到名为
Path
的变量,选中它,然后点击“编辑(E)…”。 - 在“编辑环境变量”窗口中,点击“新建(N)”。
- 将您的Python安装路径(例如
C:\\Users\\您的用户名\\AppData\\Local\\Programs\\Python\\Python310
)粘贴进去。 - 再次点击“新建(N)”,将Python的
Scripts
路径也添加进去,路径是:C:\\Users\\您的用户名\\AppData\\Local\\Programs\\Python\\Python310\\Scripts
- 一路点击“确定”保存所有设置。
- 在下方的“系统变量(S)”区域,找到名为