快速修好 AsrTools 常见报错语音转文字任务故障排查指南【免费下载链接】AsrTools✨ AsrTools: Smart Voice-to-Text Tool | Efficient Batch Processing | User-Friendly Interface | No GPU Required | Supports SRT/TXT Output | Turn your audio into accurate text in an instant!项目地址: https://gitcode.com/gh_mirrors/as/AsrTools你点了“开始处理”任务列表卡了几秒然后弹出一个红色的“错误”文件夹里也没有字幕文件——这是大多数人用 AsrTools 时最先碰到的情况。AsrTools 是一款无需 GPU 的语音转文字工具能批量处理音频、视频文件输出 SRT、TXT、ASS 三种字幕。下面按你实际看到的报错逐个告诉你怎么定位、怎么修。 修好任务列表里的红色“错误”主界面长这样左边选引擎和格式中间是批量转写的任务列表状态列会显示“处理中 / 已处理 / 错误”。报错写着“确保安装 ffmpeg”现象选视频文件mp4、mov、ts 等处理时出错。 原因视频要先用 ffmpeg 抽成音频再转写ffmpeg 没装就走到这一步。 解决装好 ffmpeg 后把它的 bin 目录加入系统 PATH然后打开一个新终端验证ffmpeg -version这条命令用来确认 ffmpeg 已安装且在 PATH 里能打印版本号就说明配置成功。报错写着“Unsupported sound format”现象提示音频格式不支持并附上你的文件后缀名。 原因转写后端只收 flac、m4a、mp3、wav 这几种支持列表定义在bk_asr/BaseASR.py里。 解决先用 ffmpeg 把音频转成 mp3 再拖进列表ffmpeg -i 原文件.aac -ac 1 新文件.mp3报错写着“File not found”现象文件明明在列表里却说找不到。 原因文件在添加后被移动、重命名或删除了。 解决把文件放回原位置或用右键菜单“删除任务”后重新拖入。️ 修好 GUI 打不开、中文路径崩溃中文或带空格的路径下界面崩溃现象运行python asr_gui.py时闪退或提示 Qt 平台插件加载失败路径里有中文、空格时尤其明显。 原因PyQt5 的 Qt 平台插件路径没被正确解析。 解决新版asr_gui.py开头已经设置好了QT_QPA_PLATFORM_PLUGIN_PATH。如果你用的是旧版本或自己写了入口脚本在启动前补上这段环境变量import os, sys os.environ[QT_QPA_PLATFORM_PLUGIN_PATH] os.path.join( sys.prefix, Lib, site-packages, PyQt5, Qt5, plugins)启动时提示 ModuleNotFoundError现象报错缺少requests、PyQt5或qfluentwidgets。 原因依赖没装全源码运行的核心依赖只有 requests界面额外需要两个 GUI 库。 解决按项目依赖文件安装然后启动pip install -r requirements.txt python asr_gui.py 修好任务卡住、“无法连接到互联网”启动即提示“无法连接到互联网”现象刚启动就弹网络错误或者任务长时间无响应后失败。 原因转写是走云端接口的本地网络或代理挡住了请求。 解决先确认浏览器能正常上网如果你开了代理给 AsrTools 的运行环境配置好代理变量或临时关掉代理再试公司内网通常需要给相关域名放通出口。如果上一步没生效多半是代理只代理了浏览器没代理终端两个环境要分别设置。选了 Whisper 引擎报错现象引擎下拉框选 Whisper开始处理后立刻失败。 原因这个引擎目前还没实现代码里直接抛了未实现异常。 解决引擎换成 B、J、K 三个接口之一再开始处理。 找到生成的字幕文件、用好缓存处理完了却找不到字幕现象状态是“已处理”但目录里没看到新文件。 原因字幕写在源文件旁边文件名与源文件相同只换后缀为 .srt、.txt 或 .ass取决于你在界面上选的“导出格式”。 解决在任务行上右键选“打开文件目录”最快。提醒一句TXT 是纯文本没有时间轴要带时间轴就选 SRT 或 ASS。重复转写同一个文件出来的还是旧结果现象改了源文件内容再处理一遍结果却没变。 原因转写结果按文件内容做了缓存命中缓存就直接复用旧结果。缓存文件在系统临时目录下的bk_asr/asr_cache.json逻辑见bk_asr/BaseASR.py。 解决删掉这个缓存文件再重新处理即可。缓存超过 10MB 时程序也会自动清掉。想同时处理更多文件现象批量任务排队久想跑快一点。 原因默认只开 3 个并发线程数值在asr_gui.py的max_threads里。 解决按 CPU 核心数调大它比如 4 核机器调到 4调完重启程序生效。⚡ 用速查表快速定位报错错误速查你看到的报错 / 现象最可能的原因处理动作音频转换失败确保安装 ffmpegffmpeg 未安装或不在 PATH安装并配置 PATHUnsupported sound format音频后缀不在 flac/m4a/mp3/wav 内转成 mp3无法连接到互联网网络或代理问题检查网络、代理设置NotImplementedError选了未实现的 Whisper换 B / J / K 接口结果与预期不符命中了转写缓存删除临时目录下的缓存文件还是修不好的话在干净的虚拟环境里重试一遍能排除大部分环境层面的干扰python -m venv asr_env pip install -r requirements.txt如果依旧报错把完整错误信息提交到项目的 issue 区附上操作系统、Python 版本和出错文件类型会方便很多。【免费下载链接】AsrTools✨ AsrTools: Smart Voice-to-Text Tool | Efficient Batch Processing | User-Friendly Interface | No GPU Required | Supports SRT/TXT Output | Turn your audio into accurate text in an instant!项目地址: https://gitcode.com/gh_mirrors/as/AsrTools创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考