Windows 环境 AMD 显卡安装 stable-diffusion-webui

共计 3382 个字符，预计需要花费 9 分钟才能阅读完成。

安装步骤

在 Windows 环境下，需要对 Linux/macOS 命令进行调整，主要是：

source venv/bin/activate → venv\Scripts\activate
export TORCH_COMMAND=... → 直接在命令行执行 set TORCH_COMMAND=... 或者在 Python 命令中嵌入 pip install 语句
python3 → python（Windows 默认用 python）

Windows 版安装步骤（适用于 PowerShell 或 cmd）：

# 克隆项目
git clone https://github.com/AUTOMATIC1111/stable-diffusion-webui
cd stable-diffusion-webui
# 创建虚拟环境
python -m venv venv
# 激活虚拟环境（PowerShell）
venv\Scripts\Activate
# 若使用 cmd，请使用以下命令：
# venv\Scripts\activate.bat
# 更新 pip 和 wheel
python -m pip install --upgrade pip wheel
# 安装 PyTorch（针对 ROCm5.1.1，适用于 AMD 显卡）
pip install torch torchvision --extra-index-url https://download.pytorch.org/whl/rocm5.1.1
# 启动 WebUI
python launch.py --precision full --no-half

在以后运行时，只需要执行：

cd stable-diffusion-webui
# 可选：更新代码库
git pull
# 重新激活虚拟环境
venv\Scripts\Activate
# 启动 WebUI
python launch.py --precision full --no-half

说明

venv\Scripts\Activate 适用于 PowerShell，如果使用 cmd，则执行 venv\Scripts\activate.bat
–precision full –no-half 主要用于 AMD 显卡，NVIDIA 显卡通常不需要
如果你使用 CUDA（NVIDIA 显卡），建议改为：

pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu121

然后再运行

python launch.py

问题解决

(venv) PS F:\github\stable-diffusion-webui> python launch.py --precision full --no-half
=============================================================================================================================
INCOMPATIBLE PYTHON VERSION

This program is tested with 3.10.6 Python, but you have 3.13.1.
If you encounter an error with "RuntimeError: Couldn't install torch." message,
or any other error regarding unsuccessful package (library) installation,
please downgrade (or upgrade) to the latest version of 3.10 Python
and delete current Python and "venv" folder in WebUI's directory.

You can download 3.10 Python from here: https://www.python.org/downloads/release/python-3106/

Alternatively, use a binary release of WebUI: https://github.com/AUTOMATIC1111/stable-diffusion-webui/releases/tag/v1.0.0-pre

Use --skip-python-version-check to suppress this warning.
=============================================================================================================================
Python 3.13.1 (tags/v3.13.1:0671451, Dec  3 2024, 19:06:28) [MSC v.1942 64 bit (AMD64)]
Version: v1.10.1
Commit hash: 82a973c04367123ae98bd9abdf80d9eda9b910e2
Traceback (most recent call last):
  File "F:\github\stable-diffusion-webui\launch.py", line 48, in 
    main()
    ~~~~^^
  File "F:\github\stable-diffusion-webui\launch.py", line 39, in main
    prepare_environment()
    ~~~~~~~~~~~~~~~~~~~^^
  File "F:\github\stable-diffusion-webui\modules\launch_utils.py", line 387, in prepare_environment
    raise RuntimeError(
    ...<2 lines>...
    )
RuntimeError: Torch is not able to use GPU; add --skip-torch-cuda-test to COMMANDLINE_ARGS variable to disable this check

问题主要有两个：
Python 版本过高（3.13.1），但 Stable Diffusion WebUI 需要 Python 3.10.6。
Torch 无法使用 GPU，可能是 CUDA/ROCm 版本不兼容或未正确安装。

解决方案

第一步：降级 Python

卸载当前 Python 3.13.1

在 控制面板 > 程序和功能 中找到 Python 3.13.1，然后卸载它。

或者在 PowerShell 执行：

winget uninstall Python

安装 Python 3.10.6
直接下载 Python 3.10.6 官方安装包：Python 3.10.6 下载
安装时 勾选 “Add Python to PATH” 选项。
验证 Python 版本
重新打开 PowerShell，输入：

python --version

确保输出 Python 3.10.6。

第二步：删除并重建虚拟环境

你的 venv 目录是基于 Python 3.13.1 创建的，所以需要删除并重新创建：
# 删除旧的 venv 目录

rm -r -fo venv

# 重新创建虚拟环境

python -m venv venv

# 激活虚拟环境

venv\Scripts\Activate

第三步：重新安装依赖

python -m pip install --upgrade pip wheel
pip install torch torchvision --index-url https://download.pytorch.org/whl/cu121  # CUDA 12.1 适用于 NVIDIA

如果你用的是 AMD GPU（ROCm），执行：

pip install torch torchvision --extra-index-url https://download.pytorch.org/whl/rocm5.1.1

第四步：启动 WebUI

尝试运行：

python launch.py --precision full --no-half

如果仍然报 Torch is not able to use GPU，则使用：

set COMMANDLINE_ARGS=--skip-torch-cuda-test
python launch.py --precision full --no-half