【Stable Diffusion安装及常见问题】详细安装步骤及问题解决方案

08 Apr 2026 — 6 min read

Stable Diffusion（SD）可以在多种操作系统上运行，其中主流选择是Windows，但macOS和Linux也都有成熟的方案，不同系统的体验和要求差别不小，这里以Windows系统为例，其他操作系统可以参考官方运行说明，按要求配置

一、安装过程

后续安装需要使用git拉取Stable Diffusion的官方仓库文件，使用git拉取相比于下载zip可以通过修改运行文件实现每次运行时自动更新最新版本

（1）访问下方连接，下载git安装包

（2）下载完成后运行执行程序，选项保持默认即可

Stable Diffusion 依赖 Python，是因为其核心框架（如 PyTorch）、模型库（如 diffusers）、用户界面（如 WebUI）及整个 AI 生态都构建在 Python 之上，Python 是连接模型、工具与用户的唯一高效通用语言

官方运行文档说明中指定使用Python3.10.6版本，最新版本不支持torch

另外系统只允许安装Python3.10.x一个版本，如果已经有3.10.x其他版本建议卸载更换3.10.6，否则后续运行Stable Diffusion会出现问题

（1）访问下方链接进行下载

（2）运行执行程序，一定要勾选Add python.exe to path ,选择自定义安装

注：确定好安装路径，不要随意更改python路径上的文件夹命名或者移动位置，否则需要重新配置环境变量，如果一定要改路径建议卸载后重新安装

卸载可以找到安装的执行文件打开进行卸载

(1)访问GitHub官方仓库（需要翻墙）

（2）复制完链接后，在想安装位置的文件夹下运行CMD

输入git clone 复制的网址，回车

（3）下载完成后，关闭CMD，下载需要的model

Hugging face网站（需要翻墙）下载model,根据自己需求选择对应模型下载，这里我选择一个小一些的基础模型（根据自己电脑配置和需求进行选择）

（4）下载完成后，将下载的model文件移动到指定路径，不然运行时Stable Diffusion识别不到

D:\刚才下载运行CMD的文件夹\stable-diffusion-webui-master\models\Stable-diffusion

（5）在D:\刚才下载运行CMD的文件夹\stable-diffusion-webui-master路径下找到webui-user.bat文件，右键更多选项编辑

在顶部添加git pull，这样可以保证Stable Diffusion文件是最新的，保存文件

（6）双击运行webui-user.bat文件，第一次打开会自动下载需要的文件（需要翻墙），下载时可能会遇到网络问题，后面解决方案会展示如何使用国内镜像

（7）等待安装完成后，复制标红位置的地址，使用浏览器访问即可

安装时需要翻墙且保证网络环境稳定，如果如果遇到网络问题安装失败，可以参考下面解决方案使用国内镜像安装

在Stable Diffusion安装的文件夹里面找到launch.py文件，右键以记事本方式打开，下滑找到git+https://在加号后面加上标红的部分，保存后重新运行webui-user.bat文件即可

使用浏览器打开后可能会弹出报错，一般是模型加载失败 / 模型文件损坏 / webui 没下载成功模型导致的

（1）首先在存放model的文件夹目录下删除元原模型，重新下载替换之后重新运行（可以选中model文件右键属性检查文件大小与下载是大小是否一致，若大小差异过大，可能是文件损坏，需要按照上面步骤重新下载model文件替换）

（2）可能是WebUI 前端网页缓存没有删除，尝试关闭浏览器所有扩展（尤其是翻译扩展），打开浏览器Ctrl + Shift + N无痕访问地址

（3）若前两点无法解决问题，可能是WebUI 前端网页跟后台Python程序失去连接导致

很大可能是因为Python版本不兼容！！！官方文档中使用3.10.6版本

现在需要卸载之前的Python3.10.x和删除Stable Diffusion文件夹（重新下载Stable Diffusion是因为修改Python版本后，重新运行原来的Stable Diffusion不会自动更改新安装的Python版本），重新按照步骤进行安装配置