Go语言的国际化(i18n)与本地化(l10n)

发表于： 分类于：

Go语言中，大多数消息都是在fmt和template包中输出，所以，在处理国际化时，也从这两个方向出发。

golang.org/x/text包提供了一些子包，用于处理国际化。本文简单介绍一些常用的场景。

消息与Catalogs

消息是要传递给用户的某种形式的内容。每个消息都有一个key,可以有多种语言形式。message子包提供了NewPrinter函数，此函数返回一个Printfer实例，Printer实现了fmt风格的API方法。

package main

import (
	"golang.org/x/text/language"
	"golang.org/x/text/message"
)

func main() {
	msg := "happy new year"

	message.SetString(language.SimplifiedChinese, msg, "%d 年快乐\n")
	message.SetString(language.German, msg, "%d Frohes neues jahr\n")
	message.SetString(language.AmericanEnglish, msg, "happy %d\n")

	scp := message.NewPrinter(language.SimplifiedChinese)
	scp.Printf(msg, 2019)
	gp := message.NewPrinter(language.German)
	gp.Printf(msg, 2019)
	aep := message.NewPrinter(language.AmericanEnglish)
	aep.Printf(msg, 2019)
}

输出

2,019 年快乐
2.019 Frohes neues jahr
happy 2,019

注意此处的2019不同语言对数字进行了不同的格式化处理，同时使用了不同的语言来输出。

message.SetString和message.NewPrinter函数都需要一个Language Tag参数，Language Tag实例可以使用以下方式创建

  • 使用预设值
language.SimplifiedChinese
language.German
language.AmericanEnglish
  • 使用语言字符串创建
language.Make("el")
language.Parse("en-UK")
  • 组合方式
ja, _ := language.ParseBase("ja")
jp, _ := language.ParseRegion("JP")
jpLngTag, _ := language.Compose(ja, jp)
fmt.Println(jpLngTag)

如果组织了一个无效的Language Tag，方法会返回一个Und（表示Undefined Tag）和一个error.

为了输出不同语言的消息，需要事先将消息的翻译内容放到Catalog中。message.SetString和Printer.Printf函数输入的key是严格判等，如果printf时无法匹配到，将默认使用key的内容做为fmt方法的参数。

package main

import (
	"golang.org/x/text/language"
	"golang.org/x/text/message"
)

func main() {
	msg := "happy new year"

	message.SetString(language.SimplifiedChinese, msg, "%d 年快乐\n")
	message.SetString(language.German, msg, "%d Frohes neues jahr\n")
	message.SetString(language.AmericanEnglish, msg, "happy %d\n")

	scp := message.NewPrinter(language.SimplifiedChinese)
	scp.Printf(msg, 2019)
	gp := message.NewPrinter(language.German)
	gp.Printf(msg, 2019)
	aep := message.NewPrinter(language.AmericanEnglish)
	aep.Printf("happy new Year", 2019)
}

输出

2,019 年快乐
2.019 Frohes neues jahr
happy new Year

最后一个输出，因为Key不匹配，所以用happy new Year做为fmt.Printf的参数进行输出。

catalog.Builder

复数的处理

有时程序需要跟据事物的数量进行一些格式化，golang.org/x/text/feature/plural导出了一个SelectF函数，用于多语言中处理复数。

package main

import (
	"golang.org/x/text/feature/plural"
	"golang.org/x/text/language"
	"golang.org/x/text/message"
)

func main() {
	msg := "eat apple"
	message.Set(
		language.SimplifiedChinese, msg,
		plural.Selectf(
			1, "%d",
			"=1", "我吃了一个苹果\n",
			"=2", "我吃了两个苹果\n",
			"=3", "我吃了三个苹果\n",
			"=4", "我吃了四个苹果\n",
			"=5", "我吃了五个苹果\n",
			"other", "我吃了好多个苹果\n",
		),
	)

	scp := message.NewPrinter(language.SimplifiedChinese)
	scp.Printf(msg, 1)
	scp.Printf(msg, 2)
	scp.Printf(msg, 3)
	scp.Printf(msg, 4)
	scp.Printf(msg, 5)
	scp.Printf(msg, 10)
}

输出

我吃了一个苹果
我吃了两个苹果
我吃了三个苹果
我吃了四个苹果
我吃了五个苹果
我吃了好多个苹果

SelectF函数的参数有一些变体，比如：zero , one , two , few ,many，也支持比较操作> , >= , < , <=。

字符串注入

在处理文本过程中，可以指定占位符变量的方式来处理某些特定的语言特征情况。

package main

import (
	"golang.org/x/text/feature/plural"
	"golang.org/x/text/language"
	"golang.org/x/text/message"
	"golang.org/x/text/message/catalog"
)

