Stable Diffusion 本地部署与常见问题解决方案

编辑 ~/.bash_profile 追加：

alias python="/usr/local/bin/python3"
alias python2="/usr/bin/python"

生效命令：

source ~/.bash_profile

2. Torch 版本不匹配

报错提示 No SDP backend available 或 Torch not compiled with CUDA enabled 通常是因为 PyTorch 版本过低。

修改 webui-macos-env.sh 中的 TORCH_COMMAND：

export TORCH_COMMAND="pip install torch==2.0.1 torchvision==0.15.2"

并在 COMMANDLINE_ARGS 中添加 --reinstall-torch 强制重装。

3. OpenCV 依赖问题

报错 Symbol not found: _VTRegisterSupplementalVideoDecoderIfAvailable 表明 OpenCV 版本过旧。

在虚拟环境中升级：

cd venv/bin
source activate
python3.10 -m pip install --upgrade pip
pip3 install opencv-python==4.6.0.66
deactivate

4. 显存不足或精度错误

报错 LayerNormKernelImpl not implemented for 'Half' 通常因显存不足导致半精度计算失败。

解决方法是强制使用全精度浮点运算：

./webui.sh --precision full --no-half

或在配置文件中添加：

export COMMANDLINE_ARGS="--precision full --no-half --skip-torch-cuda-test"

五、进阶优化与扩展

1. 模型管理

除了基础 Checkpoint 模型，还可以加载 LoRA 和 VAE 文件。

• LoRA：放入 models/Lora 目录，用于微调风格。
• VAE：放入 models/VAE 目录，用于改善色彩还原。

2. 常用插件

WebUI 支持丰富的插件生态，推荐安装以下插件以提升效率：

• ControlNet：通过参考图控制生成结构。
• ADetailer：自动修复人脸细节。
• Ultimate SD Upscale：高清放大图片。

安装方法通常在 WebUI 界面的 Extensions -> Install from URL 中输入插件地址即可。

3. 提示词编写

高质量的提示词（Prompt）是生成理想图像的关键。建议包含主体描述、风格修饰、画质增强词（如 masterpiece, best quality）。负面提示词（Negative Prompt）可用于排除不想要的元素，如 low quality, blurry。

六、总结

本地部署 Stable Diffusion 虽然对硬件有一定要求，但提供了最大的灵活性和隐私保护。通过合理配置环境参数、选择合适的模型以及利用扩展插件，用户可以显著提升生成效果。遇到报错时，优先检查 Python 和 PyTorch 版本兼容性，并根据硬件资源调整精度设置。