HTML的标签不推荐直接加载SRT文件,因Chrome静默转译失败、Firefox行为不可控;稳妥做法是转为WebVTT——需首行WEBVTT、UTF-8无BOM、时间戳用句点、严格格式,且须在内、位于后,缺kind、srclang、label任一属性则字幕菜单不显示。

HTML 的 标签原生不推荐直接加载 SRT 文件,Chrome 实际会静默转译失败,Firefox 虽能解析但行为不可控——稳妥做法是先转成 WebVTT。
为什么 SRT 在 里经常不显示
浏览器对 SRT 的容忍度极低:时间戳用逗号分隔毫秒(00:01:23,456)是 SRT 规范,但 Chrome 内部尝试转成 WebVTT 时要求句点(00:01:23.456),多一个空格、少一个空行、BOM 头、非 UTF-8 编码,都会导致 Failed to load resource 且控制台不报具体原因。更隐蔽的问题是:srclang 值写成 zh-CN 没问题,但写成 Chinese 或留空,字幕菜单里就根本不会出现该轨道。
-
必须写在内部,且严格位于所有之后 - 缺
kind="subtitles"—— 字幕 UI 不触发;缺srclang—— 浏览器忽略该轨道;缺label—— 右键菜单显示(no label) - 若 SRT 和视频跨域,服务器必须返回
Access-Control-Allow-Origin: *,否则静默失败
怎么把 SRT 快速转成 WebVTT
不用装软件,三类在线工具可选,按场景选:
- 单文件快速转:用 srt2vtt.com,拖入 .srt → 下载 .vtt,首行自动补
WEBVTT,时间戳自动改句点,去掉序号和空行 - 批量+修复偏移:用 SRT转换工具,勾选「自动修复时间码」,适合剪辑后音画不同步的 SRT
- 保留样式或导出 ZIP:用 Weila Studio,支持把 SRT 中的粗体/颜色标记映射为 WebVTT 的
或(注意:纯 HTML5 播放器不一定渲染这些)
转换后检查:用 VS Code 打开生成的 .vtt,确认第一行是 WEBVTT,第二行为空,第三行开始是 00:01:23.456 --> 00:01:25.789,没有序号,文本无乱码。
标签写法与常见错误
WebVTT 文件路径要和视频同源或配好 CORS,src 值必须带后缀(.vtt),不能只写 subtitle;default 属性只是提示浏览器“默认启用”,实际是否显示仍取决于用户是否点击了 CC 按钮——它不会绕过用户手动开启。
- ✅ 正确:
- ❌ 错误:
(缺srclang,Chrome/Firefox 都不显示) - ❌ 错误:
(captions是给听障者描述环境音的,UI 上可能不归类为“字幕”)
多个语言轨道可并列写,浏览器根据系统语言自动匹配 srclang,但只有 default 的那个会在首次加载时被标记为“已启用”,其余需用户手动切换。
真正容易被忽略的是:WebVTT 文件本身也得是 UTF-8 无 BOM,哪怕转好了,用记事本另存一次都可能加 BOM;还有, 必须有 controls 属性,否则右键唤不出字幕菜单——这些细节一漏,字幕就彻底“隐身”。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











