UVR5 模型目录怎么用：子目录结构与手动安装

UVR5 模型目录是存放所有分离模型的本地文件夹。理解它的结构与手动安装方法，能让你在软件内下载失败时自己补齐模型，也能在磁盘紧张时精准清理。本文说明各引擎子目录的位置、文件命名规则、重启识别机制、多版本共存与清理策略。

引擎子目录位置

Windows 用户在 UVR5 安装目录下的 models 文件夹中管理模型，内部按引擎分为 MDXNET、VR、Demucs 三个子目录。macOS 与 Linux 由于没有统一安装路径，模型目录位于软件解压根目录的 models 文件夹下，同样包含对应的子目录。把模型放进对应子目录是手动安装的第一步，放错子目录软件不会识别，也不会报错，只是下拉框里看不到，容易让人误以为是模型损坏。

文件命名规则

每个模型由一组固定命名的文件组成，文件名通常包含引擎、用途与版本信息，例如 UVR-MDX-NET-Voc_FT.onnx 这样的命名能直接看出是 MDX-Net 系列的人声模型。下载模型时不要随意改名，因为 UVR5 依据文件名与配套配置文件来加载元数据。对 Demucs 这类模型，文件夹内常包含多个分轨权重文件，要保持完整，不要只复制单个文件，否则加载会失败并报错。

重启识别机制

UVR5 在启动时扫描 models 目录并读取模型清单，所以手动放入新模型后必须完全关闭并重新打开软件，下拉框才会出现新选项。如果只是最小化到系统托盘再展开，并不会触发重新扫描。遇到放入模型却不显示的情况，先确认软件进程已彻底退出，再重启一次通常就能解决。批量放入多个模型时同样只需重启一次，无需逐个测试。

多版本共存

同一模型常存在多个变体，例如 Inst Main、Inst 3 与 Inst HQ 可以同时存在，互不冲突，因为它们文件名不同。你可以保留旧版本的模型作为对照，在集成模式里切换对比找出更适合当前音源的版本。建议对长期不用的版本移动到备份文件夹，避免下拉列表过长影响选择效率，需要时可随时移回，软件重启后即重新出现。

精准清理策略

模型占用磁盘可观，定期清理能释放空间。删除某个模型只需从对应子目录移除其全部相关文件，软件再次启动会自动丢弃该选项。Demucs 系列体积最大，确认不再做乐器分轨后可以优先清理；VR 引擎的 pth 模型最小，可尽量保留以便随时做二级处理。清理前建议记录模型名，方便日后在软件内一键重新下载，已有任务配置不受影响。

手动补齐模型的完整流程

当软件内下载缓慢或失败时，可到社区或官方仓库找到对应模型文件，按引擎归入 MDXNET、VR 或 Demucs 子目录。放入前先确认目标子目录已存在，避免自建错误名称的文件夹。放好后彻底重启软件，下拉框出现即代表识别成功。若仍不显示，检查文件名是否被浏览器追加了多余后缀，例如本应是 onnx 却变成了 onnx.txt，这类隐藏问题最常见。

下一步

理清目录结构后，推荐先下载 UVR-MDX-NET Main 与 UVR-DeEcho-DeReverb 两颗常用模型跑通流程。需要更高质量时，再按模型对比与集成组合的页面补齐引擎变体，并据此规划磁盘空间。