XSD怎么定义一个列表类型xs:list

XSD即XML Schema Definition，是用于定义XML文档结构、约束元素和属性合法性的规范，xs:list是XSD中用于定义列表类型的核心元素，它可以将一个简单类型扩展为允许包含多个该类型值的列表结构。

xs:list的基础语法规则

xs:list必须作为简单类型定义的子元素存在，不能直接作为顶层元素定义，它的核心属性是itemType，用于指定列表中每个元素的类型。itemType的值可以是XSD内置的简单类型，也可以是用户自定义的其他简单类型。

基础的定义结构如下：

<xs:simpleType name="自定义列表类型名">
  <xs:list itemType="元素类型" />
</xs:simpleType>

使用内置类型定义列表

我们可以直接使用XSD内置的简单类型作为itemType的值，比如定义一组整数的列表，或者一组字符串的列表。

下面是一个定义整数列表的完整XSD示例：

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <!-- 定义整数列表类型 -->
  <xs:simpleType name="intList">
    <xs:list itemType="xs:integer" />
  </xs:simpleType>

  <!-- 定义使用该列表类型的元素 -->
  <xs:element name="scores" type="intList" />
</xs:schema>

对应的合法XML实例内容如下，列表中的多个值之间用空格分隔：

<?xml version="1.0" encoding="UTF-8"?>
<scores>90 85 92 88 95</scores>

使用自定义简单类型定义列表

如果内置类型无法满足需求，我们可以先定义自定义简单类型，再将其作为xs:list的itemType。比如先定义一个限制范围的年龄类型，再定义该年龄类型的列表。

完整示例如下：

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <!-- 自定义年龄简单类型，限制1到120之间 -->
  <xs:simpleType name="ageType">
    <xs:restriction base="xs:integer">
      <xs:minInclusive value="1" />
      <xs:maxInclusive value="120" />
    </xs:restriction>
  </xs:simpleType>

  <!-- 定义年龄列表类型 -->
  <xs:simpleType name="ageList">
    <xs:list itemType="ageType" />
  </xs:simpleType>

  <xs:element name="familyAges" type="ageList" />
</xs:schema>

对应的合法XML实例：

<?xml version="1.0" encoding="UTF-8"?>
<familyAges>32 30 5 60</familyAges>

注意事项

• 列表中的多个值必须使用空格分隔，不能使用逗号或者其他符号，否则XML校验会失败。
• xs:list只能用于简单类型，不能用于复杂类型，复杂类型如果需要多个值的结构，需要使用xs:sequence或者xs:choice定义子元素。
• 如果itemType是字符串类型，字符串本身不能包含空格，否则会被拆分为多个列表项。
• 定义列表类型时如果使用了自定义命名空间，itemType的值需要带上对应的命名空间前缀，比如itemType="my:customType"。

常见校验问题说明

当XML实例中的列表值不符合itemType的约束时，校验会报错。比如上面的ageList类型，如果实例中出现了130这个值，就会因为超出maxInclusive的限制导致校验失败。另外如果列表值为空，即元素内容为空字符串，对于列表类型来说是合法的，表示空列表，如果需要禁止空列表，需要额外添加长度限制。

添加非空限制的示例如下：

<xs:simpleType name="nonEmptyIntList">
  <xs:list itemType="xs:integer" />
  <xs:restriction base="xs:list">
    <xs:minLength value="1" />
  </xs:restriction>
</xs:simpleType>

XSDxs:listXML_Schema列表类型定义修改时间：2026-07-06 13:18:25