Stable Diffusion 本地部署：常见问题与避坑清单

引言

在人工智能图像生成领域，Stable Diffusion 无疑是一颗璀璨的明星。作为一款开源的文本到图像生成模型，它赋予了创作者前所未有的能力——只需输入一段描述性文字，就能生成令人惊叹的视觉作品。然而，对于许多初学者甚至有一定经验的用户来说，本地部署 Stable Diffusion 的过程往往充满挑战。从环境配置到模型加载，从显存不足到生成效果不佳，各种问题层出不穷。

本文旨在为那些希望在自己的计算机上部署 Stable Diffusion 的用户提供一份详尽的指南。我们将深入探讨部署过程中最常见的陷阱，并提供实用的解决方案。无论你是刚接触 AI 绘画的新手，还是希望优化现有工作流的资深用户，这份清单都将帮助你节省时间、避免挫折，并充分发挥 Stable Diffusion 的潜力。

一、部署前的准备：硬件与软件环境

在开始部署之前，了解你的硬件是否满足要求至关重要。Stable Diffusion 对计算资源的需求较高，尤其是在图形处理单元（GPU）方面。

1.1 硬件要求

避坑提示：不要试图在集成显卡或显存低于 4GB 的 GPU 上运行 Stable Diffusion。即使勉强启动，生成速度也会极为缓慢，而且容易因显存不足而崩溃。如果你只有 AMD 显卡，请特别关注后续关于 AMD 兼容性的章节。

1.2 软件环境

部署 Stable Diffusion 通常需要以下软件：

• Python 3.10.x：这是最稳定且兼容性最好的版本。避免使用 Python 3.11 或更高版本，因为某些依赖库可能尚未完全支持。
• Git：用于克隆代码仓库。
• CUDA 和 cuDNN：NVIDIA 用户需要安装与显卡驱动匹配的 CUDA 工具包。对于大多数现代 GPU，CUDA 11.8 是一个安全的选择。

常见问题：许多用户在安装 Python 时忽略了添加环境变量，导致后续命令无法执行。请务必在安装时勾选“Add Python to PATH”选项。

二、安装过程中的常见陷阱

2.1 选择正确的发行版

Stable Diffusion 有多个发行版，其中最流行的是 Automatic1111 WebUI。这是社区最活跃、功能最全面的版本，也是我们推荐的首选。其他选项如 ComfyUI 和 InvokeAI 各有特色，但 Automatic1111 更适合新手。

避坑提示：不要从非官方渠道下载“整合包”或“一键安装版”。这些版本可能包含恶意软件，或者使用了过时的依赖库，导致后续更新困难。始终从官方 GitHub 仓库克隆最新代码。

2.2 虚拟环境的重要性

许多初学者直接在全局 Python 环境中安装依赖，这会导致版本冲突和系统污染。正确的做法是使用虚拟环境：

python -m venv sd_env
# Windows 激活
sd_env\Scripts\activate
# Linux/Mac 激活
source sd_env/bin/activate

常见问题：激活虚拟环境后，仍然调用全局 Python。这是因为终端未正确识别环境路径。请确保在激活后使用 where python（Windows）或 which python（Linux/Mac）检查路径是否正确。

2.3 依赖安装失败

pip install -r requirements.txt 是安装过程中最常出错的步骤。常见原因包括：

• 网络问题：默认的 PyPI 源在国内访问缓慢。建议更换为清华镜像源：

  pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

• torch 版本不匹配：Stable Diffusion 依赖 PyTorch，而 PyTorch 的 CUDA 版本必须与你的显卡驱动兼容。请访问 PyTorch 官网，使用其提供的命令安装特定版本：

  pip install torch==2.0.1+cu118 torchvision==0.15.2+cu118 --index-url https://download.pytorch.org/whl/cu118

避坑提示：如果安装过程中出现 Microsoft Visual C++ Redistributable 错误，请立即下载并安装最新版本的 Visual C++ 运行库。这是 Windows 用户的常见痛点。

三、模型下载与加载的难题

3.1 基础模型的选择

Stable Diffusion 的基础模型有多种版本，从 v1.4 到 v2.1，再到最新的 SDXL。新手往往不知道如何选择。

• Stable Diffusion 1.5：最广泛兼容的版本，支持大量社区微调模型（Checkpoint）。如果你的硬件资源有限（显存 < 8GB），这是最佳选择。
• Stable Diffusion XL：生成质量更高，但需要更多显存（至少 8GB，推荐 12GB+）。此外，SDXL 的模型文件更大（约 7GB），且需要特定的 VAE 文件。

常见问题：下载模型后，WebUI 无法识别。请确保模型放置在正确的目录：

• 基础模型：models/Stable-diffusion/
• VAE 模型：models/VAE/
• LoRA 模型：models/Lora/

3.2 模型来源的可靠性

CivitAI 是最大的社区模型分享平台，但其中不乏质量参差不齐的作品。下载模型时，请注意以下几点：

