m3u8文件不是视频而是UTF-8编码的纯文本播放列表，以#EXTM3U为强制首行标识，通过标签索引.ts分片地址、时长、加密及码率等元数据，分主播放列表和媒体播放列表两类，支持自适应码率与直播/点播场景。
当你从视频网站“下载”到一个后缀为.m3u8的文件却打不开时，说明你遇到了HLS流媒体的核心索引文件——它不是视频本身，而是一份用UTF-8编码写的纯文本指令清单，告诉播放器该去哪里、按什么顺序、以什么参数加载一个个.ts分片。
先搞清m3u8的本质：它不是视频，是导航图
#EXTM3U必须出现在第一行，这是强制性文件头标识，【缺失这行，任何标准解析器都会直接拒绝处理】。没有它，播放器连“这是个m3u8”的基本判断都无法做出。
m3u8不存画面和声音，只存路径、时长、加密方式、码率选项这些元数据。就像餐厅菜单不提供饭菜，但写明了每道菜叫什么、几秒出锅、要不要加辣、有没有套餐组合。
它分两类：主播放列表（Master Playlist）列出多个清晰度选项；媒体播放列表（Media Playlist）则直指某一清晰度下所有.ts片段的URL序列。
看懂三类关键标签：从文件头到分片地址
方法一：识别基础结构标签
#EXT-X-VERSION声明协议版本，不同版本支持的特性差异很大——比如#EXT-X-KEY加密密钥格式在v5才正式定义，用v3解析v5加密流会直接失败。
#EXT-X-TARGETDURATION是播放器缓冲策略依据，单位为秒，表示所有分片时长都不超过该值。若写10，但某段实际12秒，播放器可能跳过或报错。
方法二：定位媒体片段信息
#EXTINF后必须紧跟逗号，格式为#EXTINF:时长, 标题（标题可为空），漏掉逗号会导致整行被忽略，后续URL无法被识别为有效分片。
其后的URL可以是绝对路径（http://.../seg1.ts）或相对路径（seg1.ts）。相对路径需结合m3u8所在目录拼接，否则下载器找不到文件。
方法三：识别流类型与终点
#EXT-X-ENDLIST只存在于点播（VOD）场景，表示列表终结；直播流中绝不会出现它，播放器看到就停止拉取新分片。
#EXT-X-MEDIA-SEQUENCE是直播流的分片序号起点，每次请求新m3u8时该值递增，播放器靠它判断是否漏片或重放。
实战：用Python快速验证m3u8有效性
第一步：安装解析库
pip install m3u8
第二步：加载并检查基础字段
import m3u8
playlist = m3u8.load('live.m3u8')
print(f"版本: {playlist.version}, 直播流: {playlist.is_live}, 总分片数: {len(playlist.segments)}")
第三步：遍历前两个分片URI与持续时间
for seg in playlist.segments[:2]:
print(f"URL: {seg.uri}, 时长: {seg.duration}s")
如果报AttributeError: 'NoneType' object has no attribute 'segments'，说明文件未通过基础语法校验——大概率是缺#EXTM3U或编码不是UTF-8。
常见失效原因速查
跨域限制：浏览器直接fetch网络m3u8会触发CORS拦截，必须由服务端代理或使用支持CORS的播放器（如VLC）。
相对路径未补全：用curl获取的m3u8里全是seg1.ts这类路径，本地解析时需手动拼base URL，否则m3u8.loads()无法定位真实资源。
UTF-8 BOM头干扰：Windows记事本另存为UTF-8时会加BOM，导致#EXTM3U无法被识别。用VS Code或Notepad++另存为“UTF-8 无BOM”即可解决。
