Go x/text/language Compose 怎样组合语言与地区标签

在多语言接口里，语言和地区通常来自不同字段：语言可能是 zh，地区可能是 TW。如果直接拼接字符串，大小写、重复部件和错误处理很容易混在一起。golang.org/x/text/language 的 Compose 专门把这些已经解析出的部件组合成一个 language.Tag。

官方地址：https://pkg.go.dev/golang.org/x/text/language

最小写法是先用 ParseBase 和 ParseRegion 得到语言与地区，再调用 language.Compose(base, region)。它返回 (Tag, error)；真正放进业务对象前，应该保留并处理解析错误。

Compose 解决的是“组合已解析部件”

Compose 的参数是可变参数，文档列出的部件类型包括 Tag、Base、Script、Region、Variant、[]Variant、Extension、[]Extension 和 error。所以它更像一个语言标签的组装边界，而不是把任意字符串直接拼接成 BCP 47 标签。

这一区分很重要：ParseBase 与 ParseRegion 负责把外部文本变成有类型的部件，Compose 负责把这些部件放到同一个 Tag 中。输入来自 HTTP 参数、配置文件或数据库时，先解析再组合，排错位置会更清楚。

用 Base 和 Region 组合语言与地区

下面的例子对应最常见的业务场景：语言与地区是两个独立配置项。解析函数的错误不能忽略，否则非法值可能在后续逻辑里变成一个看似正常但含义不对的标签。

package main

import (
    "fmt"

    "golang.org/x/text/language"
)

func main() {
    // 先把外部文本解析为有类型的语言部件。
    base, err := language.ParseBase("zh")
    if err != nil {
        panic(fmt.Errorf("解析语言失败: %w", err))
    }

    // 地区使用 ISO 3166-1 alpha-2 形式，这里组合繁体中文地区。
    region, err := language.ParseRegion("TW")
    if err != nil {
        panic(fmt.Errorf("解析地区失败: %w", err))
    }

    // Compose 返回一个 Tag 和可能的组合错误。
    tag, err := language.Compose(base, region)
    if err != nil {
        panic(fmt.Errorf("组合语言标签失败: %w", err))
    }
    fmt.Println(tag.String())
}

这个组合的目标是得到 zh-TW。代码里没有手写连字符，也没有自己判断地区字母大小写；每个部件先经过包的解析规则，再由 Compose 生成 Tag。

已有 Tag 放在前面，后续部件可以覆盖它

当程序已经拿到一个完整标签，只想替换其中的语言或地区时，可以把已有 Tag 作为第一个部件。官方文档明确说明：一个 Tag 会覆盖此前部件的全部值，通常只适合作为第一个参数。

package main

import (
    "fmt"

    "golang.org/x/text/language"
)

func main() {
    // 先保留日文标签，再解析希望替换进去的美国地区。
    original := language.MustParse("ja-JP")
    us := language.MustParseRegion("US")

    // 后面的 Region 会替换原 Tag 中的地区，结果表达为 ja-US。
    replaced, err := language.Compose(original, us)
    if err != nil {
        panic(fmt.Errorf("替换地区失败: %w", err))
    }
    fmt.Println(replaced)

    // 同一种 Base 或 Region 出现多次时，后者覆盖前者。
    en := language.MustParseBase("en")
    zh := language.MustParseBase("zh")
    combined, err := language.Compose(en, zh, us)
    if err != nil {
        panic(fmt.Errorf("处理重复部件失败: %w", err))
    }
    fmt.Println(combined)
}

因此，组装函数的参数顺序不能随意改。若调用方允许用户覆盖默认语言，应把“默认部件”和“用户部件”的优先级写在函数接口里，而不是把多个来源的部件无说明地堆到一起。

Variant 与 Extension 是累积项

覆盖和累积是 Compose 最容易记混的两套规则：

