track元素本身不制作微课视频,仅承载字幕等文本;显示失败主因是未满足同源/CORS、VTT格式合规(首行WEBVTT)、kind属性匹配三条件。

track 元素本身不能“制作”微课视频,它只是为 video 元素提供外部字幕、章节或描述性文本的载体。真正起作用的是配合正确的文件格式、编码方式和浏览器支持逻辑——否则你加了 track 也看不到讲解词。
为什么加了 track 标签却没显示讲解词?
常见原因不是写法错,而是三个隐性条件没满足:
- 视频文件必须在同源(或配置了
CORS头),否则浏览器直接屏蔽track加载 -
track的src必须指向有效的.vtt文件,且第一行必须是WEBVTT(大小写敏感,后面不能有空格) -
kind属性必须匹配用途:subtitles(教学讲解词用这个)、captions(含音效说明)、descriptions(视障辅助),填错就默认不渲染
.vtt 文件怎么写才让讲解词对得上时间点?
别手敲时间轴。微课讲解词节奏快、停顿多,手动对齐极易出错。推荐做法是先用剪映导出 SRT(或用 Audacity 听写+打点),再用在线工具如 subtitletools.com 转成 VTT —— 注意检查转换后每段是否保留了 WEBVTT 开头和空行分隔。
一个最小可用的 lesson.vtt 示例:
立即学习“前端免费学习笔记(深入)”;
WEBVTT 00:00:01.200 --> 00:00:04.500 同学们注意,这里的关键是理解“进路锁闭”的含义。 00:00:05.100 --> 00:00:08.300 它不是指道岔被物理卡死,而是系统逻辑上的占用确认。
如何让讲解词支持教学交互,比如点击跳转到某句?
track 本身不支持点击,但你可以用 JavaScript 抓取 video.textTracks 中的 cue 数据,结合 cues.forEach() 绑定事件。难点在于:Chrome 和 Safari 对 textTracks[0].mode 的初始值处理不同,必须显式设为 "showing" 才能触发 cuechange 事件。
关键代码片段:
<video id="micro-lecture" controls>
<source src="lesson.mp4" type="video/mp4">
<track kind="subtitles" label="中文讲解" srclang="zh" src="lesson.vtt" default>
</video>
<script>
const video = document.getElementById('micro-lecture');
const track = video.textTracks[0];
track.mode = 'showing'; // 必须这行,否则 cuechange 不触发
video.addEventListener('cuechange', () => {
const activeCue = track.activeCues[0];
if (activeCue) {
console.log('当前讲解词:', activeCue.text);
}
});
</script>
真正容易被忽略的是:如果你的微课要适配手机微信内置浏览器,track 在 iOS 微信里默认被禁用(除非用户手动打开字幕开关)。这时候得准备降级方案,比如用 div + position: absolute 模拟字幕层,并监听 timeupdate 手动切换文案。



















