PyTorch 管理
检查当前 PyTorch 与设备的兼容性,并按自动或手动方案重新安装。
“PyTorch”页会检查实例 Python 中的 Torch 组件、检测到的设备类型,并列出当前 WebUI 支持的安装组合。不同 WebUI、操作系统和硬件看到的选项可能不同。
理解检查结果
| 状态 | 含义 |
|---|---|
| 兼容 | 当前构建符合检测到的设备和 WebUI 规则 |
| 不兼容 | 已安装构建与设备或支持组合不匹配 |
| 未安装 | 实例环境中没有检测到所需 PyTorch 软件包 |
| 无法检查 | Python、管理 API 或环境查询失败 |
页面还会显示 Torch、TorchVision、TorchAudio、xFormers 等已检测版本,以及推荐设备构建。版本名称以页面当前目录为准,不要从其他 WebUI 的教程直接复制安装命令。
重新安装 PyTorch
停止 WebUI
PyTorch 重装会修改正在使用的 Python 环境,因此需要先停止 WebUI。管理 API 会由应用协调,不需要手动结束它。
选择版本方式
普通用户选择“自动选择”,让安装任务根据硬件决定组合。只有明确知道驱动、CUDA、ROCm 或 CPU 需求时才使用“手动选择”。
决定是否强制重装
当前状态已经兼容时,通常不勾选“即使当前版本正确也重新安装”。只有文件损坏、依赖异常或需要重新部署同一构建时才启用。
确认并等待任务
点击“重新安装 PyTorch”,确认后在右下角状态区或任务中心查看依赖下载、安装和环境检查输出。
验证结果
任务完成后刷新本页,确认状态为“兼容”并核对已安装构建,再启动 WebUI 完成实际运行验证。
失败处理
- 自动选择失败时,先检查显卡驱动、操作系统支持和页面报告的检测设备,不要随意尝试多个 CUDA/ROCm 构建。
- 下载或解析软件包失败时,检查网络与代理和镜像。
- 安装后仍不兼容时,打开最近任务输出,记录选择的构建、退出码和环境检查结果。
- 启动时出现 PyTorch 决策窗口,可以取消并回到本页修复;“忽略并启动”只用于你能接受本次运行风险的情况。
重新安装会替换核心依赖
该操作会修改当前实例 Python 中的 PyTorch 及配套软件包。不要同时在实例终端手动安装 Torch,也不要在任务完成前启动 WebUI。