17370845950

xs:override 是 XML Schema 1.1 引入的安全重定义机制，用于在不修改原始 schema 文件的前提下，精确覆盖或增强已引入的类型、元素等定义，需严格匹配名称与类别，且仅支持 XSD 1.1 处理器。

xs:override 是 XML Schema 1.1 中引入的机制，用于安全地替换或增强已有的 schema 定义（比如来自 xs:include 或 xs:import 的类型、元素、属性等），而无需修改原始 schema 文件。它不是“覆盖”语义上的简单覆盖，而是有约束的、显式的重定义，必须严格遵循规则。

下面直接说明怎么用 xs:override 正确覆盖引入的 schema 定义：

前提：只能用于 XML Schema 1.1

确保你的处理器支持 XSD 1.1（如 Xerces-J 2.12+、Saxon EE、libxml2 2.9.12+）。XSD 1.0 不支持 `xs:override`，用了会报错。

语法结构：用 xs:override 包裹被覆盖的目标定义

你不能在任意位置写 `xs:override`。它必须是 schema 文档的**顶层元素之一**（和 `xs:include`、`xs:import` 同级），且其内容必须只包含对原 schema 中已存在组件的重定义 —— 且名称、种类（element/type/attribute 等）必须完全匹配。

例如，要覆盖 `common.xsd` 中定义的 `xs:complexType name="Person"`：

关键限制：什么能覆盖，什么不能

• 必须精确匹配名称和类别：`name="Person"` + `xs:complexType` 必须和 `common.xsd` 中声明的一模一样（包括是否带 `targetNamespace`）
• 不能新增组件：`xs:override` 内部只能出现已在被覆盖 schema 中存在的声明；多一个 `` 就算非法
• 不能改变顶层结构语义：比如把 `xs:simpleType` 改成 `xs:complexType`，或把全局元素改成局部元素 —— 这些不被允许
• 可以扩展/收紧约束：比如在原 `Person` 中增加可选字段、改 `minOccurs`、加 `xs:assert`、细化 `xs:restriction` —— 这些是典型合法用法

覆盖 import 的 schema 要注意命名空间

如果 `common.xsd` 是通过 `xs:import`（而非 `xs:include`）引入的，它必然有 `namespace`。此时 `xs:override` 的 `schemaLocation` 指向它，但内部重定义必须带上正确的 `targetNamespace`（或用 `xmlns:tns="..."` + `tns:Person`）。

例如 `common.xsd` 声明了 `targetNamespace="http://common.example"`，那么 override 片段应为：

基本上就这些。xs:override 不复杂但容易忽略版本和匹配精度，用对了就能解耦维护、实现渐进式 schema 升级。