# 云映 VTT 字面字符检查：让小于号与连接符按原意显示

语言：zh-CN
原文：[云映 VTT 字面字符检查：让小于号与连接符按原意显示](<https://allluckly.cn/guides/icouldplay-webvtt-literal-character-escapes/>)
中文：[中文 HTML](<https://allluckly.cn/guides/icouldplay-webvtt-literal-character-escapes/>)
English: [English HTML](<https://allluckly.cn/en/guides/icouldplay-webvtt-literal-character-escapes/>)
发布于: 2026-11-07T00:00:00+08:00
内容更新于: 2026-11-07T00:00:00+08:00
署名：Bison

为自制字幕中的比较式和连接符建立源文本与显示结果对照，核对实体转义和二次编码。

字幕里出现代码、比较式或“甲和乙”时，符号丢失不一定是缺字体。WebVTT正文有自己的标记和字符规则。本篇用外部纯文本文件与云映回放配合，只检查少量字面字符；不用来自真实课程的代码，也不把字幕解析当成能执行任意HTML的浏览器。两个例子只验证字符呈现，不能用来判定课程中的比较式在现实数据上是否成立。

## 先确定想让观众读到的文字

在外部笔记中先写两句目标文字：`2 < 5`和`A & B`。这里小于号表达比较关系，连接符只是字面文本，不是让播放器读取标签或联网。选至少十秒的自制短片，保存原视频和原字幕，再新建专用练习文件。先有明确显示目标，才有条件判断后面多出的amp字母或缺失符号属于什么问题；不要从一份已损坏的字幕反推它原来想表达的内容。

## 建立只有两条提示的样本

以下文件用`&lt;`表达字面小于号，用`&amp;`表达字面连接符。保留半角符号、分号和时间箭头，在纯文本编辑器里保存；不要通过富文本聊天窗口复制后把全角替代字符混进去。代码框边界不用写入字幕。

```vtt
WEBVTT

00:01.000 --> 00:04.000
2 &lt; 5

00:05.000 --> 00:08.000
A &amp; B
```

## 把源字符与目标字符分别登记

给第一句记源文件含`&lt;`、预期屏幕含`<`；第二句记源文件含`&amp;`、预期屏幕含`&`。这不是要把源文件和屏幕截图逐字相同，而是核对一次字符解析后的意义。W3C WebVTT列出这些字符表示，但实际载入仍受当前应用格式支持影响。不扩展推断为任意HTML命名实体都能用，也不加入脚本、样式或外部链接作为本题验证材料。

## 确认所选字幕后顺播观察

在云映打开对应短片，选择刚保存的练习文件，正常速度顺播经过两个时间段。分别抄下实际看到的整句，而不只记“显示正常”。若目标符号可见，退出字幕选择再确认文件名称，防止其实读的是另一份已修好的字幕。若文件不能载入，先用已验证的最小VTT确认入口和扩展名，再保留失败结果，不为满足预期把未显示算作成功。

## 用二次编码对照找出多余字符

另存第二份，只把第一句的源文本改成`2 &amp;lt; 5`，其他内容不变。若按一次实体解析，它应留下可见的`&lt;`字样，而不是再次变成小于号；实际观察逐字记录。这份对照用于理解重复编码，不是正式字幕的推荐写法。原练习和对照名称必须不同，切换时核对选中状态；不能把第二份意外留为课程默认字幕后再说符号问题复发。

## 区分字面符号与受支持的标记

若真实文本包含尖括号包围的说明，先决定它要作为可见文字还是某种WebVTT标记。不要为了显示原代码就直接把所有尖括号原样贴入，再将消失部分归咎字体。先在副本用字面字符表示最小化验证，保留原句和它的目标含义。播放器是否呈现斜体等样式另开对照，不和本题同时修改；字形、文本解析和样式是三个不同层面。

## 回到磁盘文件排查富文本转义

如果屏幕出现amp、分号或空方框，先重新打开磁盘上的VTT，逐字看实际保存了什么，而非只看网页预览。确认没有把`&lt;`再转成其他实体，没有使用长得相近的全角与符号，也没有从截图OCR得到错误字符。每次只改一处并另存，固定同一视频、字幕字号和播放位置。只有源文本正确但字形仍缺失时，再按字符检查教程调查字体或引擎。

## 用普通观看位置检查可读性

符号正确后，还要在平常观看尺寸读出两边数字与空格，避免比较式挤成难辨的一团。调整当前可见字号时保留一份原设置记录，不声称能用字体大小修复编码。若视频本身另有相同画内字，暂关可选字幕确认两层分别来自哪里，然后恢复所需状态。该检查只针对两条自制文本，不足以宣布整份程序教学或全部符号集合已经无障碍合格。

## 保留一份能直接复现的字符记录

完成时保存两份字幕、目标字符串、源字符串、屏幕结果与当前版本；正式交接优先使用已核对的单次转义文件。恢复原来正常观看的字幕并清楚标注实验对照。资料参考[W3C WebVTT](<https://www.w3.org/TR/webvtt1/>)中的字幕文本字符规则，本文没有复制外部字幕内容，也没有在真机验证所有实体。若不同引擎结果不一，写出实际条件和未核部分，不编造应用统一支持承诺。

## 相关教程与资料

[最小VTT文件](<https://allluckly.cn/guides/icouldplay-make-webvtt-practice/>)、[字幕字符核对](<https://allluckly.cn/guides/icouldplay-caption-character-reference/>)。

资料核对：2026 年 11 月 7 日，依据 [云映官方 App Store 说明](<https://apps.apple.com/cn/app/id6755653178>)与 [Apple 公开版本查询](<https://itunes.apple.com/lookup?id=6755653178&country=cn>)，当前版本 1.1.1，最低要求 iOS / iPadOS 15.0。1.1.1 的公开更新列出 Kodi、OpenList / AList 与 S3 兼容存储，并改进来源切换及跳转后的字幕显示；本文按这些公开范围与现有播放能力组织任务，具体入口以安装版本为准。自制样本、手工记录与外部文件整理不是应用新增自动功能；未声称已完成真机或私人服务器实测。