Mac 系统下 Stable Diffusion WebUI 安装与使用入门教程

随着人工智能技术的发展，Stable Diffusion（SD）已成为生成高质量图像的主流工具之一。在 macOS 环境下本地部署 Stable Diffusion WebUI，不仅能保护数据隐私，还能灵活调整参数进行创作。本文将详细介绍从环境准备到模型使用的完整流程，并针对 Mac 设备特性提供优化建议。

一、环境准备

在开始安装之前，请确保您的 Mac 系统已满足以下基础要求：

操作系统：macOS 12.3 或更高版本（推荐 macOS Ventura 或 Sonoma）
Python 版本：建议 Python 3.10 及以上
依赖工具：Rust, CMake, Git, Wget

1. 安装基础依赖

打开终端（Terminal），使用 Homebrew 安装必要的开发工具。如果未安装 Homebrew，请先前往官网安装。

brew install cmake protobuf rust [email protected] git wget

注意：部分网络环境可能需要配置代理才能顺利下载依赖包。

2. 克隆 WebUI 项目

进入目标目录，克隆官方推荐的 AUTOMATIC1111 版本的 Stable Diffusion WebUI 代码库。

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

二、启动与优化（Mac 专用）

Mac 设备通常搭载 Apple Silicon 芯片（M1/M2/M3），默认情况下可能无法充分利用 GPU 加速。为了获得更好的性能，建议在启动脚本中添加 MPS（Metal Performance Shaders）支持。

1. 标准启动方式

首次运行会自动下载所需模型和依赖，请耐心等待。

./webui.sh

2. 启用 MPS 加速（推荐）

对于 M 系列芯片用户，添加 --use-cpu all 或 --medvram 等参数可优化显存占用。若遇到启动慢的问题，可尝试以下命令：

export PYTORCH_ENABLE_MPS_FALLBACK=1
./webui.sh --no-gradio-queue

说明：--no-gradio-queue 用于解决部分代理环境下 Gradio 队列报错问题。

启动成功后，浏览器将自动打开本地地址（通常为 http://127.0.0.1:7860），即进入 WebUI 操作界面。

三、模型下载与管理

WebUI 本身不包含预训练的大模型，需要手动下载模型文件放入指定目录。

1. 模型存放路径

将下载的模型文件复制到以下目录中：

stable-diffusion-webui/models/Stable-diffusion/

2. 模型来源

常见的模型托管平台包括 Civitai、Hugging Face 等。选择模型时请注意查看其支持的分辨率和风格类型。

Checkpoint 模型：主模型文件，后缀通常为 .safetensors 或 .ckpt。
LoRA 模型：用于微调特定风格或人物，需配合主模型使用。

3. 加载模型

复制模型文件后，刷新 WebUI 页面。
在左上角下拉菜单中选择刚导入的模型。
等待加载完成即可开始生成。

四、基础参数配置

理解核心参数是掌握 SD 的关键。以下是常用参数的详细说明：

参数名称	说明	建议值
Prompt (提示词)	描述你想要生成的画面内容	英文为主，关键词用逗号分隔
Negative Prompt (负向提示词)	描述你不希望出现的元素	如：ugly, bad anatomy, low quality
Steps (采样步数)	生成图片的计算迭代次数	20-50 步，过高收益递减
CFG Scale (提示词相关性)	AI 遵循提示词的程度	7-9 之间效果较佳
Sampler (采样器)	图像生成算法	Euler a, DPM++ 2M Karras 等
Width/Height	输出图片尺寸	512x512, 768x512 等

1. 文本转图像 (Text to Image)

这是最常用的功能。在左侧输入框填写 Prompt，点击 Generate 按钮即可生成图片。

2. 高清修复 (Hires. Fix)

如果生成的图片分辨率较低，可以开启 Hires. Fix 进行放大处理。但此功能会显著增加显存消耗，低配 Mac 建议关闭。

五、常见问题排查

1. 内存不足 (OOM Error)

现象：生成过程中程序崩溃，提示 Out of Memory。 解决方案：

降低图片分辨率（如改为 512x512）。
减少 Steps 步数。
关闭 Hires. Fix。
在启动参数中添加 --medvram 或 --lowvram。

2. 代理导致连接错误

现象：启动时报错 Error Expecting value: line 1 column 1 (char 0)。 解决方案：

检查网络代理设置。
使用 --no-gradio-queue 参数启动。
尝试切换为美国节点或其他稳定线路。

3. 模型加载失败

现象：模型列表中没有显示新下载的模型。 解决方案：

确认文件路径是否正确（models/Stable-diffusion）。
检查文件格式是否为 .safetensors 或 .ckpt。
重启 WebUI 服务。

六、进阶技巧

1. 扩展插件

WebUI 支持丰富的扩展插件，可通过 Extensions 标签页安装。常用的有 ControlNet（控制构图）、ADetailer（面部修复）等。

2. 批量生成

利用 Batch Process 功能，可以一次性生成多张不同随机种子（Seed）的图片，便于筛选最佳结果。

3. 工作流保存

在 Settings 中开启 Save settings，可以将当前配置保存为配置文件，方便后续快速恢复环境状态。

七、总结

本文涵盖了 Stable Diffusion WebUI 在 macOS 上的安装、配置及基础使用方法。通过合理调整参数和优化硬件资源，即使是消费级笔记本也能流畅运行。随着技术的迭代，SD 生态仍在不断扩展，建议关注官方更新日志以获取最新功能支持。