onnx 与 pth：UVR5 模型文件格式说明

UVR5 的模型文件主要有 onnx 与 pth 两种格式，分别对应不同的引擎。搞清楚它们属于哪个引擎、体积差异与损坏表现，能在下载失败或模型报错时快速定位问题。本文做格式层面的说明。

格式与引擎的对应关系

• onnx：MDX-Net 引擎的模型格式，跨平台推理友好，是 UVR5 里最常见的模型类型，Main、Inst、Kim、HQ 系列都是 onnx。
• pth：VR Architecture 引擎的模型格式，PyTorch 原生权重，体积通常更小，DeNoise、DeEcho、7_HP2 等都在这一族。
• Demucs：以 pth 权重文件夹形式存在，但加载逻辑由 Demucs 引擎接管，与 VR 的 pth 不可混用。

体积差异

同一功能下，onnx 模型一般比 pth 略大，但真正拉开差距的是 Demucs：htdemucs_ft 这类四轨以上是 GB 量级，远大于 MDX-Net 与 VR 的单模型。磁盘紧张时，优先保留体积小的 VR 模型，按需下载 Demucs。下载前看清楚文件大小，避免中途空间不足导致残缺，尤其是无独显的大模型更占空间。

如何一眼区分两种格式

看扩展名最直接：onnx 结尾归 MDX-Net，pth 结尾归 VR。Demucs 则表现为一个含多个 pth 的文件夹，且必须在 Demucs 子目录下。手动整理时，按扩展名分拣到对应子目录，几乎不会错。若看到同名但扩展名不同的文件，更要确认它属于哪个引擎再放置。

下载与校验

在软件内下载更多模型是最稳妥的渠道，会自动落到对应子目录且带完整配置。手动下载时，务必确认来源与文件名一致，把整套文件原样放入对应子目录，重启识别。校验可看文件大小是否与发布页标注一致，明显偏小往往意味着下载被截断。onnx 与 pth 都是二进制，不要用文本编辑器打开或修改，否则会破坏权重。

常见损坏问题

• 模型不显示：多半是放错子目录或文件名被改动，回到对应引擎目录核对。
• 加载报错或崩溃：文件可能被截断或不完整，删除后重新下载即可。
• 结果异常发闷：可能混入了错误版本的权重文件，清理后只留官方原版。
• 解压残留：手动解压时若多出多余文件夹层级，UVR5 也读不到，需把权重放在正确一层。

下载渠道的安全提醒

• 优先软件内下载，自动落位且带配置，最省心也最安全。
• 社区获取时核对文件名与发布页一致，警惕被篡改的权重。
• 大体积 Demucs 模型下载用稳定网络，避免中途截断。

格式选错引发的连锁问题

把 onnx 误放进 VR 目录，或把 VR 的 pth 当 Demucs 权重使用，都会让软件读不到或加载错位。遇到无法解释的错误时，第一步回到扩展名核对归属，往往比重装软件更快定位。养成按引擎分文件夹存放、下载后核对文件大小的习惯，能省去大量排查时间，也避免反复重下大体积模型浪费带宽。

下一步

理解格式归属后，回到模型目录页面管理本地文件会更顺手。遇到具体模型选不准时，结合模型对比与集成组合页面做最终决定，而不是盲目囤积模型。