xs:attributeGroup 的 name 必须是合法 QName，仅能通过 ref 引用已声明的全局属性组，禁止嵌套引用，且同一命名空间下不得与其他全局组件重名。
xs:attributeGroup 的 name 属性必须是合法的 QName
XML Schema 中 xs:attributeGroup 的 name 不是随便起的字符串，它得是符合 XML 命名规则的 QName（带可选前缀的限定名），否则解析器直接报错。
- 常见错误现象：
Invalid QName: 'my-attr-group'或Schema validation failed: The value of attribute 'name' is invalid - name 不能含空格、冒号（除非是命名空间前缀分隔符）、连字符、数字开头（如
1group）、点号等 - 合法示例：
name="addressAttrs"、name="tns:personAttributes"（前提是tns已在 schema 中用xmlns:tns="..."声明） - 不合法示例：
name="my-attr-group"、name="2ndGroup"、name="addr.group"
引用 xs:attributeGroup 时必须用 ref，不能直接嵌套定义
你不能在 xs:complexType 里把 xs:attributeGroup 的内容“抄进去”，必须通过 ref 引用已声明的 name，否则 Schema 无效。
- 使用场景：复用一组属性（比如
id、version、lang）到多个类型中 - 正确写法：
<attributegroup ref="commonAttrs"></attributegroup>，且该commonAttrs必须已在同 schema 或 import/include 的 schema 中定义 - 错误写法：
<attributegroup><attribute name="id" type="xs:ID"></attribute></attributegroup>（这属于匿名定义，ref 不认） - 性能影响：ref 是编译期绑定，无运行时开销；但若跨文件引用，需确保
xs:include或xs:import路径正确，否则校验失败
name 冲突会导致 XSD 解析失败，且错误提示往往不直观
同一个 targetNamespace 下，xs:attributeGroup 的 name 不能和 xs:element、xs:complexType、xs:simpleType 等其他全局声明重名——不是警告，是硬性冲突。
- 常见错误现象：Xerces、Saxon 或 .NET XmlSchemaSet.Load() 报类似
Global component 'foo' has been already defined - 容易被忽略：不同 XSD 文件通过
xs:include合并时，看似独立的 name 实际会进入同一符号表 - 建议做法：为 attributeGroup 的 name 加统一前缀，比如
attg_（attg_personMeta），和 element 名（person）区分开 - 兼容性注意：部分老工具（如早期 IBM Rational）对 QName 大小写更敏感，
PersonAttrs和personattrs可能被当成不同名，但规范要求区分大小写
xs:attributeGroup 无法包含 xs:attributeGroup，只能 flat 引用
你不能在一个 xs:attributeGroup 里用 ref 引另一个 xs:attributeGroup 来做“组合”——XSD 1.0 不支持嵌套引用，所有属性最终必须展平到一个层级。
- 错误写法：
<attributegroup name="fullAddress"><attributegroup ref="streetAttrs"></attributegroup><attributegroup ref="geoAttrs"></attributegroup></attributegroup> - 正确做法：把
streetAttrs和geoAttrs的全部xs:attribute拷贝进fullAddress定义里，或改用xs:complexType+xs:complexContent组合（但那是类型继承，不是属性组复用） - 为什么这样做：XSD 规范明确限制
xs:attributeGroup的 content model 只能是xs:attribute、xs:attributeGroup（仅限顶层定义，非 ref）、xs:anyAttribute——但ref不被允许出现在 content 中 - 后果：强行嵌套会导致多数验证器静默忽略子
ref，或直接拒绝加载 schema
name 的合法性、引用方式、命名空间隔离、展平约束——这四点卡住大多数实际集成场景。尤其跨团队协作时，attributeGroup 名字一旦定死，改起来比改 element 还麻烦，因为牵扯所有 ref 点。
