srclang 必须使用标准 BCP 47 语言标签(如 zh、zh-Hans、zh-Latn、en-US),不可填“中文”“pinyin”等非标准值;它是 kind="subtitles" 或 "captions" 的强制属性,缺失或错误将导致字幕不显示。

srclang 必须用标准 BCP 47 语言标签,不是随便起名
填 srclang 不是写“中文”“English”或“pinyin”,而是必须用浏览器和辅助技术能识别的标准化语言代码。错填会导致字幕不进菜单、系统语言自动匹配失效、屏幕阅读器无法正确播报。
常见有效值包括:zh(简体中文)、zh-Hans(简体中文,更精确)、zh-Latn(汉语拼音,BCP 47 正式写法)、en-US、ja、ko、es。无效写法如:chinese、zh-CN(虽常见但非标准,部分旧浏览器可能 fallback 失败)、pinyin、zh-py、cn。
-
zh和zh-Hans都可表示简体中文,但zh兼容性更好;若需区分繁简,优先用zh-Hans/zh-Hant - 拼音必须用
zh-Latn,这是 IETF RFC 5968 明确规定的转写变体标识,zh-Latn-pinyin是冗余且不被支持的 - 地区子标签(如
-US)仅在需要区分方言/拼写时添加,en已足够覆盖大多数英语字幕场景
srclang 是 subtitles 类型的强制属性,漏写就等于没字幕
只要 kind="subtitles",srclang 就不是可选——它是 HTML5 规范强制要求的。不写或写空值(srclang=""),Chrome、Edge 会静默忽略该 <track></track>,Firefox 可能报警告但也不加载,控制台通常不报错,只表现为字幕菜单里根本看不到这一项。
注意:kind="captions" 同样要求 srclang;但 kind="chapters" 或 kind="metadata" 不需要它。
实现 Markdown↔ HTML 互转,支持导出 PDF,用于用户请求的文档格式转换。
立即学习“前端免费学习笔记(深入)”;
- 错误示例:
<track kind="subtitles" src="zh.vtt" label="中文"></track>→ 缺srclang,字幕不可见 - 正确写法:
<track kind="subtitles" srclang="zh" src="zh.vtt" label="中文(简体)"></track> - 多个同语言变体(如简中+拼音)必须用不同
srclang区分,不能都写zh
大小写、空格、BOM 都会影响 srclang 解析
srclang 值本身不区分大小写(ZH 和 zh 等效),但实际部署中要统一小写,避免和文件路径、CORS 配置等环节产生混淆。真正容易出问题的是它关联的 VTT 文件本身:如果 .vtt 文件带 UTF-8 BOM,或首行不是严格 WEBVTT(前后有空格、换行、注释),即使 srclang 填对了,整个轨道也会加载失败,且浏览器不会提示与 srclang 相关的错误。
- VTT 文件必须以无 BOM 的 UTF-8 保存,首行为纯
WEBVTT(无空格、无注释、不加//或) - 服务器需返回
Content-Type: text/vtt,Nginx/Apache 要显式配置 MIME 类型,否则 Safari 可能拒绝解析 - 本地开发勿用
file://协议打开,srclang再规范也加载不了 VTT——必须起 HTTP 服务(如python3 -m http.server)
srclang 和用户可见 label 没有绑定关系,别靠它猜显示名
srclang 是给浏览器和辅助技术用的机器可读语言标识,label 才是用户在右键字幕菜单里看到的文字。两者可以不同,比如 srclang="zh-Latn" 对应 label="汉语拼音",或 srclang="en" 对应 label="English (UK)"。不要以为写了 srclang="zh",浏览器就会自动显示“中文”——那完全取决于你写的 label 值。
-
label应尽量明确,尤其多变体时:推荐写成中文(简体)、中文(拼音)、English (US) - 同一页面内所有
<track></track>的label必须唯一,否则部分浏览器(如旧版 Edge)可能只显示第一个 - JavaScript 动态切换时,靠
textTrack.language(即srclang值)识别轨道,而不是靠label字符串匹配
src 可跨域访问 → kind 和 srclang 同时合法 → label 唯一可读。其中 srclang 看似简单,但填错一个字母,整条字幕轨道就从用户视野里消失了,而且很难定位。


















