安装Stable Diffusion报错怎么办

安装 Stable Diffusion（通常指 SD WebUI / ComfyUI 等本地部署版本）报错非常常见，多数和环境、显卡驱动、依赖、网络有关。你可以按下面思路一步步排查，也可以把完整报错截图/文字发给我，我帮你精准定位。

一、先确认基础环境（最常见问题）

1. 显卡 & 驱动

• NVIDIA 显卡：必须装 CUDA 驱动
• 查看驱动版本：

nvidia-smi

• 没显示说明驱动没装好
• AMD / 核显：
• 只能用 CPU 或 DirectML（速度很慢）
• macOS：
• 仅支持 M 系列芯片，且只能用 torch 的 MPS 版本

2. Python 版本（非常重要）

Stable Diffusion 对 Python 版本很敏感：

• ✅ 推荐：Python 3.10
• ❌ 不推荐：3.11+ 或 3.8 以下

查看版本：

python --version

二、不同安装方式的常见报错 & 解决

✅ 情况 1：git clone 后运行 webui-user.bat 报错

常见错误：

• Torch not compiled with CUDA
• Could not find a version
• No module named xxxx

解决步骤：

1. 删除并重建虚拟环境
2. 手动指定 Python：

set PYTHON=python3.10

1. 使用官方推荐启动参数：

webui-user.bat --skip-torch-cuda-test --precision full --no-half

✅ 情况 2：依赖安装失败（网络问题）

典型报错：

• Connection timed out
• ReadTimeoutError

解决办法：

• 使用国内镜像：

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

• 或设置全局：

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

✅ 情况 3：显存不足（OOM）

报错示例：

• CUDA out of memory

解决：

• 加启动参数：

--medvram
--lowvram
--xformers

• 模型用：
• sd-v1-5-pruned
• 不要用 fp16 full

✅ 情况 4：ComfyUI 报错

常见问题：

• 节点缺失
• torch version mismatch

建议：

• 用官方 embedded python
• 不要混用 pip 和 conda

三、快速自检清单 ✅

你可以对照：

• [ ] 显卡是 NVIDIA？
• [ ] 驱动正常（nvidia-smi 有输出）？
• [ ] Python 是 3.10？
• [ ] 用的是官方仓库？
• [ ] 网络能访问 GitHub / PyPI？

四、你可以直接这样发我信息（最快解决）

请把以下任一内容发我：

1. 完整报错截图
2. 或复制报错文字
3. 说明：

• 用的哪种（WebUI / ComfyUI）
• 系统（Win / Linux / Mac）
• 显卡型号
• Python 版本

我可以直接告诉你是哪一行出错 + 怎么改。