模型下载失败 | UVR5 中文站

模型下载失败是新手最高频的问题：在软件里点"Download More Models"后一直转圈、进度不动、弹出网络错误，或者下到 99% 卡住。UVR5 的模型托管在境外，网络不稳时很容易失败，但你可以完全绕开软件内下载，手动把文件放好。

UVR5 三大引擎的模型类型不同：MDX-Net 是 onnx 模型，VR Architecture 是 pth 模型，Demucs 是波形域模型。手动下载时认准对应格式即可。

先判断是不是网络问题

现象：下载进度长期为 0 或报错 4xx/5xx、连接超时。
检查：用浏览器能否正常打开境外网站，确认不是本机断网。
处理：换网络环境（如手机热点）重试软件内下载；若仍失败，直接走下面的手动方案。

手动下载与放置步骤

确认模型目录：Windows 在安装目录的 models 下，内含 MDXNET、VR、Demucs 三个子目录；macOS 与 Linux 在软件根目录 models 下。
按模型类型选子目录：onnx 模型放进 MDXNET，pth 模型放进 VR，Demucs 模型放进 Demucs 子目录。
把下载好的模型文件直接复制到对应子目录，保持原始文件名不变。
完全关闭并重新启动 UVR5，软件会在启动时扫描 models 目录并加载新模型。
回到主界面下拉列表，确认目标模型已经出现。

手动下载去哪里找

官方模型清单与下载入口在 UVR5 的 GitHub 仓库说明里列明，可对照需要的模型名逐项获取。
也可通过社区镜像或论坛整理的集合包获取，下载后核对文件大小与文件名是否和官方一致。
注意只下载与当前 v5.6 版本匹配的模型，老版本模型可能不被新引擎识别。

常见坑

文件名被浏览器改成 .zip 或加 (1) 后缀，导致软件识别不了，手动改回原始后缀。
把 onnx 错放进 VR 目录，列表里自然看不到，对照上面的类型表重放。
下载的是压缩包却没解压，需要把里面的模型文件取出再放目录。

兜底方案

若手动下载也受制于网络，可请网络条件允许的朋友代下并传输文件，或用离线安装镜像。模型就位后，若列表仍为空，转到「模型列表为空」继续排查。

下一步建议

各引擎模型从哪获取

MDX-Net 系列：UVR-MDX-NET Main、Inst Main、Inst 3、Inst HQ、Kim 系列，都是 onnx 文件，放 MDXNET 子目录。
VR Architecture 系列：UVR-DeEcho-DeReverb（去混响去回声）、7_HP2、UVR-DeNoise（降噪）、BVE 系列，都是 pth 文件，放 VR 子目录。
Demucs 系列：htdemucs、htdemucs_ft（四轨质量更高）、htdemucs_6s（六轨含吉他钢琴），放 Demucs 子目录。

手动下载时务必对照上面的引擎与后缀，把文件放进对应子目录，否则软件扫描不到。下载源以 UVR5 官方 GitHub 仓库列出的清单为准，社区镜像仅作为网络受限时的补充。文件名保持官方原始命名，不要自行改名或加版本号，避免索引混乱。下载完成后先在文件管理器里确认大小合理，再复制进目录。

放好之后的确认动作

放完模型不要急着在软件里找，先完全退出 UVR5，再重新打开，软件只在启动时扫描 models 目录。重启后若仍未出现，回到本页常见坑逐项核对，不要反复复制粘贴同一个文件。网络恢复后，也可以回头试试软件内的"Download More Models"，有时比手动找更省心。

模型放好后务必重启软件再确认。如果重启后列表还是空的，问题多半在目录层级或文件后缀，去看「模型列表为空」那页的逐条核对。