字幕标签里出现是指在视频字幕文件(如SRT、ASS等)中,用于控制显示样式的标签代码被错误显示或未被正确解析。

字幕标签里出现
HTML 字幕(<track></track>)本身不渲染内容,但它的 label、kind 属性值,以及 WebVTT 文件里的字幕文本,一旦含未转义的 &、、<code>>,就会在开发者工具里看到属性截断、控制台报 Unclosed entity,甚至触发解析错误导致整条字幕不显示。
常见错误现象:<track label="用户输入: <script>"></track> 渲染后 label 只读到 "用户输入: ;WebVTT 中写 5 被当成标签开头,后续文本全丢。
- 只转义这五个字符:
&、、<code>>、"、'——其余如©、→不影响结构,漏了顶多显示为方块 - 顺序不能错:必须先处理
&,再处理和 <code>>,否则会被二次转成 <code>< -
label和kind是普通 HTML 属性,适用和title相同的规则:单引号属性值里用'更稳,双引号属性值里"必须转成"
WebVTT 字幕文件里怎么写特殊符号
WebVTT(.vtt)是纯文本格式,不走 HTML 解析器,但它支持内联 HTML 标签(如 <b></b>、<i></i>),一旦启用, 和 <code>& 就又变成保留字符。所以不是“不用转”,而是“看是否启用了 HTML 标签”。
- 默认模式(无
<c></c>或<b></b>):直接写5 没问题,浏览器当纯文本渲染 - 启用了样式标签(如
<b>Price & stock</b>):&必须转成&,否则解析失败,整段字幕被跳过 - 想显示
字面量?只能用实体:<code> 或 <code>,不能直接敲 <code> - 零宽字符(
\u200b)、不间断空格(\xa0)在 vtt 里不会报错,但会导致字幕对齐错乱、语音识别失败,建议清洗掉
JS 动态设置 track.label 时别拼字符串
用 JS 给 <track></track> 元素设 label,如果写 track.label = 'User\'s input: <script>'</script>,单引号提前闭合,后面变成 JS 语法错误;更糟的是,如果这个值来自用户输入,还可能执行脚本。
立即学习“前端免费学习笔记(深入)”;
- 正确做法:用
element.setAttribute('label', str),它会自动处理引号,但不会转&、——这部分还得你自己来 - 别用
innerHTML写入 track 元素:它没有子内容,innerHTML无效,且容易误操作父<video></video> - 如果 label 值来自服务端 API,确认它已做 HTML 转义;前端拿到后不要再套一层
escapeHtml(),否则变成双层编码(如&)
显示代码片段的字幕要特别小心 &
技术教程类字幕常出现 src="img.png?w=100&h=80" 这种带 URL 参数的代码。只转 和 <code>> 不够——& 在 URL 里是分隔符,漏转会让浏览器尝试解析 &h=80 为实体,参数崩掉,最终加载错误图片。
- 所有含
&的代码片段,一律转成&;命名实体比数字实体更易读:&而不是& - 避免混用:同一段字幕里不要一会儿写
,一会儿写 <code>>,维护时极易漏掉分号或拼错名 - Emoji 和中文符号(如
→、—)没有命名实体,必须用十进制数字实体:→、—;十六进制(→)在部分旧播放器里不认
最易被忽略的是 WebVTT 的上下文切换:同一份字幕文件,前几行没标签可随便写 ,后几行加了 <code><i></i> 就立刻要补转义。别假设“整个文件都安全”,得按实际使用的 HTML 特性逐段判断。



















