HTTP 与 Web 标准 / 系统课时

正确保存备注里的特殊字符

正确保存备注里的特殊字符

订单备注可能包含 &、尖括号,甚至直接粘贴代码文本。若把这些字符原样写进普通 XML 文本节点,它们可能被解析器当成实体引用或标签起点,导致文档无法解析。本节用字符实体和 CDATA 两种方式安全保存备注内容。

学习目标

  • 正确转义 XML 文本中的 &、< 和 >
  • 判断普通字符实体与 CDATA 的适用场景
  • 避免备注内容意外破坏 XML 文档结构

普通文本优先使用字符实体

在元素文本中,& 和 < 不能随意原样出现,因为它们分别可能开启实体引用和标签。将特殊字符改写为预定义实体后,解析器会恢复成原始文本内容。

xml
<?xml version="1.0" encoding="UTF-8"?>
<order>
  <orderId>SO-20260916-002</orderId>
  <remark>如库存不足,请联系 A&amp;B 门店;不要把 &lt;fragile&gt; 当成真实标签。</remark>
</order>

预期结果

text
解析后的 remark 文本:
如库存不足,请联系 A&B 门店;不要把 <fragile> 当成真实标签。

这里的 &amp; 表示字符 &,&lt; 表示 <。> 在普通文本中多数情况下可以直接出现,也可写成 &gt;,但只要前面出现了可能形成标记的 <,就应优先把 < 正确转义。

代码文本较多时可以使用 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 解析器误判成新的标签、实体或文档结构。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

正确保存备注里的特殊字符

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通