track 元素的 src 必须为相对或绝对 URL,禁用本地文件路径;其解析以 base 标签或 HTML 文档 URL 为基准,且依赖正确 MIME 类型(text/vtt)、无 BOM 的 WEBVTT 开头及合法文件名。

track 元素 src 路径必须是相对或绝对 URL,不能是本地文件路径
浏览器加载 时会发起独立的 HTTP 请求获取字幕文件(如 .vtt),所以 src 必须指向一个可通过网络访问的资源。直接写 src="subtitles.vtt" 是合法的,但前提是该文件和 HTML 页面在同一个可访问的 Web 服务器下——本地双击打开 HTML 文件(file:// 协议)时,绝大多数浏览器会因跨源限制拒绝加载 track,报错类似 Failed to load resource: net::ERR_FAILED。
- ✅ 正确:同目录下
src="captions.en.vtt"(HTTP/HTTPS 环境下) - ✅ 正确:子目录
src="subs/fr.vtt" - ✅ 正确:绝对路径
src="/assets/zh.vtt"(从站点根目录开始) - ❌ 错误:
src="C:\project\en.vtt"(Windows 绝对路径,完全无效) - ❌ 错误:
src="file:///D:/data/sub.vtt"(file://协议在多数现代浏览器中被主动拦截)
track src 路径解析规则和 base 标签的影响
的 src 是相对 URL,解析时以当前 HTML 文档的 base URL 为基准,而非 所在位置。如果页面用了 ,那么 src="sub.vtt" 实际请求的是 https://example.com/videos/sub.vtt,而不是和 HTML 同目录的路径。
- 若未声明
,则以 HTML 文档 URL 为基准(例如https://site.com/pages/watch.html→src="sub.vtt"请求https://site.com/pages/sub.vtt) - 一旦存在
,所有相对src都按它解析,包括、、等 - 调试建议:右键检查
元素,在开发者工具 Network 标签页看实际发出的请求地址,确认是否符合预期
VTT 文件本身内容对路径也有隐含要求
src 指向的 .vtt 文件虽然只是纯文本,但如果其中包含 或 标签里用到的媒体片段引用(比如 WebVTT 的 或注释中的链接),这些内部链接也受同源策略约束。更关键的是:.vtt 文件的 Content-Type 必须是 text/vtt,否则 Chrome/Firefox 会静默忽略该 track。
- 确保 Web 服务器返回正确 MIME 类型:Nginx 需添加
types { text/vtt vtt; };Apache 可加AddType text/vtt .vtt - 避免用中文文件名或空格,如
第1集-中文字幕.vtt容易因编码问题导致 404;推荐用ep01-zh.vtt - VTT 文件首行必须是
WEBVTT(顶格,无空格无 BOM),否则解析失败且不报明显错误
开发阶段快速验证 track 是否生效的三步法
别只盯着 HTML 写对没写对,重点看浏览器是否真正加载并应用了字幕。
- 打开开发者工具 → Network → 过滤
vtt,播放视频前刷新页面,确认.vtt请求状态码是 200 - 检查
元素是否有readyState值:在 Console 中执行document.querySelector('track').readyState,2表示已加载完成(0=not loaded, 1=loading, 2=loaded, 3=error) - 手动触发显示:执行
document.querySelector('track').mode = 'showing',如果字幕立刻出现,说明路径、格式、MIME 都没问题;如果没反应,再回头查 Network 和 readyState
路径本身很简单,但整个链路涉及协议限制、服务器配置、MIME 类型、BOM 字符、base 标签等多层隐性依赖,任一环节断掉都会让 track “看起来写了却不起作用”。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











