在XML、XHTML以及部分基于XML语法的配置文件中，元素内容的编写需要严格遵循语法规范，当出现“元素内容必须由格式正确的字符数据或标记组成”的错误时，本质是元素内部的内容不符合XML的内容模型要求。这类错误在配置文件解析、前端模板渲染场景中十分常见，理解其原理和解决方法能有效提升开发效率。
错误产生的核心原因
XML语法规定，元素的内容只能是字符数据或者子标记，或者两者的混合，同时所有出现在内容中的特殊字符都需要符合转义规则。常见的触发错误的情况有以下几种：
- 元素内容中直接出现了未转义的<、&等XML特殊字符，比如直接在文本中写<div>而没有转义
- 混合内容中标记没有正确闭合，或者标记嵌套顺序不符合规范
- 在需要纯字符数据的位置插入了未声明的标记，或者标记格式本身存在语法错误
字符数据与标记的基本规则
字符数据的转义要求
字符数据是指元素中普通的文本内容，当文本中包含XML预定义的特殊字符时，必须进行转义，否则解析器会将其识别为标记的一部分导致语法错误。预定义特殊字符与转义对应关系如下：
| 特殊字符 | 转义后写法 | 说明 |
|---|---|---|
| < | < | 小于号，会被解析器识别为标记开始 |
| > | > | 大于号，会被解析器识别为标记结束 |
| & | & | 与号，会被解析器识别为实体引用开始 |
| " | " | 双引号，属性值包裹符号 |
| ' | ' | 单引号，属性值包裹符号 |
比如我们要在元素中写一段包含标签的文本描述，正确的写法如下：
<description>
这是一个示例文本，包含HTML标签<div class="test">内容</div>的展示说明
</description>
如果直接写<div>不转义，就会触发“元素内容必须由格式正确的字符数据或标记组成”的错误。
标记的正确嵌套规则
当元素内容中包含子标记时，子标记必须完整闭合，并且嵌套顺序要正确，不能出现交叉嵌套的情况。比如下面的写法是错误的：
<parent>
<child1>内容</child2>
</parent>
正确的嵌套写法应该是：
<parent>
<child1>内容</child1>
</parent>
CDATA段的使用场景
当元素内容中包含大量需要转义的字符，比如大段的代码、包含很多<和&的SQL语句时，逐个转义会非常繁琐，这时候可以使用CDATA段来包裹内容。CDATA段中的内容会被解析器当作纯字符数据处理，不会解析其中的任何标记或特殊字符。
CDATA段的语法格式是：
<![CDATA[ 需要包裹的内容 ]]>
比如我们要在配置文件中写一段JavaScript代码，就可以用CDATA段包裹：
<script_content>
<![CDATA[
function test() {
if (a < 10 && b > 5) {
console.log("条件满足");
}
}
]]>
</script_content>
这里面的<、&&、>都不需要转义，解析器会直接将其作为文本内容处理。
混合内容的正确编写示例
混合内容是指元素中同时包含字符数据和子标记的情况，这时候需要保证字符数据转义正确，子标记格式合法。下面是一个正确的混合内容示例：
<article>
这是文章的开头部分，接下来是代码示例：
<code>console.log("hello")</code>
然后是后续说明，包含特殊字符&的展示
</article>
如果混合内容中的文本包含未转义的<，比如写成：
<article>
示例标签<span>内容</span>
</article>
就会触发错误，正确的写法需要转义<和>：
<article>
示例标签<span>内容</span>
</article>
或者使用CDATA段包裹整个混合内容中需要保留原始字符的部分：
<article>
<![CDATA[示例标签<span>内容</span>]]>
</article>
排查错误的常用方法
当遇到这类错误时，可以按照以下步骤排查：
- 定位错误提示中给出的行号和列号，找到对应的元素内容
- 检查内容中是否有未转义的<、&等特殊字符，尤其是文本内容中出现的类似标记的字符串
- 检查内容中的子标记是否完整闭合，嵌套顺序是否正确
- 如果内容包含大量特殊字符，考虑使用CDATA段包裹对应内容
掌握这些规则后，就能有效避免“元素内容必须由格式正确的字符数据或标记组成”的错误，编写出符合语法规范的XML及相关格式文件。