func main() {
	msg := "eat apple"
	message.Set(
		language.SimplifiedChinese, msg,
		catalog.Var("number",
			plural.Selectf(1, "%d",
				"=1", "一",
				"=2", "两",
				"=3", "三",
				"=4", "四",
				"=5", "五",
				"other", "好多",
			),
		),
		catalog.String("我吃了 ${number} 个苹果\n"),
	)

	scp := message.NewPrinter(language.SimplifiedChinese)
	scp.Printf(msg, 1)
	scp.Printf(msg, 2)
	scp.Printf(msg, 3)
	scp.Printf(msg, 4)
	scp.Printf(msg, 5)
	scp.Printf(msg, 10)
}

输出

我吃了 一 个苹果
我吃了 两 个苹果
我吃了 三 个苹果
我吃了 四 个苹果
我吃了 五 个苹果
我吃了 好多 个苹果

catalog.Var设置了一个number的变量，此变量跟据第一个参数的数值生成变体，在翻译语句中使用${number}的形式引用这个变量。

货币格式

golang.org/x/text/currency包提供了处理货币格式化规则的方法。

package main

import (
	"golang.org/x/text/currency"
	"golang.org/x/text/language"
	"golang.org/x/text/message"
)

func main() {
	msg := "apple price"
	message.SetString(language.SimplifiedChinese, msg, "苹果  : %f / kg\n")
	message.SetString(language.German, msg, "äpfel : %f / kg\n")
	message.SetString(language.AmericanEnglish, msg, "apple : %f / kg\n")

	scp := message.NewPrinter(language.SimplifiedChinese)
	scp.Printf(msg, currency.Symbol(currency.CNY.Amount(100.00)))
	gp := message.NewPrinter(language.German)
	gp.Printf(msg, currency.NarrowSymbol(currency.EUR.Amount(100.00)))
	aep := message.NewPrinter(language.AmericanEnglish)
	aep.Printf(msg, currency.ISO.Kind(currency.Cash)(currency.USD.Amount(100.00)))
}

输出

苹果  : ￥ 100.00 / kg
äpfel : € 100.00 / kg
apple : USD 100.00 / kg

以上是常用的一些国际化与本地化的操作，在实际的应用中，消息的翻译往往放在不同的配置文件中方便使用。可以使用配置文件格式解析库解析内容，初始化catalog并导出方法供应用调用。

常用国家语言代码

国家/地区语言代码
简体中文(中国)zh-cn
繁体中文(台湾地区)zh-tw
繁体中文(香港)zh-hk
英语(香港)en-hk
英语(美国)en-us
英语(英国)en-gb
英语(全球)en-ww
英语(加拿大)en-ca
英语(澳大利亚)en-au
英语(爱尔兰)en-ie
英语(芬兰)en-fi
芬兰语(芬兰)fi-fi
英语(丹麦)en-dk
丹麦语(丹麦)da-dk
英语(以色列)en-il
希伯来语(以色列)he-il
英语(南非)en-za
英语(印度)en-in
英语(挪威)en-no
英语(新加坡)en-sg
英语(新西兰)en-nz
英语(印度尼西亚)en-id
英语(菲律宾)en-ph
英语(泰国)en-th
英语(马来西亚)en-my
英语(阿拉伯)en-xa
韩文(韩国)ko-kr
日语(日本)ja-jp
荷兰语(荷兰)nl-nl
荷兰语(比利时)nl-be
葡萄牙语(葡萄牙)pt-pt
葡萄牙语(巴西)pt-br
法语(法国)fr-fr
法语(卢森堡)fr-lu
法语(瑞士)fr-ch
法语(比利时)fr-be
法语(加拿大)fr-ca
西班牙语(拉丁美洲)es-la
西班牙语(西班牙)es-es
西班牙语(阿根廷)es-ar
西班牙语(美国)es-us
西班牙语(墨西哥)es-mx
西班牙语(哥伦比亚)es-co
西班牙语(波多黎各)es-pr
德语(德国)de-de
德语(奥地利)de-at
德语(瑞士)de-ch
俄语(俄罗斯)ru-ru
意大利语(意大利)it-it
希腊语(希腊)el-gr
挪威语(挪威)no-no
匈牙利语(匈牙利)hu-hu
土耳其语(土耳其)tr-tr
捷克语(捷克共和国)cs-cz
斯洛文尼亚语sl-sl
波兰语(波兰)pl-pl
瑞典语(瑞典)sv-se
西班牙语 (智利)es-cl

参考链接

A Step-by-Step Guide to Go Internationalization (i18n) & Localization (l10n)