模型列表为空 | UVR5 中文站

模型列表为空指的是：你已经把模型文件放进文件夹，但软件主界面的引擎下拉列表里却看不到对应模型，或者干脆一片空白。这通常不是下载问题，而是"放错了位置"或"软件没重新扫描"，按下面几项逐一核对。

UVR5 在启动时会扫描安装目录（Windows）或软件根目录（macOS/Linux）下 models 目录里的 MDXNET、VR、Demucs 三个子目录，只有放进正确子目录、后缀正确的文件才会被加载。

核对一：目录层级

Windows：模型必须放在"安装目录/models/MDXNET（或 VR、Demucs）"里，不能只放在 models 根目录。
macOS / Linux：放在软件根目录的 models 下对应子目录。
常见错误：把文件堆在 models 外面，或自建了一层多余文件夹（如 models/mymodels/UVR-MDX-NET Main.onnx），多嵌套一层就扫不到。

核对二：文件后缀与格式

MDX-Net 模型应是 .onnx 结尾；VR 模型是 .pth 结尾；Demucs 模型按官方文件名。
浏览器下载常把 .onnx 误存成 .onnx.zip 或加 (1)，需在文件管理器里改成正确后缀。
确认文件不是"下载未完成"的临时文件（大小异常小），重新下完整再放。

核对三：重启时机

放好文件后必须完全退出 UVR5 再重新打开，软件只在启动时扫描，运行中放文件不会自动出现。
如果开着软件时复制文件，请关闭后重开，不要指望实时刷新。

核对四：命名冲突

同名文件或同名不同后缀可能让软件索引混乱。若发现列表里有重复或异常的条目，清理掉重复文件，保留官方原始命名的一份，再重启加载。命名冲突尤其容易发生在多次下载同一模型的不同版本时，保留最新一份即可。

兜底方案

以上都核对无误仍为空，可删除软件目录下的模型索引缓存（如有）强制重建，或重装到新目录后重新放置模型。仍不行时，记录你的目录结构截图与文件后缀，准备求助。

下一步建议

用文件管理器肉眼复核

打开安装目录下的 models，逐层展开 MDXNET、VR、Demucs，确认模型真的在子目录里，而不是停在 models 根目录。
在文件管理器里开启"显示文件扩展名"，看清后缀是否被改成了 .onnx.zip 之类，及时修正。
留意文件大小，正常模型从几 MB 到上百 MB 不等，只有几 KB 的多是下载失败的残片。

很多"列表为空"的求助，最后发现只是文件放错了一层目录，或后缀被浏览器偷偷改了。用上面的三步肉眼复核，往往一分钟就能定位。确认无误再重启，不要频繁重启浪费时间。如果重启多次仍不出现，尝试把该模型单独放到新建的测试子目录，排除其他文件干扰，再逐步加回其余模型。

索引缓存的强制重建

少数情况下软件会缓存上一次的模型索引，导致新放的模型不被识别。可尝试删除软件目录下的模型索引缓存文件（如有），让软件下次启动时强制重新扫描整个 models 目录。操作前先确认删的是缓存而非模型本身，模型文件始终留在 MDXNET、VR、Demucs 子目录里即可。

列表正常后，先用默认模型跑一段短音频验证。如果跑起来报显存或 GPU 错误，转到「显存不足」「GPU 加速报错」；如果音质不理想，看「分离音质差」。