GPT-SoVITS hps未定义报错语音克隆三步修复清单【免费下载链接】GPT-SoVITS1 min voice data can also be used to train a good TTS model! (few shot voice cloning)项目地址: https://gitcode.com/GitHub_Trending/gp/GPT-SoVITS你在 GPT-SoVITS 里点合成时蹦出NameError: name hps is not defined别慌这个错不神秘按下面三步走语音合成就能恢复正常。先对号入座你是不是也卡在这用python webui.py起了 WebUI选好模型、填好文本点合成按钮的瞬间日志报 hps 未定义最近手动拷了几个 .py 文件做局部更新更新完第一次合成就挂了在 v1、v2、v3 权重之间来回切换之前好好的参考音频突然就报错。最小复现条件其实很宽松参考音频在 3~10 秒、推理文本非空基本必现。所以别怀疑你的音频和文本。hps 到底卡在哪一步把 hps 想成一张菜谱。它是装着全部超参数的容器采样率、分段长度、模型版本号都在里面。每次推理前程序先加载模型、顺手把菜谱抽出来之后模型照着菜谱确认食材规格。问题就出在加载这一步如果没走完权重文件不匹配、torch.load抛异常等菜谱始终没被抽出hps 就是空的。后面所有要翻菜谱的代码一执行立刻 NameError。这正是 GPT-SoVITS hps未定义 报错的根源——它本身不是病灶只是上游加载失败的报警器。对照 inference_webui.py报错前通常经过这三处change_sovits_weights加载段约 314 行全文件唯一给 hps 赋值的地方加载失败它就一直是未定义同文件的静音段时长计算处约 842 行用hps.data.sampling_rate算长度以及上方给参考文本补标点的处理逻辑torch.no_grad()使用前约 851 行和稍后取参考音频特征的get_spepc(hps, ...)调用约 974、981、994 行。跟着这三步修 ️更新到最新代码。修复来自官方仓库的最新提交process_ckpt.py 里的torch.load调用已带上weights_onlyFalse参数inference_webui.py 的加载流程也同步更新。执行git pull拉全量代码。对齐 PyTorch 版本。执行pip install torch2.6.0执行后你应该看到版本号为 2.6.0。新版 PyTorch 的torch.load默认weights_onlyTrue旧权重读不进来菜谱自然抽不出来。重启并验证。执行python webui.py预期结果日志里出现模型加载成功的打印点合成后几秒内生成 wav 文件。如果仍报错把完整日志贴出来看第一处 Traceback那才是真病灶。环境版本对照表组件推荐版本备注Python3.9.x官方整合包以此为准PyTorch2.6.0权重加载兼容性最佳librosa0.10.2requirements.txt 中已锁定transformers4.51,5加载 BERT / Hubert 用模型权重以 v2 为基准v1/v3 符号表不同别混着切平台差异提醒一句Mac M 系列芯片aarch64装的是 arm64 版onnxruntime而非-gpu版装错会连带推理失败Windows 上则要先确认系统 PATH 里有 ffmpeg。顺手避开的三个连带坑ModuleNotFoundError: No module named text.LangSegmenter→ 原因只拷了部分文件模块树不完整 → 解法放弃局部更新直接拉全量代码或用最新整合包。底模缺失无法加载相应 LoRA 权重→ 原因LoRA 权重与 v3/v4 底模不匹配 → 解法去掉 LoRA 选项先选标准权重跑通。切换 v1/v2/v3 后参数残留→ 原因weight.json记住了上次的权重路径 → 解法在 WebUI 里手动重新选择权重再点合成。遇到 GPT-SoVITS hps未定义 但三步后仍无解时先对照上表逐项核对90% 的情况出在 Python 与 PyTorch 版本错位。还卡住搜 docs/cn/README.md 里的报错关键词或去仓库 issue 区贴日志通常很快有人接住你。【免费下载链接】GPT-SoVITS1 min voice data can also be used to train a good TTS model! (few shot voice cloning)项目地址: https://gitcode.com/GitHub_Trending/gp/GPT-SoVITS创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考