这些症状通常说明坏的是字幕链，而不是整个流。

先把它当成字幕打包或文本轨问题。

播放正常时，字幕仍失败的常见原因。

字幕问题大多落在轨暴露、格式和时间。

按固定顺序排查“字幕不显示”。

先查轨暴露，再查格式，最后才查时间。

1. 先确认播放链能否看到字幕轨

   用播放或检查确认字幕轨是否存在，再决定是否编辑文件。

2. 必要时先做字幕格式清理

   轨存在但不渲染时，先用字幕工具做转换或清理。

3. 只有在可见性和格式没问题后才修时间

   字幕轨可见且结构正常后，再进入时间修复才是对的。

当字幕轨可见但仍不可用时，先用 Subtitle Sync。

先把可见性、格式和时间拆开，不要一上来就盲改字幕。

让字幕问题按可见性、打包、时间三条线依次排查。

这些邻近路径能防止字幕问题变成随机文件编辑。

相关入口

• M3U8 Player
  先确认当前播放链能否暴露字幕轨。
• Bilingual Subtitles
  当问题属于字幕打包或多轨交付时走这里。
• Subtitle Sync
  在可见性和格式都稳定后修时间。

字幕问题只有先命名失败类别，才好修。

• 为什么播放正常但字幕仍可能失败？
  因为文本轨经常和音视频分开打包。流能播，不代表字幕轨也被正确暴露或正确解析。
• 要不要先修 sync 再确认字幕轨是否可见？
  不要。先确认轨存在并能渲染。只有在可见性和格式没问题后，修时间才有意义。
• 什么时候该用字幕工具而不是播放器？
  播放器用来确认有没有轨。字幕工具用来修格式、打包或时间。