> 技术文档 > 【2025最新AI说明书】Windows 系统上安装和配置 Stable Diffusion WebUI_stable-diffusion-webui windows 下如何安装

【2025最新AI说明书】Windows 系统上安装和配置 Stable Diffusion WebUI_stable-diffusion-webui windows 下如何安装


Windows系统安装与配置Stable Diffusion WebUI(AUTOMATIC1111)权威指南

本指南将为您详细介绍如何在Windows操作系统上安装和配置广受欢迎的Stable Diffusion WebUI(由AUTOMATIC1111开发),助您开启本地AI图像生成之旅。


一、硬件与软件要求

在开始安装之前,请确保您的电脑满足以下基本要求,以获得流畅的体验:

组件 最低要求 推荐配置 显卡 (GPU) 拥有至少4GB显存(VRAM)的NVIDIA显卡 拥有8GB或更高显存的NVIDIA RTX 30系列或40系列显卡 内存 (RAM) 16GB 32GB或更高 存储空间 至少25GB的可用磁盘空间(推荐使用SSD) 50GB或更多的SSD可用空间,用于存放模型和生成的图片 操作系统 Windows 10 或 Windows 11 Windows 11

重要提示: 目前,Stable Diffusion WebUI对NVIDIA显卡的支持最为完善。虽然在AMD和Intel显卡上也有运行方案,但配置过程更为复杂,且性能可能不及NVIDIA显卡。


二、安装前准备

在正式安装Stable Diffusion WebUI之前,您需要先在系统中安装两个必要的软件:PythonGit

1. 安装 Python

Stable Diffusion WebUI需要特定版本的Python。截至目前,强烈推荐安装Python 3.10.6。过高或过低的版本都可能导致兼容性问题。
点击查看Pyhton安装说明书

2. 安装 Git

Git是一个版本控制系统,我们将用它来下载和更新Stable Diffusion WebUI的源代码。
点击查看Git安装说明书


三、安装Stable Diffusion WebUI

完成上述准备工作后,现在可以开始安装WebUI本体。

1. 克隆WebUI仓库
  1. 选择一个磁盘分区,创建一个用于存放Stable Diffusion相关文件的文件夹,例如 D:\\StableDiffusion
    【2025最新AI说明书】Windows 系统上安装和配置 Stable Diffusion WebUI_stable-diffusion-webui windows 下如何安装

  2. 进入该文件夹,在地址栏输入 cmd 并回车,以在此处打开命令提示符窗口。

  3. 在命令提示符窗口中,输入以下命令并回车:

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

【2025最新AI说明书】Windows 系统上安装和配置 Stable Diffusion WebUI_stable-diffusion-webui windows 下如何安装

此命令会从GitHub上下载最新的WebUI文件到您的文件夹中。下载完成后,您会看到一个名为 `stable-diffusion-webui` 的新文件夹。

【2025最新AI说明书】Windows 系统上安装和配置 Stable Diffusion WebUI_stable-diffusion-webui windows 下如何安装

2. 下载基础模型

Stable Diffusion需要一个基础模型(Checkpoint)才能生成图像。推荐初学者使用官方的 v1-5-pruned-emaonly.safetensors 模型。

  • 下载地址: Hugging Face模型下载页面
    【2025最新AI说明书】Windows 系统上安装和配置 Stable Diffusion WebUI_stable-diffusion-webui windows 下如何安装
    【2025最新AI说明书】Windows 系统上安装和配置 Stable Diffusion WebUI_stable-diffusion-webui windows 下如何安装

  • 存放路径: 将下载好的模型文件(.ckpt.safetensors 格式)放入以下路径:

    D:\\StableDiffusion\\stable-diffusion-webui\\models\\Stable-diffusion
    (请将 D:\\StableDiffusion 替换为您自己的安装路径)
    【2025最新AI说明书】Windows 系统上安装和配置 Stable Diffusion WebUI_stable-diffusion-webui windows 下如何安装

3. 首次启动与安装依赖
  1. 进入 stable-diffusion-webui 文件夹。

  2. 找到并双击运行 webui-user.bat 文件。
    【2025最新AI说明书】Windows 系统上安装和配置 Stable Diffusion WebUI_stable-diffusion-webui windows 下如何安装

  3. 首次运行时,程序会自动下载并安装所有必需的依赖库(如PyTorch等)。这个过程耗时较长(可能需要10-30分钟,具体取决于您的网络速度),请耐心等待,期间请勿关闭命令提示符窗口。
    【2025最新AI说明书】Windows 系统上安装和配置 Stable Diffusion WebUI_stable-diffusion-webui windows 下如何安装

  4. 当您在命令提示符窗口中看到类似以下的输出时,代表安装和启动已成功:

    Running on local URL: http://127.0.0.1:7860

