Stable Diffusion WebUI 安装指南涵盖 Windows 与 Mac 系统。Windows 提供整合包与手动安装两种方案，Mac 需通过 Homebrew 配置环境。核心依赖 Python 与 Git，推荐 NVIDIA 显卡以获得最佳渲染速度。常见问题包括路径含中文、驱动未更新及显存不足等，可通过检查环境变量、更新驱动及合理分配模型解决。本文详述了从环境搭建到启动运行的完整流程及故障排查思路，包含模型存放位置与扩展插件管理方法。
Stable Diffusion 的本地部署其实并不困难，只需简单配置环境，几分钟即可完成。无论是 Windows 还是 macOS 系统，本文都将详细介绍各种安装方式及常见问题解决方案。
Stable Diffusion 最早开源时仅包含源代码，最具代表性的是 AUTOMATIC1111 大神将其封装为基于浏览器网页运行的程序（WebUI）。该程序允许用户直观地调整参数、输入提示词并加载拓展插件，是目前最流行的本地 AI 绘画工具之一。
Stable Diffusion WebUI 基于 Python 搭建，因此需要在电脑上正确配置 Python 环境。此外，项目托管在 GitHub 上，通过 Git 可以将 Stable Diffusion 及其插件安装和更新同步到本地电脑。
虽然 Windows 和 Mac 都能安装，但 Mac 电脑通常使用 CPU 渲染，速度较慢。推荐搭配 NVIDIA 显卡的 Windows 电脑以获得最佳性能。
| 推荐配置（Win10 以上系统） |
|---|
| CPU：无硬性要求 |
| 显卡：RTX 2060 6GB 显存以上（建议 8GB 或以上） |
| 内存：8GB 以上（建议 16GB 或以上） |
| 硬盘：20—100GB 空余空间 |
优点：安装简单方便，一键启动，自动更新，自带部分模型和必要插件，无需手动安装 Python 等前置软件。 缺点：可能集成不需要的插件，偶尔出现兼容性问题。
市面上推荐的整合包主要有秋葉 aaaki 和独立研究员 - 星空的整合包，两者内核一致，区别在于封装界面和集成插件。新手推荐使用秋葉老师的整合包；使用 AMD 显卡、集成显卡或配置较低的用户推荐安装星空老师的整合包。
安装步骤：
sd-webui-aki-v4.x 文件夹，点击'A 启动器'。AMD 显卡特别说明： 基于特定分支制作的整合包功能与 v4.4 版本相同。首次使用打开启动器后，在启动器设置 - 高级选项中修改生成引擎，选择 A 卡。若启动后提示缺少某些组件，对于 A 卡而言通常是正常的。
优点：最纯正的 WebUI 程序，可按需安装插件，便于排查问题根源。 缺点：流程繁琐，需自行寻找模型和插件。
建议安装 3.10.6 版本，这是 WebUI 作者推荐的稳定版本。下载安装时，务必勾选 Add Python 3.10 to PATH，确保环境变量生效。
访问 Git 官网 https://git-scm.com/，下载 64-bit Git Windows Setup 安装包。安装过程中一路点击 Next 即可。
在硬盘空间充足且无中文路径的文件夹中，右键点击空白处选择'在此处打开 PowerShell 窗口'或 CMD，复制以下代码回车：
git clone https://github.com/AUTOMATIC1111/stable-diffusion-webui.git
等待克隆完成，进入 stable-diffusion-webui 文件夹，双击 webui-user.bat。脚本将自动安装必要的启动项，完成后在浏览器打开 http://127.0.0.1:7860 即可使用。
按下 Cmd + Space 搜索终端，打开终端后粘贴以下代码回车：
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"
按提示操作（有 1 选 1，有 Y 选 Y），输入开机密码（输入时不显示字符）。当询问 core cask services 时可回车跳过。安装完成后，输入 brew -v 查询版本号确认成功。
在终端输入以下命令安装依赖：
brew install cmake protobuf rust [email protected] git wget
安装完毕后，输入 python3 -V 确认版本信息已返回。
在需要安装的目录上右键，选择'在终端中打开'（或在访达界面按 Cmd + Option + P 调出导航栏后右键），输入以下代码：
git clone https://github.com/AUTOMATIC1111/stable-diffusion-webui.git
安装完毕后，再次在该文件夹上右键终端打开，输入如下命令启动：
./webui.sh
Mac 安装划重点：
brew -v 能返回版本号。python3 -V 能返回版本。由于设备差异和环境不同，安装过程中可能会遇到各种问题，以下是常见解决思路：
stable-diffusion-webui 安装路径尽量简单，不要包含任何中文字符，否则可能导致模块加载失败。.ckpt 或 .safetensors 后缀的模型文件，放置于 stable-diffusion-webui/models/Stable-diffusion/ 目录下。webui-user.bat 中添加 --xformers 或 --medvram 参数以优化显存占用。pip install --upgrade pip。models/Stable-diffusion/models/Lora/extensions/sd-webui-controlnet/models/models/VAE/在 WebUI 界面点击'扩展'选项卡，进入'可用'页面，搜索所需插件（如 ControlNet, Ultimate SD Upscale 等），点击 Install 安装后重启 WebUI 即可生效。
Stable Diffusion 的安装核心在于 Python 环境与 Git 的正确配置。Windows 用户可根据硬件情况选择整合包或手动安装，Mac 用户需注意 Homebrew 环境的搭建。遇到问题时，优先检查路径是否含中文、驱动是否更新以及显存是否足够。随着技术迭代，建议定期更新 WebUI 源码以获取最新功能和修复。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
使用加密算法（如AES、TripleDES、Rabbit或RC4）加密和解密文本明文。 在线工具，加密/解密文本在线工具，online
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具，curl 转代码在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online