xs:simpleContent下不能嵌套xs:element或xs:attributeGroup，因其仅允许xs:extension或xs:restriction，且后者只能添加属性或限制基类型，不可引入子元素；若需混合内容或复杂结构，必须改用xs:complexType。
不能直接在 xs:simpleContent 里嵌套 xs:element 或 xs:attributeGroup —— 这是常见报错根源，不是你写错了路径或命名空间，而是 XSD 语义本身禁止。
为什么 xs:simpleContent 下不能放子元素
XSD 规范明确定义：xs:simpleContent 只能包装一个 xs:extension 或 xs:restriction，且该子元素**只能添加属性（xs:attribute）或限制/扩展基类型（如 xs:string），不能引入新内容模型（比如子元素）**。一旦你在里面写了 xs:element，解析器（如 Xerces、libxml2）会立刻报类似 cos-nonambig: element 'xxx' conflicts with element 'yyy' 或更直白的 Invalid content was found starting with element 'xs:element'。
常见错误场景：
- 想给一个带文本值的标签同时加属性和子节点（比如
<price currency="USD">19.99<discount>2.0</discount></price>）→ 这已经不是简单内容，得用xs:complexType+xs:sequence。 - 复制了别人带
xs:element的 complexContent 片段，却粘贴到了 simpleContent 块里。 - 误以为
xs:simpleContent是“简化版 complexContent”，其实二者是互斥的内容模型分支。
xs:extension 里只能加 xs:attribute，不能加 xs:attributeGroup？
可以加，但必须确保 xs:attributeGroup 本身只包含合法属性声明（xs:attribute），且没有循环引用。XSD 1.0 允许在 xs:extension 内直接使用 xs:attributeGroup，但部分老工具（如早期 .NET XML Schema Validator）可能不支持嵌套引用，导致校验失败。
实操建议：
- 优先展开
xs:attributeGroup成独立xs:attribute，避免兼容性问题。 - 如果必须复用，确认工具链支持 XSD 1.1（如 Saxon-EE），或至少用 Xerces-J 3.2+。
- 检查
xs:attributeGroup定义是否在当前 schema 或已xs:include的文件中 —— 路径错、命名空间没对齐，会导致 “attribute group not found” 错误。
什么时候该放弃 xs:simpleContent，改用 xs:complexType
只要 XML 实例中可能出现以下任一情况，就必须换：
- 元素内既有文本，又有子元素（哪怕只有一个）
- 需要控制子元素顺序（
xs:sequence）、可选性（xs:choice）或重复（maxOccurs） - 想让文本内容本身参与约束（比如用
xs:pattern限定数字格式），但又需要附加属性 —— 此时xs:simpleContent+xs:extension只能约束基类型，无法对混合内容建模
示例：下面这个结构合法，但必须用 complexType：
<xs:complexType name="priceType">
<xs:sequence>
<xs:element name="value" type="xs:decimal"/>
<xs:element name="currency" type="xs:string"/>
</xs:sequence>
<xs:attribute name="source" type="xs:string"/>
</xs:complexType>
真正容易被忽略的是：XSD 工具（如 IntelliJ 的 schema 编辑器、Oxygen）有时会静默忽略 simpleContent 内的非法子元素，只在运行时解析才暴露问题。别信 IDE 的绿色对勾，用真实 XML 实例跑一遍 xmllint --schema 或 java -jar xercesImpl.jar 校验才靠谱。