【2025最新AI说明书】Windows 系统上安装和配置 Stable Diffusion WebUI_stable-diffusion-webui windows 下如何安装

  1. 此时,打开您的浏览器(推荐使用Chrome或Edge),访问 http://127.0.0.1:7860,即可看到Stable Diffusion WebUI的操作界面。
    【2025最新AI说明书】Windows 系统上安装和配置 Stable Diffusion WebUI_stable-diffusion-webui windows 下如何安装

四、基础配置与优化

为了提升性能和易用性,您可以对 webui-user.bat 文件进行一些简单的配置。

  1. stable-diffusion-webui 文件夹中,右键点击 webui-user.bat 文件,选择 “编辑” (或使用记事本打开)。

  2. 您会看到一行 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

【2025最新AI说明书】Windows 系统上安装和配置 Stable Diffusion WebUI_stable-diffusion-webui windows 下如何安装

  1. 修改完成后,保存并关闭文件。之后每次启动都通过双击 webui-user.bat 来运行。

五、开始您的创作之旅

现在,您已经成功搭建了本地的Stable Diffusion环境。在WebUI界面中:

  1. 选择模型: 在左上角的 “Stable Diffusion checkpoint” 下拉菜单中,确保您下载的模型已被选中。
  2. 输入提示词(Prompt): 在 “txt2img” (文生图) 标签页的 “Prompt” 输入框中,用英文描述您想生成的画面内容。
  3. 点击生成: 点击橙色的 “Generate” 按钮,等待片刻,您的第一张AI作品就会呈现在右侧。

祝您在AI艺术创作的道路上玩得开心!

BUG记录

1、找到并双击运行 webui-user.bat 文件出现Couldn’t launch python
解决方案一,重启电脑

如果安装python中环境变量那里没问题,就重启一下电脑

解决方案二:重新安装Python (最简单、推荐)

这是最直接也是最不容易出错的方法。

  1. 找到您之前下载的Python 3.10.6安装包(文件名类似 python-3.10.6-amd64.exe)。如果找不到了,可以重新下载。

  2. 双击运行安装程序

  3. 您会看到一个\"Modify Setup\"(修改安装)的界面。请确保点击 “Modify”
    【2025最新AI说明书】Windows 系统上安装和配置 Stable Diffusion WebUI_stable-diffusion-webui windows 下如何安装

  4. 在下一个\"Optional Features\"(可选功能)界面,直接点击 “Next”
    【2025最新AI说明书】Windows 系统上安装和配置 Stable Diffusion WebUI_stable-diffusion-webui windows 下如何安装

  5. 现在是最关键的一步! 在 “Advanced Options”(高级选项)界面,务必勾选 “Add Python to environment variables” (将Python添加到环境变量)。如下图所示:
    【2025最新AI说明书】Windows 系统上安装和配置 Stable Diffusion WebUI_stable-diffusion-webui windows 下如何安装

  6. 点击 “Install”,等待安装完成即可。
    【2025最新AI说明书】Windows 系统上安装和配置 Stable Diffusion WebUI_stable-diffusion-webui windows 下如何安装

解决方案三:手动添加环境变量 (适合有一定经验的用户)

如果您不想重新安装,也可以手动将Python路径添加到系统环境变量中。

  1. 找到Python安装路径

    • 如果您是按默认设置安装的,路径通常是:C:\\Users\\您的用户名\\AppData\\Local\\Programs\\Python\\Python310
    • 请注意将 您的用户名 替换为您自己的Windows用户名。AppData 可能是隐藏文件夹,您需要在文件资源管理器的“查看”选项中勾选“隐藏的项目”。
  2. 打开环境变量设置

    • 在Windows搜索栏中搜索“环境变量”,然后选择“编辑系统环境变量”。
    • 在弹出的“系统属性”窗口中,点击“环境变量(N)…”按钮。
  3. 编辑Path变量

    • 在下方的“系统变量(S)”区域,找到名为 Path 的变量,选中它,然后点击“编辑(E)…”。
    • 在“编辑环境变量”窗口中,点击“新建(N)”。
    • 将您的Python安装路径(例如 C:\\Users\\您的用户名\\AppData\\Local\\Programs\\Python\\Python310)粘贴进去。
    • 再次点击“新建(N)”,将Python的 Scripts 路径也添加进去,路径是:C:\\Users\\您的用户名\\AppData\\Local\\Programs\\Python\\Python310\\Scripts
    • 一路点击“确定”保存所有设置。