Flamingo 歌词不显示或不匹配：歌词文件排查清单
歌词不显示、翻译错位、逐字效果丢失，都从四个环节定位：有没有词、格式对不对、文件名对不对、优先级对不对。
第一步：确认歌词真的被加载
- 应用内歌词区完全空白 = 没加载到词。检查内嵌歌词字段或同名外挂文件，见歌词加载方式。
- 外挂文件放在音频同一目录，主文件名逐字一致（含大小写与空格）。
第二步：确认格式可解析
- LRC：时间标签必须是
[mm:ss]、[mm:ss.ff]、[mm:ss.fff]之一；冒号帧格式[mm:ss:ff]不支持，见LRC 逐行歌词。 - TTML：必须是合法 XML，
<p>带有效 begin/end，见TTML 歌词入门。 - 纯文本没有时间标签 = 无法同步，Flamingo 不支持纯文本歌词。
第三步：常见症状对症修
| 症状 | 原因 | 修法 |
|---|---|---|
| 歌词全无 | 未加载/格式坏 | 重新内嵌或换标准 .lrc 文件 |
| 只显示不滚动 | 时间标签缺失或全零 | 补时间标签 |
| 翻译不显示 | 时间戳与主歌词不一致 | LRC 逐句同轴重对，见LRC 翻译歌词 |
| 翻译覆盖了主歌词 | 重复行顺序写反 | 最后一行才是翻译，调整行序 |
| 逐字不点亮 | 用的是逐行格式 | 换逐字写法，见LRC 逐字歌词或TTML 逐字歌词 |
| 歌词与演唱差半拍 | 标签时间本身错 | 用歌词工具重新打轴 |
第四步：优先级与开关
- 同曲 TTML + LRC 并存时优先 TTML——你精心做的 LRC 被 TTML 盖住时，删掉或改名 TTML 文件即可。
- TTML 的翻译/音译显示受歌词页翻译开关控制，开关关着显示的是音译，见TTML 翻译与音译。
最后
- 显示与原文件有细微排版差异是内置格式化（合并空格、去行首空格）的正常行为。
- 状态栏没词但应用内正常，是另一个问题，见状态栏歌词不出现。