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> 是 HTML5 的 void element，但必须显式闭合（用 </track>），且必须作为 <video> 或 <audio> 的子元素，顺序在所有 <source> 之后、<video> 结束标签之前。放错位置会导致浏览器完全忽略该 track。

<video controls>
  <source src="movie.mp4" type="video/mp4">
  <track kind="subtitles" srclang="zh" label="中文" src="sub-zh.vtt" default>
</video>

• 如果 <track> 写在 <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 会显示乱码。

anything-to-html

将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。

下载

• 检查响应头：curl -I https://example.com/sub-zh.vtt 应含 Content-Type: text/vtt
• VTT 文件首行必须是 WEBVTT（严格大小写，不能带空格或注释）
• 推荐加 UTF-8 BOM（EF BB BF），尤其当字幕含中文、日文等多字节字符时
• 时间格式错误（如用逗号代替句点：00:00:01,000 ✅ vs 00: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

真正麻烦的是 VTT 文件内容校验和服务器配置——srclang 写对只是起点，文件编码、MIME、时间语法、甚至换行符（必须是 LF，不能是 CRLF）任一环节出错，字幕都会静默失效。