Go x/text/language Parse 为什么不能当作任意字符串清洗器

Go 的 golang.org/x/text/language.Parse 解析的是 BCP 47 语言标签，例如 en-US、zh-Hant-TW 或带扩展的标签。它会返回结构化的 language.Tag，同时把格式错误或未知值通过 error 暴露出来，所以不能拿它当成“把任意脏字符串清洗成可用语言”的函数。

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

正确的做法是先确认输入是否应该被解释为语言标签，再根据 Parse 返回的 Tag 和 error 决定接受、提示或拒绝；不要因为得到一个非空 Tag 就把原始输入当成合法配置。

• 解析对象：BCP 47 语言标签，而不是普通文本、文件名或用户昵称。
• 错误语义：格式解析失败会返回错误；未知值可能返回 ValueError 和去掉未知部分的 Tag。
• 默认策略：Make 会省略错误并给出合理默认值，适合明确允许兜底的场景。
• 固定配置：MustParse 适合确定正确的初始化常量，运行时不可信输入不要直接使用。

Parse 解析的到底是什么

language 包实现的是 BCP 47 语言标签和相关匹配能力。一个标签可能由语言、脚本、地区、变体和扩展组成，Parse 的结果是可交给语言匹配、大小写转换或排序组件使用的 Tag。这和删除空格、替换非法字符、截断长度等字符串清洗任务没有关系。

例如 zh-Hant-TW 可以表达语言、脚本和地区三个部分；u-ca-gregory 是 Unicode 扩展。它们需要保留给后续本地化逻辑，而不是被粗暴地当成普通分隔字符串。Parse 的默认规范化也不是“把一切改成唯一形式”：官方文档说明，默认只处理部分过时或弃用标签，同时尽量保留有价值的信息。

先把 error 和部分 Tag 一起接住

不要写成只看 tag.String() 的逻辑。官方说明区分两类情况：无法继续按标签语法解析时返回错误和已解析部分；语法成立但出现未知值时返回 ValueError，返回的 Tag 会去掉未知值。业务上是否接受这种结果，应由产品规则决定。

package main

import (
	"fmt"

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

func parseUserLanguage(raw string) (language.Tag, error) {
	// Parse 只负责识别 BCP 47 标签，不把任意文本转换成语言。
	tag, err := language.Parse(raw)
	if err != nil {
		// 调用方可以记录原始输入，但不要把部分 Tag 默认为合法配置。
		return language.Und, fmt.Errorf("invalid language tag %q: %w", raw, err)
	}
	return tag, nil
}

func main() {
	// 这里的输入来自用户配置，遇到错误时采用显式拒绝策略。
	tag, err := parseUserLanguage("zh-Hant-TW")
	if err != nil {
		fmt.Println(err)
		return
	}
	fmt.Println(tag.String())
}

如果输入来自用户、请求参数或数据库，通常应保留错误并在边界层给出可理解的提示。若业务允许“未知地区使用默认地区”，也应该在业务代码中明确记录这种兜底，而不是把所有错误静默吞掉。

Parse、Make 和 MustParse 怎么选

三者的区别不在于“清洗强弱”，而在于错误处理责任。Parse 返回 Tag 和 error，适合运行时输入；Make 是省略错误的便利封装，遇到问题会给出合理默认值；MustParse 在解析失败时直接 panic，适合程序员完全控制的固定初始化值。

package main

import (
	"fmt"

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

var supported = language.NewMatcher([]language.Tag{
	language.SimplifiedChinese,
	language.English,
})

func chooseLanguage(raw string) language.Tag {
	// 固定常量可以使用 MustParse；外部输入仍走 Parse 并显式兜底。
	fallback := language.MustParse("zh-CN")
	tag, err := language.Parse(raw)
	if err != nil {
		return fallback
	}
	matched, _ := supported.Match(tag)
	return matched
}

func main() {
	// 解析语言标签后再匹配支持列表，不把原始字符串直接交给本地化组件。
	fmt.Println(chooseLanguage("en-US").String())
}

解析后的 Tag 应该交给谁

解析完成后，Tag 可以进入 Matcher 做支持语言匹配，也可以作为 cases、collate 等本地化服务的初始化输入。匹配结果未必逐字等于支持列表中的某个标签，因为语言包会处理弃用标签、脚本和语言等价关系；因此展示值、匹配结果和原始输入应按不同字段保存。

如果你的真实需求只是“过滤控制字符”“限制长度”或“把任意文本转成安全标识符”，请另选针对该任务的清洗和校验规则。Parse 能帮你判断一个字符串是否可以被解释为语言标签，但不能替你定义业务合法性，也不能保证下游一定有对应翻译。

常见问题

Parse 返回了 Tag，是不是就代表输入合法？

不一定。必须同时检查 error。未知值可能让结果保留可解析部分，同时返回 ValueError；业务是否接受部分结果要由调用方决定。

为什么不用 Make 处理所有用户输入？

Make 会省略错误并提供合理默认值，这会隐藏用户输入错误。只有业务明确允许兜底时才使用，并且最好记录发生过默认化。

Accept-Language 可以直接传给 Parse 吗？

不建议。请求头通常是带逗号和质量权重的语言列表，应使用 ParseAcceptLanguage，再结合支持列表进行匹配。

什么时候可以用 MustParse？

当字符串是代码内固定且经过开发者确认的语言标签时可以使用。对用户输入、网络输入或可变配置使用它，错误会以 panic 结束当前流程。