如果要删除已有标签的某一类信息，也不要把空字符串当作“删除指令”。文档示例使用空的 language.Base{}、[]language.Variant{} 或 []language.Extension{} 来清除对应部件；要清除变体与扩展，则可以传入 de.Raw() 这样的原始标签。

默认规范化与 CanonType.Compose 怎么选

language.Compose 使用默认的 CanonType 进行规范化。如果需要明确控制规范化强度，可以调用 language.All.Compose、language.BCP47.Compose 或其他 CanonType 的方法。

package main

import (
    "fmt"

    "golang.org/x/text/language"
)

func main() {
    // Raw.Parse 保留原始部件，便于比较不同规范化策略。
    raw, err := language.Raw.Parse("en-Latn-UK")
    if err != nil {
        panic(fmt.Errorf("解析原始标签失败: %w", err))
    }

    // 默认 Compose 会按默认 CanonType 处理标签。
    defaultTag, err := language.Compose(raw)
    if err != nil {
        panic(fmt.Errorf("默认规范化失败: %w", err))
    }

    // All.Compose 会应用更完整的规范化规则。
    allTag, err := language.All.Compose(raw)
    if err != nil {
        panic(fmt.Errorf("完整规范化失败: %w", err))
    }
    fmt.Println("默认:", defaultTag)
    fmt.Println("All:", allTag)
}

官方示例展示了这两种策略的差异：默认结果保留了 Latn 信息并把 UK 规范为 GB；使用 All 时还会移除可省略的脚本，得到更简化的表示。这里的重点不是追求“最短字符串”，而是让规范化规则与业务的比较、存储或展示需求一致。

把错误留在组合边界

Compose 会返回遇到的错误；如果某个输入已经是带错误的多返回值，错误可能会被传入并返回。因此，面向外部输入时建议封装一个只返回 (language.Tag, error) 的小函数，把解析和组合放在同一个边界内。

func composeLocale(langText, regionText string) (language.Tag, error) {
    // 语言和地区分别解析，错误信息可以直接定位输入字段。
    base, err := language.ParseBase(langText)
    if err != nil {
        return language.Und, fmt.Errorf("语言 %q 无效: %w", langText, err)
    }
    region, err := language.ParseRegion(regionText)
    if err != nil {
        return language.Und, fmt.Errorf("地区 %q 无效: %w", regionText, err)
    }

    // 组合阶段的错误仍然向上返回，不把 Und 当成成功结果。
    tag, err := language.Compose(base, region)
    if err != nil {
        return language.Und, fmt.Errorf("组合标签失败: %w", err)
    }
    return tag, nil
}

这个片段假设文件已经导入 fmt 与 golang.org/x/text/language。如果业务允许缺省地区，应在调用这个函数之前决定缺省策略；不要在函数内部悄悄把任何解析失败改成默认地区。

什么时候该用 Compose

可以按输入形态做一个简单选择：

一句话总结：Compose 适合“我已经知道每个部件代表什么，现在要把它们合成一个 Tag”；如果手里只有一段完整文本，先考虑 Parse，不要为了使用 Compose 而拆字符串。

常见问题

Compose 能直接接收字符串吗？

不应把它当作字符串拼接函数使用。先用 Parse、ParseBase 或 ParseRegion 把文本转换为包支持的类型，再传给 Compose。

重复传入两个 Region 会怎样？

同类部件重复时，后出现的部件覆盖前者。这个规则适合表达“用户选择覆盖默认地区”，但调用代码应该清楚地组织参数来源。

为什么 Compose 返回的标签和输入字符串不完全一样？

因为 Compose 会按所选 CanonType 规范化。默认策略、BCP47 和 All 的处理强度不同，结果可能保留或删除脚本、旧式标识等信息。

解析失败后可以继续用返回的 Tag 吗？

外部输入场景不建议这样做。解析函数可能返回部分解析结果，但业务应优先处理错误；只有明确设计了容错策略时，才把部分结果作为降级信息保存。