PythonAI算法
Mac 系统下 Stable Diffusion WebUI 安装与使用入门教程
本文介绍在 macOS 环境下部署 Stable Diffusion WebUI 的完整流程。涵盖环境依赖安装、WebUI 克隆与启动、模型下载与管理、基础参数配置及常见报错处理。通过本教程，用户可快速掌握本地生成 AI 图像的核心操作，解决内存不足、代理冲突等常见问题，实现从文本到图像的自动化创作。重点包含 Apple Silicon 芯片的 MPS 加速配置及常用参数详解。
本文介绍在 macOS 环境下部署 Stable Diffusion WebUI 的完整流程。涵盖环境依赖安装、WebUI 克隆与启动、模型下载与管理、基础参数配置及常见报错处理。通过本教程，用户可快速掌握本地生成 AI 图像的核心操作，解决内存不足、代理冲突等常见问题，实现从文本到图像的自动化创作。重点包含 Apple Silicon 芯片的 MPS 加速配置及常用参数详解。
随着人工智能技术的发展，Stable Diffusion（SD）已成为生成高质量图像的主流工具之一。在 macOS 环境下本地部署 Stable Diffusion WebUI，不仅能保护数据隐私，还能灵活调整参数进行创作。本文将详细介绍从环境准备到模型使用的完整流程，并针对 Mac 设备特性提供优化建议。
在开始安装之前，请确保您的 Mac 系统已满足以下基础要求：
打开终端（Terminal），使用 Homebrew 安装必要的开发工具。如果未安装 Homebrew，请先前往官网安装。
brew install cmake protobuf rust [email protected] git wget
注意：部分网络环境可能需要配置代理才能顺利下载依赖包。
进入目标目录，克隆官方推荐的 AUTOMATIC1111 版本的 Stable Diffusion WebUI 代码库。
git clone https://github.com/AUTOMATIC1111/stable-diffusion-webui
cd stable-diffusion-webui
Mac 设备通常搭载 Apple Silicon 芯片（M1/M2/M3），默认情况下可能无法充分利用 GPU 加速。为了获得更好的性能，建议在启动脚本中添加 MPS（Metal Performance Shaders）支持。
首次运行会自动下载所需模型和依赖，请耐心等待。
./webui.sh
对于 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 本身不包含预训练的大模型，需要手动下载模型文件放入指定目录。
将下载的模型文件复制到以下目录中：
stable-diffusion-webui/models/Stable-diffusion/
常见的模型托管平台包括 Civitai、Hugging Face 等。选择模型时请注意查看其支持的分辨率和风格类型。
.safetensors 或 .ckpt。理解核心参数是掌握 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 等 |
这是最常用的功能。在左侧输入框填写 Prompt，点击 Generate 按钮即可生成图片。
如果生成的图片分辨率较低，可以开启 Hires. Fix 进行放大处理。但此功能会显著增加显存消耗，低配 Mac 建议关闭。
现象：生成过程中程序崩溃，提示 Out of Memory。 解决方案：
--medvram 或 --lowvram。现象：启动时报错 Error Expecting value: line 1 column 1 (char 0)。
解决方案：
--no-gradio-queue 参数启动。现象：模型列表中没有显示新下载的模型。 解决方案：
WebUI 支持丰富的扩展插件，可通过 Extensions 标签页安装。常用的有 ControlNet（控制构图）、ADetailer（面部修复）等。
利用 Batch Process 功能，可以一次性生成多张不同随机种子（Seed）的图片，便于筛选最佳结果。
在 Settings 中开启 Save settings，可以将当前配置保存为配置文件，方便后续快速恢复环境状态。
本文涵盖了 Stable Diffusion WebUI 在 macOS 上的安装、配置及基础使用方法。通过合理调整参数和优化硬件资源，即使是消费级笔记本也能流畅运行。随着技术的迭代，SD 生态仍在不断扩展，建议关注官方更新日志以获取最新功能支持。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 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