srclang必须使用bcp 47主语言标签（如zh、en），避免中文、chinese或zh-cn等非标准写法；track元素须置于video/audio内且显式闭合；vtt文件需text/vtt mime类型、utf-8编码、首行webvtt及正确时间格式。
srclang 必须是 BCP 47 语言标签，不是随便写中文或英文
浏览器只认标准语言子标签，srclang="zh" 或 srclang="en" 是合法的，但 srclang="中文"、srclang="Chinese"、srclang="zh-CN"（虽常见但非必需）都可能被忽略或导致字幕不加载。W3C 规范明确要求使用 BCP 47 格式，实际解析中多数浏览器对 zh、en、ja、ko 等主语言码宽容，但对扩展子标签（如 zh-Hans）支持不一。
-
srclang="zh"→ 覆盖简体/繁体中文用户，兼容性最好 -
srclang="zh-Hans"→ 明确简体，但 Safari 16 之前不识别，Firefox 有延迟匹配 -
srclang="en-US"→ 比en更精确，但若字幕文件本身无地域差异，纯属冗余 - 避免空值、拼写错误（如
srclang="eng"是 ISO 639-2，HTML 不接受）
track 元素必须放在 video/audio 后面，且不能自闭合
<track></track> 是 HTML5 的 void element，但必须显式闭合（用 ），且必须作为 <video></video> 或 <audio></audio> 的子元素，顺序在所有 <source></source> 之后、<video></video> 结束标签之前。放错位置会导致浏览器完全忽略该 track。
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
<video controls><source src="movie.mp4" type="video/mp4"><track kind="subtitles" srclang="zh" label="中文" src="sub-zh.vtt" default></track></source></video>
- 如果
<track></track>写在<video></video>外面，控制台会报DOMException: Failed to execute 'addTextTrack' on 'HTMLMediaElement' - 遗漏
src属性时，字幕不会加载，但也不会报错，容易误判为样式问题 -
default属性只能有一个 track 带，否则行为未定义（Chrome 会选第一个，Firefox 可能全关）
VTT 文件头部必须有正确 MIME 类型和 UTF-8 BOM（可选但推荐）
服务器返回的 .vtt 文件 Content-Type 必须是 text/vtt，否则 Chrome/Firefox 拒绝解析；同时文件编码必须是 UTF-8，若含中文但没声明 BOM，部分旧版 Edge 会显示乱码。
- 检查响应头：
curl -I https://example.com/sub-zh.vtt应含Content-Type: text/vtt - VTT 文件首行必须是
WEBVTT（严格大小写，不能带空格或注释） - 推荐加 UTF-8 BOM（
EF BB BF），尤其当字幕含中文、日文等多字节字符时 - 时间格式错误（如用逗号代替句点：
00:00:01,000✅ vs00:00:01.000❌）会导致整条 track 加载失败，但无明显错误提示
srclang 和 user agent 语言设置共同影响自动启用逻辑
浏览器是否默认启用某条字幕，取决于 srclang 与用户系统/浏览器语言（navigator.language）的匹配程度，不是简单“相等”就启用。例如用户设为 zh-TW，srclang="zh" 可能匹配，但 srclang="zh-Hans" 就不会自动启用。
- 可通过 JS 主动启用：
video.textTracks[0].mode = "showing"，绕过自动匹配逻辑 - 多个 track 时，
label属性用于 UI 显示名称，它不影响匹配，但应与srclang语义一致（如label="English"对应srclang="en"） - 移动端 Safari 对
srclang匹配更保守，常需手动点选，不能依赖default
srclang 写对只是起点，文件编码、MIME、时间语法、甚至换行符（必须是 LF，不能是 CRLF）任一环节出错，字幕都会静默失效。前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
