从文件头到分片清单：一张播放列表的骨架
西瓜视频2.m3u8 本质上是一个纯文本的媒体播放列表，它不装视频本身，只负责按顺序列出每一段分片的位置与时长。用记事本或任意浏览器打开，第一行几乎总是 #EXTM3U，宣告这是一份符合 HLS 规范的索引文件。
紧随其后的媒体播放列表里，每一段分片都由两行构成：一行是 #EXTINF 加上该段秒数，下一行才是相对路径或绝对地址的分片名，通常以 .ts 结尾。播放器按行读取、按时长拼接，画面就连续起来了。
若文件开头是 #EXT-X-STREAM-INF，那就是主播放列表，里面列出的是不同码率子列表的地址；子列表才是真正藏着一串分片的那份清单。两份文件的分工截然不同，排查问题时先认清手里的是哪一份。
一份索引就像一张报纸的目录：行号是版次，时长是版面，分片地址是那一页真正的内容。
多端播放与本地整理的步骤
- 选播放器。桌面端用 VLC 或 PotPlayer，直接把西瓜视频2.m3u8 拖进窗口即可；macOS 可用 IINA，同样支持索引拖放。
- 用命令行验活。执行 ffmpeg -i 播放列表地址，能读到时长与流信息说明索引与分片都是通的，报错则指向具体的缺失分片。
- 检查路径拼接。分片地址多为相对路径，需与索引文件保持同级目录结构，移动文件时整目录一起搬。
- 确认网络与协议。跨域读取或重定向链路过长时，浏览器内核的播放器常只出声音或直接黑屏，换本地播放器即可区分是索引问题还是环境问题。
- 离线归档。用 ffmpeg 按索引顺序合并分片为单一文件，避免日后分片地址失效导致清单变成空目录。
本地缓存的整理要点
- 先保存索引原文，再按行抓取分片，两者放在同一文件夹。
- 解密后的分片与原始分片分开存放，便于对照排查。
- 合并前用索引里的 #EXTINF 总时长核对成片长度。
索引异常与分片缺失的处理
打开后只有声音
多半是视频轨与音频轨被拆成了两份列表，只加载了其中一份。把两份索引都交给播放器，或分别合并后再封装。
进度条走到某一段卡住
对应序号的分片返回 404 或超时。逐个在浏览器地址栏访问分片地址，定位到具体那一行，再决定是补抓还是改写索引。
加密分片无法播放
#EXT-X-KEY 指向的密钥地址若已失效，整段内容都无法解出。此时保留分片原文，另行寻找可用的密钥来源，切勿反复重试同一地址。
时间轴错乱
分片时长与实际编码时长不一致会拖拽跳帧。用重新分段的方式生成新索引，比手工修补数字更稳妥。
常见问答
西瓜视频2.m3u8 可以直接改成 .mp4 后缀播放吗？
不行。它记录的是分片地址列表，改后缀并不会把分片合成完整视频，需要用转码工具按索引顺序合并后再封装。
索引能打开却提示没有可播放的流，是什么原因？
通常是把主播放列表当成了媒体列表，或者分片地址是相对路径而文件已被单独移动。检查文件头的标签类型与目录结构即可。
分片数量很多，手工检查太慢怎么办？
把索引里的地址逐行导出，用一次性批量探测的方式筛选失效行，只对报错的那几行做人工复核。
直播形式的列表为什么没有结束标记？
直播清单会持续追加新分片并滚动删除旧行，缺少 #EXT-X-ENDLIST 属于正常现象，播放器会按目标时长周期性重新请求。