xs:complexContent extension 必须直接位于 xs:complexType 内，不可置于 xs:element 下；base 类型须为已声明且非 final 的复杂类型，且 extension 仅允许追加新元素或属性，不得重定义父类内容。
xs:complexContent extension 必须包裹在 xs:complexType 里
直接写 xs:complexContent 而不放在 xs:complexType 下，XSD 验证器会报错，比如：cos-element-consistent: Element 'xs:complexContent' cannot appear directly under 'xs:element'。这是因为 xs:complexContent 是用来定义复杂类型扩展的“内容模型”，它本身不是顶层类型声明，必须依附于一个 xs:complexType。
常见错误是想给某个 xs:element 直接加扩展，结果把 xs:complexContent 写在了 xs:element 下面——这是非法结构。
- 正确路径：
xs:element→xs:complexType→xs:complexContent→xs:extension - 扩展的目标类型（
base属性）必须是已定义的xs:complexType，不能是简单类型或未声明的名称 - 如果 base 类型本身含
xs:simpleContent，就不能再用xs:complexContent扩展；反之亦然
extension 的 base 类型必须可访问且非 final
xs:extension 的 base 属性指向的类型，必须在当前 XSD 文档中已定义，或通过 xs:import/xs:include 可见。否则会报类似 src-resolve: Cannot resolve the name 'xxx' to a(n) 'type definition' component 的错误。
另一个常被忽略的点：目标类型不能被标记为 final="#all" 或 final="extension"。一旦设了，就禁止被 xs:extension 继承。
- 检查 base 类型定义处是否有
final属性，尤其来自第三方 Schema 时 - 跨命名空间引用时，确保
xs:import的namespace和schemaLocation匹配，且目标 namespace 中确实存在该类型 - 别用本地匿名类型作 base —— 匿名类型没有名字，无法被
base引用
extension 内部只能添加元素/属性，不能重定义父类内容
xs:extension 的作用是“在父类型基础上追加”，不是覆盖或修改。所以你不能在 xs:extension 里重新声明父类已有的元素、属性，也不能改变它们的类型、出现次数（minOccurs/maxOccurs）或顺序。
典型错误现象：验证时没报错，但 XML 实例校验失败，提示某元素“unexpected”或“not allowed here”——往往是因为子类型里重复写了父类已有元素，导致内容模型冲突。
- 只允许在
xs:extension内新增xs:element、xs:attribute、xs:group等 - 若需调整父类字段约束（如让某属性变为必填），必须修改原 base 类型，不能在 extension 里“覆盖”
- 顺序敏感：新元素插入位置影响有效内容模型，特别是当 base 类型使用
xs:sequence时，追加元素只能放在末尾
工具链对 xs:complexContent extension 的兼容性差异
Java 的 JAXB、.NET 的 Xsd.exe、Python 的 lxml 都支持 xs:complexContent + xs:extension，但生成代码时行为不同。比如 JAXB 默认把 extension 映射为 Java 继承关系，而某些 JSON Schema 转换器会扁平化处理，丢掉继承语义。
更隐蔽的问题是 IDE 支持度：VS Code 的 XML 插件可能不校验 base 是否被 final 限制，但运行时 Xerces 或 Saxon 就会严格报错。
- 生产环境建议用命令行工具预验证：
xmllint --schema your.xsd test.xml或saxon -val:strict your.xsd - 避免在 extension 中嵌套太深的
xs:choice或xs:all，部分解析器对复杂组合支持不一致 - 如果最终要生成 TypeScript 接口，注意大多数 XSD-to-TS 工具不保留继承，而是展开为联合类型或冗余字段
真正麻烦的从来不是写对 extension，而是 base 类型藏在另一个文件里、被 import 多次、又被别人悄悄加了 final —— 查的时候得顺着 import 链一路翻到底。
