XML Schema(XSD)怎么写？XSD入门教程详解

XML Schema（简称XSD）是用于定义XML文档结构、约束元素和属性合法性的规范，它可以明确XML中允许出现的元素、属性、数据类型以及元素之间的嵌套关系，是XML开发中常用的校验工具。编写XSD文件可以让我们提前约定XML的格式，避免不符合要求的XML数据被使用。

XSD文件的基础结构

一个标准的XSD文件本身也是XML格式，需要遵循XML的基本语法规则，它的根元素是<schema>，并且需要声明对应的命名空间。下面是XSD文件的基础结构示例：

<?xml version="1.0" encoding="UTF-8"?>
<schema xmlns="http://www.w3.org/2001/XMLSchema"
        targetNamespace="http://www.example.org/user"
        xmlns:tns="http://www.example.org/user"
        elementFormDefault="qualified">
    <!-- 这里编写具体的定义内容 -->
</schema>

其中<schema>标签的几个核心属性说明如下：

• xmlns：声明XSD使用的标准命名空间，固定为http://www.w3.org/2001/XMLSchema
• targetNamespace：定义当前XSD的目标命名空间，也就是使用该XSD的XML文档需要引用的命名空间
• xmlns:tns：给目标命名空间起一个前缀别名，方便在XSD内部引用自身定义的元素
• elementFormDefault：设置为qualified表示XML文档中的元素需要带命名空间前缀，设置为unqualified则不需要

定义简单元素

简单元素是指只包含文本内容，没有子元素和属性的元素，定义简单元素使用<element>标签，通过type属性指定元素的数据类型。XSD内置了很多常用的数据类型，比如string、int、boolean、date等。

下面是一个定义用户年龄元素的示例，要求年龄是整数类型：

<schema xmlns="http://www.w3.org/2001/XMLSchema"
        targetNamespace="http://www.example.org/user"
        xmlns:tns="http://www.example.org/user"
        elementFormDefault="qualified">
    <!-- 定义名为age的元素，数据类型为整数 -->
    <element name="age" type="int"/>
</schema>

如果需要限制简单元素的取值范围，还可以使用<simpleType>自定义简单类型，比如限制年龄只能在1到120之间：

<schema xmlns="http://www.w3.org/2001/XMLSchema"
        targetNamespace="http://www.example.org/user"
        xmlns:tns="http://www.example.org/user"
        elementFormDefault="qualified">
    <!-- 自定义年龄类型，限制取值范围 -->
    <simpleType name="ageType">
        <restriction base="int">
            <minInclusive value="1"/>
            <maxInclusive value="120"/>
        </restriction>
    </simpleType>
    <!-- 使用自定义类型定义age元素 -->
    <element name="age" type="tns:ageType"/>
</schema>

定义复杂元素

复杂元素是指包含子元素或者属性的元素，定义复杂元素同样使用<element>标签，但是需要通过<complexType>来定义元素的结构。复杂元素可以包含子元素序列、属性、选择组等内容。

下面是一个包含子元素和属性的用户信息复杂元素示例：

<schema xmlns="http://www.w3.org/2001/XMLSchema"
        targetNamespace="http://www.example.org/user"
        xmlns:tns="http://www.example.org/user"
        elementFormDefault="qualified">
    <!-- 定义用户复杂元素 -->
    <element name="user" type="tns:userType"/>
    <complexType name="userType">
        <sequence>
            <!-- 子元素按顺序出现 -->
            <element name="name" type="string"/>
            <element name="age" type="int"/>
            <element name="email" type="string" minOccurs="0"/>
        </sequence>
        <!-- 定义属性 -->
        <attribute name="id" type="int" use="required"/>
    </complexType>
</schema>

上面的示例中，<sequence>表示子元素必须按照定义的顺序出现，<attribute>定义元素的属性，use="required"表示属性是必填的，如果不设置use属性则属性是可选的，minOccurs="0"表示email子元素可以出现0次或1次，也就是可选的。

完整示例与校验

下面是一个完整的用户XSD文件，以及符合该XSD约束的XML文件示例：

XSD文件（user.xsd）：

<?xml version="1.0" encoding="UTF-8"?>
<schema xmlns="http://www.w3.org/2001/XMLSchema"
        targetNamespace="http://www.example.org/user"
        xmlns:tns="http://www.example.org/user"
        elementFormDefault="qualified">
    <element name="user" type="tns:userType"/>
    <complexType name="userType">
        <sequence>
            <element name="name" type="string"/>
            <element name="age" type="int"/>
            <element name="email" type="string" minOccurs="0"/>
        </sequence>
        <attribute name="id" type="int" use="required"/>
    </complexType>
</schema>

符合约束的XML文件（user.xml）：

<?xml version="1.0" encoding="UTF-8"?>
<user xmlns="http://www.example.org/user"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:schemaLocation="http://www.example.org/user user.xsd"
      id="1">
    <name>张三</name>
    <age>25</age>
    <email>zhangsan@ipipp.com</email>
</user>

XML文件中通过xsi:schemaLocation指定了XSD文件的位置，这样XML解析器就可以根据XSD的规则校验XML文件是否合法。如果XML中的元素、属性、数据类型不符合XSD的定义，校验时就会报错。

常见编写注意事项

• XSD文件本身是XML格式，必须严格遵循XML的语法规则，所有标签必须正确闭合，属性值必须用引号包裹
• 定义元素时如果使用了自定义类型，需要加上目标命名空间的前缀，比如上面的tns:userType
• 如果不需要复杂的命名空间配置，也可以不设置targetNamespace，此时XML文件不需要引用命名空间，编写会更简单，适合简单的场景
• 编写完成后可以使用XML编辑器的校验功能检查XSD语法是否正确，避免出现语法错误导致无法正常使用

XML_SchemaXSDxml数据类型修改时间：2026-06-12 10:24:27