离线状态下标签无法直接加载本地SRT字幕,因file://协议禁止跨文件读取且SRT格式易出错;唯一可靠方案是WebVTT格式配合base64内联或textTracks API手动注入。

离线状态下用 加字幕,不能直接写 src="sub.srt" —— 浏览器会静默失败,控制台只报 Failed to load resource,连错误原因都不给。根本原因是:SRT 文件被当作普通资源加载,而本地双击打开 HTML 时走的是 file:// 协议,浏览器禁止跨文件读取。
为什么 在离线时大概率不显示字幕
不是标签写错了,是加载路径和格式双重卡死:
-
的src必须能被浏览器成功 fetch 到内容,但file://下 fetch 本地 SRT 会被拦截(Chrome/Firefox/Edge 全部如此) - 即使绕过协议限制(比如用 Python 启服务),SRT 还得满足严格规范:UTF-8 无 BOM、时间戳用逗号分隔毫秒、空行位置精准,错一处就静默失效
- Chrome 实际把 SRT 转成 WebVTT 再解析,Firefox 则原生支持;同一份 SRT 在两者表现可能完全不同
-
default属性在离线场景下基本无效——用户仍需手动点开字幕菜单启用
真正离线可用的字幕方案只有两种
别折腾 CORS 或本地服务器,直接选下面之一:
-
首选 WebVTT + base64 内联:把 .vtt 文件转成 base64 字符串,拼进
src="data:text/vtt;base64,..."。这样完全不依赖外部文件,双击 HTML 即可运行。注意 MIME 类型必须是text/vtt,不是text/plain或application/octet-stream -
退而求其次:用
的textTracksAPI 手动注入:用户通过选中本地 .vtt 文件后,用FileReader读取内容,再调用video.addTextTrack()创建轨道并逐条添加Cue。这种方式 100% 离线可行,但需要用户主动点选文件
示例(base64 方式):
<video controls><source src="movie.mp4" type="video/mp4"><track kind="subtitles" srclang="zh" label="中文" src="data:text/vtt;base64,VUJVVEQKMTAKMDA6MDA6MDAuMDAwIC0tPiAwMDo...%EF%BC%88%E6%AD%A4%E5%A4%84%E4%B8%BA%E6%88%AA%E6%96%AD%E7%9A%84%20base64%EF%BC%89"></track></source></video>
别碰 SRT,优先转 WebVTT 再处理
SRT 在 HTML5 字幕生态里已是“兼容性包袱”:
- 在线工具如
srt2vtt或Subtitle Edit可一键转换,首行加WEBVTT,时间戳改用句点(00:01:23.456),删掉序号行 - WebVTT 支持内联样式(如
、)、定位、多语言嵌套,且所有现代浏览器原生解析,不依赖中间转换 - 如果必须保留 SRT 原始文件,不要指望它直接被
加载——先转 VTT,再决定用 base64 内联还是本地 HTTP 服务托管
真正麻烦的从来不是怎么写标签,而是浏览器对离线资源加载的层层设防。base64 内联 WebVTT 是目前唯一能“双击即用、不改环境、不装服务”的解法,但要注意文件体积:超过 50KB 的字幕文本,base64 编码后加载延迟会变明显。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











