部署 Stable Diffusion WebUI 时，Python 3.10 是目前兼容性最稳定的版本，Python 3.11 虽可用但部分扩展插件可能报错。建议生产环境或新手优先选择 Python 3.10.6，仅在确认所需插件支持 Python 3.11 时才升级。

命令速用版

创建 Python 3.10 虚拟环境并安装基础依赖的命令如下，适用于 Windows 和 Linux 系统。

python -m venv venv
venv\Scripts\activate
pip install torch torchvision torchaudio `--index-url` https://download.pytorch.org/whl/cu118

如果使用 Python 3.11，需确保 PyTorch 版本支持该解释器，否则安装过程会报错。

为什么会这样

核心原因是 PyTorch 和关键加速库 xformers 对 Python 版本有特定编译依赖。Stable Diffusion WebUI 项目早期文档明确推荐 Python 3.10.6，因为当时 Python 3.11 的二进制 wheel 包支持不完善。

公共资料中没有看到可靠的量化数据证明 Python 3.11 在推理速度上有显著优势，但兼容性成本更高。部分自定义节点或插件硬编码了 Python 版本检查，导致在 3.11 环境下无法加载。

分步处理

按照以下步骤检查并配置正确的 Python 环境，确保依赖安装成功。

1. 检查当前 Python 版本：在终端输入 python `--version`，确认显示 3.10.x 或 3.11.x。

2. 清理旧环境：如果之前安装失败，删除项目目录下的 venv 文件夹和 requirements.txt 生成的缓存文件。

3. 重新创建环境：使用指定版本的 Python 解释器路径运行 venv 创建命令，避免调用系统默认 Python。

4. 安装依赖：运行 WebUI 自带的启动脚本或手动执行 pip install -r requirements.txt，观察是否有版本冲突警告。

怎么验证是否生效

启动 WebUI 后检查控制台日志，确认没有 ImportError 或 ModuleNotFoundError 报错。

1. 观察启动日志：查找 Version: torch x.x.x 行，确认 torch 版本已正确加载。

2. 测试插件加载：在界面扩展标签页查看已安装插件状态，红色标记通常表示兼容性失败。

3. 生成测试图：执行一次 txt2img 生成，确认 CUDA 加速正常且无显存溢出异常。

常见坑

路径包含中文字符或空格会导致 pip 安装依赖失败，建议项目路径全英文。Python 多版本共存时，环境变量 PATH 优先级错误会调用错解释器。部分插件依赖特定 CUDA 版本，与 Python 版本无关但常同时报错。

常见问题

Python 3.12 能部署 Stable Diffusion 吗？

目前不建议使用 Python 3.12，主流插件和 PyTorch 稳定版尚未完全适配。

如何从 Python 3.11 降级到 3.10？

必须删除现有虚拟环境文件夹，安装 Python 3.10 后重新创建 venv 并安装依赖。

报错 ModuleNotFoundError: No module named 'torch' 怎么办？

检查当前激活的虚拟环境是否对应正确的 Python 版本，重新运行 pip install torch。

参考来源

1. AUTOMATIC1111/stable-diffusion-webui GitHub 仓库 README 文档

2. PyTorch 官方安装指南 (pytorch.org)