HTTP 与 Web 标准 / 系统课时

什么时候应该使用 CDATA

什么时候应该使用 CDATA

当 XML 元素需要保存代码、表达式或包含大量 <、>、& 的原始文本时,逐个转义会降低可读性。CDATA Section 可以把一段内容明确交给解析器作为普通文本处理,但它只解决转义问题,并不会改变 XML 的数据语义。

学习目标

  • 理解 CDATA 与普通 XML 文本的解析差异
  • 判断什么时候使用 CDATA 比字符实体更清晰
  • 掌握 CDATA 的适用边界,避免把它当作通用容器

CDATA 解决的是转义问题

XML 正文中的 < 可能被识别为标签开始,& 可能被识别为实体引用。因此,普通文本如果需要包含这些字符,通常要写成 &lt;、&amp; 等实体。

例如,要在 XML 中保存一小段条件表达式,可以使用普通转义:

xml
<condition>a &lt; b &amp;&amp; status != "closed"</condition>

也可以使用 CDATA:

xml
<condition><![CDATA[a < b && status != "closed"]]></condition>

对 XML 解析器而言,这两种写法最终都表示元素中的文本。CDATA 的主要价值是让包含大量特殊字符的内容更容易阅读和维护,而不是创建一种新的数据类型。

适合使用 CDATA 的场景

当正文包含较长的代码、脚本、公式字符串或模板片段,并且 <、& 等字符频繁出现时,CDATA 往往更清楚。例如:

xml
<script><![CDATA[
if (price < 100 && stock > 0) {
    return "A&B";
}
]]></script>

预期结果是 XML 解析器把 CDATA 内部内容作为 script 元素的文本,而不会把 < 100 当成新标签,也不会把 & 当成实体引用。解析后的文本内容等价于:

text
if (price < 100 && stock > 0) {
    return "A&B";
}

如果只有一两个特殊字符,直接使用实体通常更简洁。例如 Tom &amp; Jerry 没有必要为了一个 & 再引入 CDATA。

CDATA 不是关闭 XML 语法检查

CDATA 只影响它包裹的字符数据。外层元素仍然必须满足 XML 的结构规则,开始标签、结束标签和整体嵌套关系依然会被正常检查。

xml
<message><![CDATA[<b>这只是文本</b>]]></message>

这里的 <b> 不会生成子元素。解析器得到的是包含 <b>这只是文本</b> 的字符串。如果希望真正创建 b 子元素,就不能把它放进 CDATA。

不应该使用 CDATA 的情况

CDATA 不能用于属性值,也不适合为了“看起来更安全”而包住所有文本。普通姓名、数字、日期等没有特殊字符的内容直接写成元素文本即可。

还要注意,CDATA 本身存在一个重要语法边界:内容中不能直接出现 ]]>。如果待保存文本可能包含这个字符序列,就需要拆分内容或采用实体转义等其他表示方式。

判断是否使用 CDATA 时,可以只问一个问题:这段文本是否因为大量 XML 特殊字符而变得难以阅读或维护。答案为是时,CDATA 才真正有价值。

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

目录与阅读设置

阅读设置

17

记录一个想法

什么时候应该使用 CDATA

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

登录哪都通