• 查看下载量：优先选择下载量超过 10 万次的模型。
• 检查模型类型：确认是 Checkpoint（完整模型）还是 LoRA（轻量级插件）。将 LoRA 当 Checkpoint 使用是常见错误。
• 留意版本兼容性：有些模型只支持 SD 1.5，有些则专为 SDXL 设计。混用会导致生成结果异常。

避坑提示：不要一次性下载大量模型。先选择 2-3 个经过验证的模型，熟悉流程后再扩展。过多模型不仅占用存储空间，还会增加 WebUI 的加载时间。

四、运行时的性能优化与问题排查

4.1 显存不足的解决方案

这是用户遇到最多的问题。当显存不足时，Stable Diffusion 会报错 CUDA out of memory。以下是一些实用的优化方法：

• 降低图像分辨率：从 512x512 开始测试，逐步提高。对于 SDXL，建议从 768x768 开始。
• 使用低精度模式：在 WebUI 的 Settings 中启用 --medvram 或 --lowvram 启动参数。前者将显存占用降低约 30%，后者可降低 50% 但会显著增加生成时间。

• 启用 xformers：这是一个优化的注意力机制实现，可减少显存占用并加速生成。安装方法：

  pip install xformers

  然后在启动参数中添加 --xformers。

常见问题：启用 --lowvram 后，生成速度变得极慢（一张图需要 5 分钟以上）。这是因为模型在 CPU 和 GPU 之间频繁交换数据。如果遇到这种情况，建议升级硬件或使用在线服务。

4.2 生成结果不理想

生成出“鬼图”或不符合预期的图像，通常由以下原因导致：

• 负面提示词（Negative Prompt）缺失：这是新手最容易忽略的部分。负面提示词告诉模型不要生成什么，例如 blurry, low quality, distorted, ugly。合理的负面提示词能显著提升图像质量。
• 采样步数（Steps）设置不当：步数过少（<20）会导致图像模糊，步数过多（>50）则可能过拟合。对于 SD 1.5，20-30 步是黄金区间；对于 SDXL，30-40 步效果最佳。
• CFG Scale 过高：CFG（Classifier-Free Guidance）控制模型对提示词的遵循程度。默认值 7 通常效果最好。过高（>15）会导致图像过度饱和和伪影。

避坑提示：如果你发现生成的图像总是出现重复的图案或奇怪的纹理，请检查是否加载了错误的 VAE 模型。许多用户错误地使用了针对不同版本模型的 VAE。

4.3 启动参数的最佳实践

WebUI 提供了丰富的启动参数，合理配置可以大幅提升使用体验。以下是一个推荐的启动命令示例：

python launch.py --xformers --medvram --no-half-vae --enable-insecure-extension-access

• --xformers：启用优化注意力机制
• --medvram：中等显存模式
• --no-half-vae：防止 VAE 精度损失导致的色彩异常
• --enable-insecure-extension-access：允许安装社区扩展

常见问题：添加 --api 参数后，WebUI 无法正常启动。这通常是因为端口被占用。可以尝试修改端口：--port 7861。

五、高级话题：扩展与自定义

5.1 安装社区扩展

WebUI 的强大之处在于其丰富的扩展生态。常用的扩展包括：

• ControlNet：通过边缘检测、深度图等方式精确控制生成。
• ADetailer：自动修复面部和手部细节。
• Dynamic Thresholding：解决 CFG 过高导致的色彩问题。

避坑提示：不要一次性安装所有扩展。每个扩展都会占用内存和显存，且可能相互冲突。建议逐个安装并测试兼容性。

5.2 使用 LoRA 和 Embedding

LoRA（Low-Rank Adaptation）是一种轻量级的模型微调方法，可以改变生成风格或添加特定角色。使用 LoRA 时，请注意：

• 权重设置：通常建议从 0.5 开始调整。权重过高会导致图像变形。
• 触发词：每个 LoRA 都有特定的触发词（Trigger Word），需要在提示词中明确包含。忘记触发词是常见错误。

六、总结

Stable Diffusion 的本地部署是一场充满挑战但又极具回报的旅程。通过本文的详细指南，我们梳理了从硬件准备到高级优化的各个环节，并揭示了最常见的陷阱和解决方案。

关键要点回顾：

1. 硬件是基础：确保 GPU 显存至少 6GB，并安装正确的 CUDA 版本。
2. 环境隔离：始终使用虚拟环境，避免依赖冲突。
3. 模型选择：从 SD 1.5 入门，根据硬件条件逐步升级到 SDXL。
4. 优化配置：善用 --medvram、--xformers 等启动参数，平衡性能与质量。
5. 社区资源：合理利用 CivitAI 和 GitHub，但保持警惕，避免下载恶意文件。

最后，请记住，Stable Diffusion 是一个不断进化的工具。保持学习的心态，定期更新代码和模型，你将能持续探索 AI 图像生成的无限可能。如果在部署过程中遇到本文未覆盖的问题，建议查阅官方文档或活跃的社区论坛（如 Reddit 的 r/StableDiffusion）。祝你创作愉快！