MultiTTS 导入失败怎么办 — 音源包导不进的排查清单

问题现象

点击"导入数据"后选了音源包文件，但：

• 提示"文件无效"或"格式不支持"
• 导入进度条很快走完但没反应
• 导入后发音人列表里还是空的

排查清单（按可能性从高到低）

检查 1：是不是用了系统文件管理器 ⭐⭐⭐⭐⭐

90% 的导入失败是因为这里踩坑了。

详见为什么必须用系统文件管理导入。

正确做法：在系统设置里找到"文件管理"或"我的文件"，用它来选音源包 zip 文件。不要用 ES、Solid Explorer、Total Commander 等第三方文件管理器。

检查 2：音源包是不是正确的 zip 格式

确认音源包：

• 是 .zip 后缀的压缩文件（不是已经解压过的文件夹）
• 文件大小合理（至少几 MB，一般几十到几百 MB）
• 不是损坏的 zip（用电脑解压试试看能不能正常打开）

检查 3：音源包路径是不是太复杂

如果音源包存放在很深的目录（比如 /storage/emulated/0/Android/data/com.long.package.name/files/Download/multitts/），有时文件管理器会在传递路径时出错。

解决办法：把音源包移到根目录下的 Download/ 文件夹（也就是下载目录），那里路径最短最稳。

检查 4：安卓权限是不是全开了

确保 MultiTTS 获得了存储权限：

1. 系统设置 → 应用 → 找到 MultiTTS
2. 权限 → 存储
3. 设为"允许"或"允许管理所有文件"（取决于安卓版本）

Android 11+ 的分区存储机制更严格，权限没给够 MultiTTS 可能读不到文件。

检查 5：清理 MultiTTS 的应用数据

如果之前导入过音源包但残留了坏数据，新的导入可能被干扰：

1. 系统设置 → 应用 → MultiTTS → 存储
2. 点"清除数据"（⚠️ 这会清空所有已导入的音源和设置）
3. 重启 MultiTTS
4. 重新导入音源包

这是最后的大招，能解决绝大多数玄学问题。

检查 6：音源包版本和 APP 版本不匹配

极少见但可能存在：某音源包是给旧版 MultiTTS（如 v1.3.x）做的，新版（v1.8.x）调整了格式就不认了。

解决办法：找和你当前 MultiTTS 版本匹配的音源包，或者找通用的完整音源包（官方导出格式通常跨版本兼容）。

检查 7：换一个音源包试试

如果某个特定音源包总是导入失败，有可能是这个包本身损坏了。换一个来源的音源包试试。

导入成功的标志

导入完成后，MultiTTS 主界面的发音人列表里应该出现：

• 新的头像
• 新的名字
• 小耳机图标可以点并且能出声

满足这三点 = 导入真的成功了。