MDict 发音故障排查 — 点了小喇叭没声音怎么办

先分清模式

排查发音问题的第一步是确定你在用哪种发音方式——真人发音（mdd 里的音频文件）还是 TTS 在线/离线合成？两种模式的故障点完全不同。

判断方法：点击小喇叭后，MDict 状态栏如果显示"正在加载 mdd"就是真人发音；如果显示"正在调用 TTS 引擎"就是 TTS。如果连小喇叭图标都没有，说明词典根本没有配置发音能力。

真人发音故障

症状：点小喇叭提示"未找到音频文件"

最常见原因：mdd 文件不存在或文件名不匹配。

检查清单：

词典目录下是否有 .mdd 文件？（包括 .1.mdd、.2.mdd 等分卷格式）；
mdd 主文件名是否跟 mdx 完全一致？比如 牛津高阶.mdx 必须配 牛津高阶.mdd 或 牛津高阶.1.mdd，不能是 Oxford.mdd 或 牛津高阶完整版.mdd；
mdd 文件是否跟 mdx 在同一个目录里？分开放的话 MDict 也找不到。

症状：点小喇叭无反应、也没错误提示

可能原因：

mdd 文件虽然存在但内部是空的或损坏——用 7-Zip 打开 mdd，如果里面没有 /audio/ 目录或 audio 文件大小为 0，说明下载时 CRC 校验失败，需要重新下载；
MDict 没正确加载 mdd——在词库管理里先移除这本词典、重新添加，或者重启 MDict 让它重新扫描 mdd。

症状：播放到一半突然停止

PC 版：杀毒软件把临时解压目录里的 mp3 文件删了——把临时目录加白名单；
Android 版：手机自动清理后台进程，MDict 的音频播放被中断——把 MDict 加入后台清理白名单。

TTS 发音故障

症状：TTS 完全不工作、按钮灰色或报"引擎不可用"

PC 版：

打开 Windows 设置 → 时间和语言 → 语音，确认系统确实安装了中文/英文语音包；
在 MDict 设置里手动切到不同的 SAPI 引擎试试；
如果之前安装过第三方 TTS 后卸载了，可能在 MDict 里留下了失效的引擎配置——卸载所有第三方 TTS 后用 SAPI。

Android 版：

确认系统里有 TTS 引擎——设置 → 无障碍 → 文字转语音输出 → 首选引擎；
小米 MIUI / 华为 EMUI 很多版本默认删了 Google TTS，需要手动下载安装；
安装后重启 MDict，引擎列表才会刷新。

症状：Edge TTS 报错、延迟大或一直加载

Edge TTS 从 2024 年起被微软加强了访问限制，经常报 403 或 Cloudflare 挑战。排查步骤：

你的代理地址是不是还活着？代理服务经常会被 Cloudflare 封，需要找社区最新的可用代理；
网络环境能不能访问？公司/学校 WiFi 可能屏蔽了代理服务器；
代理配置是不是写对了？MDict 的词典 js 里需要填入正确的代理 URL。

如果是 Edge TTS 搞不定，建议放弃——换系统 TTS 或 DictTango，不要花时间在代理上。

iOS / Mac 版特殊问题

iOS 和 macOS 的 AVSpeech TTS 引擎由操作系统控制，MDict 能做的设置非常少。如果出现发音问题：

确认系统里安装了目标语言的语音包（设置 → 辅助功能 → 语音内容 → 系统语音）；
iOS App Store 版 MDict 长期不更新，对某些新语音包的兼容性有限；
Edge TTS 代理在 iOS 上完全无法使用——系统限制 App 不能设置 HTTP 代理请求。

总结排查顺序

点喇叭 → 什么模式？
├── 真人发音
│   ├── 小喇叭存在吗？
│   │   └── 词典没配置发音 → 换有发音的词典
│   ├── mdd 文件名匹配吗？
│   │   └── 不匹配 → 重命名或移动文件
│   ├── mdd 内部有 audio 文件吗？
│   │   └── 空的/损坏 → 重新下载
│   └── 播放器权限正常？
│       └── 杀毒/白名单问题 → 加白名单
└── TTS 发音
    ├── 系统有 TTS 引擎吗？
    │   └── 没有 → 安装（PC 加语音包、手机装 TTS 应用）
    ├── MDict 设置里切对引擎了吗？
    │   └── 切到 SAPI / PICO / AVSpeech
    └── Edge TTS？
        └── 代理可能失效 → 换系统 TTS