存储本地化字符串：属性与复杂类型的使用对比分析

嘿，我来帮你拆解这个本地化XML的设计问题，还有对应的XSD约束——这在多语言项目里简直是日常操作！先从两种典型的本地化结构说起（我猜这就是你构思的a、b方案，要是和你想的不一样，随时喊我调整）：

方案A：带lang属性的通用本地化子元素 #

这种方案把每个语言的文本都放在同一个<localized>元素里，用lang属性标记语言代码，结构大概是这样：

<text>
  <localized lang="en">Hello World</localized>
  <localized lang="fr">Bonjour le monde</localized>
  <localized lang="de">Hallo Welt</localized>
</text>

优点 #

• 灵活性拉满：新增语言完全不需要修改XML结构，直接加个新的<localized>元素就行，适配性超强
• 扩展性好：要是以后需要给某个语言加额外元数据（比如区分美式/英式英语的region属性，或者翻译状态status），直接给<localized>加属性就行
• 查询方便：用XPath找特定语言的文本超简单，比如//localized[@lang='en']就能精准定位英文内容

缺点 #

• 验证英文必填稍复杂：要在XSD里用key和keyref来强制至少存在一个lang="en"的元素，比方案B的约束写法繁琐一点
• 视觉上不够紧凑：语言多的时候，一堆<localized>元素堆在一起，可读性不如方案B直观

方案B：按语言命名的子元素 #

这种方案把每个语言作为独立的子元素，直接用语言代码当元素名，结构如下：

<text>
  <en>Hello World</en>
  <fr>Bonjour le monde</fr>
  <de>Hallo Welt</de>
</text>

优点 #

• 可读性极强：一眼扫过去就能清楚看到所有语言的文本，结构非常直观
• XSD验证简单：英文必填直接设<xs:element name="en" minOccurs="1"/>就行，编辑器还能根据枚举自动提示合法的语言元素名
• 访问直接：在代码里读取特定语言的文本时，不需要遍历属性，直接通过元素名获取（比如text.en），逻辑更简洁

缺点 #

• 扩展性差：新增语言必须修改XSD（更新枚举、新增对应元素），没法动态扩展
• 难以添加元数据：每个语言元素是纯文本，没法像方案A那样给单个语言加额外属性
• 查询稍麻烦：XPath要写//text/en，如果要动态切换语言，得拼接元素名，不如方案A的属性查询灵活

对应两种方案的XSD实现 #

接下来咱用枚举定义所有支持的语言，然后分别写出两种方案的XSD，确保XML符合要求：

方案A的XSD（带lang属性） #

<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <!-- 定义支持的语言枚举，按需添加更多语言 -->
  <xs:simpleType name="LanguageCode">
    <xs:restriction base="xs:string">
      <xs:enumeration value="en"/>
      <xs:enumeration value="fr"/>
      <xs:enumeration value="de"/>
      <xs:enumeration value="es"/>
    </xs:restriction>
  </xs:simpleType>

  <!-- 单个文本字段的本地化结构 -->
  <xs:complexType name="LocalizedText">
    <xs:sequence>
      <xs:element name="localized" maxOccurs="unbounded">
        <xs:complexType>
          <xs:simpleContent>
            <xs:extension base="xs:string">
              <!-- 强制lang属性必须是枚举中的值 -->
              <xs:attribute name="lang" type="LanguageCode" use="required"/>
            </xs:extension>
          </xs:simpleContent>
        </xs:complexType>
      </xs:element>
    </xs:sequence>

    <!-- 约束1：每个语言只能出现一次 -->
    <xs:unique name="uniqueLang">
      <xs:selector xpath="localized"/>
      <xs:field xpath="@lang"/>
    </xs:unique>

    <!-- 约束2：必须存在至少一个英文本地化 -->
    <xs:key name="enLangKey">
      <xs:selector xpath="localized"/>
      <xs:field xpath="@lang"/>
    </xs:key>
    <xs:keyref name="enRequired" refer="enLangKey">
      <xs:selector xpath="."/>
      <xs:field xpath="localized[@lang='en']/@lang"/>
    </xs:keyref>
  </xs:complexType>

  <!-- 根元素示例 -->
  <xs:element name="localizedStrings">
    <xs:complexType>
      <xs:sequence>
        <xs:element name="text" type="LocalizedText" maxOccurs="unbounded"/>
      </xs:sequence>
    </xs:complexType>
  </xs:element>
</xsd>

方案B的XSD（按语言命名元素） #

<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <!-- 定义支持的语言枚举 -->
  <xs:simpleType name="LanguageCode">
    <xs:restriction base="xs:string">
      <xs:enumeration value="en"/>
      <xs:enumeration value="fr"/>
      <xs:enumeration value="de"/>
      <xs:enumeration value="es"/>
    </xs:restriction>
  </xs:simpleType>

  <!-- 单个文本字段的本地化结构 -->
  <xs:complexType name="LocalizedText">
    <xs:all>
      <!-- 英文必填，其他语言可选 -->
      <xs:element name="en" type="xs:string" minOccurs="1"/>
      <xs:element name="fr" type="xs:string" minOccurs="0"/>
      <xs:element name="de" type="xs:string" minOccurs="0"/>
      <xs:element name="es" type="xs:string" minOccurs="0"/>
    </xs:all>
  </xs:complexType>

  <!-- 根元素示例 -->
  <xs:element name="localizedStrings">
    <xs:complexType>
      <xs:sequence>
        <xs:element name="text" type="LocalizedText" maxOccurs="unbounded"/>
      </xs:sequence>
    </xs:complexType>
  </xs:element>
</xsd>

最后给个小建议 #

• 如果你的项目语言需求比较稳定，很少新增语言，方案B更合适，直观又好维护
• 如果语言可能频繁新增，或者需要给本地化文本加额外元数据，方案A是更灵活的选择

内容的提问来源于stack exchange，提问作者Maroš Beťko