HTTP 与 Web 标准 / 系统课时
正确保存备注里的特殊字符
正确保存备注里的特殊字符
订单备注可能包含 &、尖括号,甚至直接粘贴代码文本。若把这些字符原样写进普通 XML 文本节点,它们可能被解析器当成实体引用或标签起点,导致文档无法解析。本节用字符实体和 CDATA 两种方式安全保存备注内容。
学习目标
- 正确转义 XML 文本中的
&、<和> - 判断普通字符实体与 CDATA 的适用场景
- 避免备注内容意外破坏 XML 文档结构
普通文本优先使用字符实体
在元素文本中,& 和 < 不能随意原样出现,因为它们分别可能开启实体引用和标签。将特殊字符改写为预定义实体后,解析器会恢复成原始文本内容。
xml
<?xml version="1.0" encoding="UTF-8"?>
<order>
<orderId>SO-20260916-002</orderId>
<remark>如库存不足,请联系 A&B 门店;不要把 <fragile> 当成真实标签。</remark>
</order>预期结果
text
解析后的 remark 文本:
如库存不足,请联系 A&B 门店;不要把 <fragile> 当成真实标签。这里的 & 表示字符 &,< 表示 <。> 在普通文本中多数情况下可以直接出现,也可写成 >,但只要前面出现了可能形成标记的 <,就应优先把 < 正确转义。
代码文本较多时可以使用 CDATA
如果备注中包含大量 XML、HTML 或代码片段,逐个转义会降低可读性。此时可以把文本放进 CDATA 区段,解析器会把其中大部分字符当作普通文本处理。
xml
<?xml version="1.0" encoding="UTF-8"?>
<order>
<orderId>SO-20260916-003</orderId>
<remark><![CDATA[
请保留以下文本原样:
<fragile enabled="true">A&B</fragile>
]]></remark>
</order>预期结果
text
解析后的 remark 文本包含:
请保留以下文本原样:
<fragile enabled="true">A&B</fragile>CDATA 适合“文本里特殊字符很多”的情况,但它不是另一种 XML 结构。程序读取 remark 时,得到的仍然是文本内容。
注意 CDATA 的边界
CDATA 以 <![CDATA[ 开始,以 ]]> 结束,因此正文中不能直接包含连续的 ]]>。如果备注本身可能出现这三个字符,就需要拆分内容,或改回字符实体方式。
选择转义还是 CDATA
普通短备注优先使用字符实体,因为结构简单、兼容性好,也便于精确控制内容。只有当文本中频繁出现 <、& 等字符,尤其是需要保留较长代码片段时,CDATA 才更易读。
无论使用哪一种方式,目标都相同:让备注保持“数据”身份,而不是被 XML 解析器误判成新的标签、实体或文档结构。
按自己的节奏,确认真正理解。