测试云原生质量保障【免费下载链接】originConformance test suite for OpenShift项目地址https://gitcode.com/gh_mirrors/or/origin点击查看免费下载gettext-go 是 GNU gettext 国际化的纯 Go 实现。本文以vendor/github.com/chai2010/gettext-go/README.md为主线结合其源码逐层讲解安装、目录布局、Gettexter/FileSystem两大核心接口、PO/MO/JSON 三种消息目录的加载机制、复数形式规则以及 v0.1.0 到 v1.0.0 的完整 API 迁移对照表。读完本文你不仅能直接上手在 Go 项目中接入 gettext-go还能理解其语言探测、上下文msgctxt与复数翻译的底层实现原理。本仓库OpenShift Conformance test suite即 origin / openshift-tests在 vendor/github.com/chai2010/gettext-go 下内置了该库的完整源码可作为学习与二次开发的第一手材料。gettext-go 是什么gettext 是 GNU 提供的一套国际化i18n/本地化l10n标准程序代码中书写原始语言通常是英文的字符串翻译内容维护在.po/.mo消息目录文件中运行时根据用户的语言环境自动选择对应的译文。gettext-go 正是这套标准在 Go 语言中的移植实现其 README.md 将其定位为 GNU gettext for Go并标注曾被 Kubernetes 等项目引入使用README 原述。在 Go 生态中它常被嵌入到 CLI 工具、服务端程序中用于输出多语言消息。本仓库将其作为依赖以 vendor 方式内置目录中包含了四个 Go 包包职责gettext主包面向用户的翻译 APIGettext、NGettext、BindLocale、Getdata等poPO 文本格式的解析与生成po/file.gomoMO 二进制格式的解析与生成mo/file.goplural各语言的复数形式规则表plural/table.go安装与引入README 给出的安装方式非常简洁go get github.com/chai2010/gettext-go go run hello.go引入方式同样简单直接导入主包即可import github.com/chai2010/gettext-go说明在使用了 vendor 机制的仓库如本 origin 仓库中实际编译使用的是 vendor/github.com/chai2010/gettext-go 下的本地副本无需也无法通过网络再次拉取。更多文档信息可参考 godoc.org 与 go.dev 上的包文档README 原述。快速上手两个最小示例示例一实例式 APIREADME 给出的第一个示例演示了最直观的用法——通过gettext.New创建实例并指定语言package main import ( fmt github.com/chai2010/gettext-go ) func main() { gettext : gettext.New(hello, ./examples/locale).SetLanguage(zh_CN) fmt.Println(gettext.Gettext(Hello, world!)) // Output: 你好, 世界! }这里的调用链包含两个关键步骤gettext.New(hello, ./examples/locale)创建一个域domain为hello的翻译实例其消息目录根路径为./examples/locale.SetLanguage(zh_CN)将语言切换为简体中文随后Gettext(Hello, world!)就会去./examples/locale/zh_CN/LC_MESSAGES/hello.po中查找msgid Hello, world!对应的译文你好, 世界!。从源码看New(domain, path string, data ...interface{}) Gettexter最终调用newLocale完成实例构造gettext.go、locale.go。data是可变参数不传时按目录或文件路径加载传入时交给NewFS做智能分发详见下文 FileSystem 一节。示例二包级全局 API 三种数据源绑定第二个示例展示了面向全局的便捷函数风格内部使用defaultGettexter单例转发见 gettext.gopackage main import ( fmt github.com/chai2010/gettext-go ) func main() { gettext.SetLanguage(zh_CN) gettext.BindLocale(gettext.New(hello, locale)) // gettext.BindLocale(hello, locale) // from locale dir // gettext.BindLocale(hello, locale.zip) // from locale zip file // gettext.BindLocale(hello, locale.zip, zipData) // from embedded zip data // translate source text fmt.Println(gettext.Gettext(Hello, world!)) // Output: 你好, 世界! // if no msgctxt in PO file (only msgid and msgstr), // specify context as by fmt.Println(gettext.PGettext(, Hello, world!)) // Output: 你好, 世界! // translate resource fmt.Println(string(gettext.Getdata(poems.txt))) // Output: ... }这里有三个值得展开的要点三种数据来源被注释掉的BindLocale(hello, locale)系列是 v0.1.0 时代的写法字符串参数直接传路径v1.0.0 中统一改为BindLocale(New(...))传入Gettexter实例。三种绑定形态分别对应——普通目录、.zip压缩包、以及内存中已解压好的 zip 数据zipData。这一能力正是由FileSystem抽象提供的见下文。上下文msgctxt为空字符串当 PO 文件中只写了msgid/msgstr、没有msgctxt时需要显式使用PGettext(, Hello, world!)传入空上下文进行匹配。Gettext的源码实现正是PGettext(, msgid)的简写locale.go。资源文件翻译Getdata(poems.txt)会从$(root)/$(lang)/LC_RESOURCE/$(domain)/poems.txt读取对应语言的资源文件不只是文本消息图片、配置等任意资源都可以按语言分发。注意 README 原示例该行末尾多了一个右括号上文已修正为可编译形式。语言环境的自动探测gettext-go 在初始化时会自动探测当前语言环境。全局变量DefaultLanguage的定义gettext.go依赖 util.go 中的探测逻辑func getDefaultLanguage() string { if v : os.Getenv(LC_MESSAGES); v ! { return simplifiedLanguage(v) } if v : os.Getenv(LANG); v ! { return simplifiedLanguage(v) } return default }探测顺序为LC_MESSAGES环境变量 →LANG环境变量 → 兜底值default。simplifiedLanguage会对语言串做规范化去掉:locale 列表、修饰符如el_GReuro和.编码后缀如en_US.UTF-8最终得到zh_CN、en_US这类纯语言标识。例如en_US.UTF-8→en_USel_GReuro→el_GRzh_CN→zh_CNSetLanguage/SetDomain遵循空串只读、非空串才写入的语义gettext.go即SetLanguage()仅返回当前语言不会重置它。翻译目录布局locale 约定无论是本地目录还是 zip 压缩包gettext-go 都遵循同一套目录约定doc.go 中给出了完整结构$(root)/ -default # locale: $(LC_MESSAGES) 或 $(LANG) 或 default | -LC_MESSAGES # 仅供 gettext.Gettext 使用 | | -hello.mo # $(Root)/$(lang)/LC_MESSAGES/$(domain).mo | | -hello.po # $(Root)/$(lang)/LC_MESSAGES/$(domain).po | | \-hello.json # $(Root)/$(lang)/LC_MESSAGES/$(domain).json | | | \-LC_RESOURCE # 仅供 gettext.Getdata 使用 | -hello # domain 对应资源目录 | -favicon.ico # $(Root)/$(lang)/LC_RESOURCE/$(domain)/$(filename) | \-poems.txt | \-zh_CN # 简体中文翻译 -LC_MESSAGES | -hello.po # 优先尝试 $(domain).po | -hello.mo # 其次尝试 $(domain).mo | \-hello.json # 再次尝试 $(domain).json | \-LC_RESOURCE -hello -favicon.ico \-poems.txt关键约定消息目录位于$(root)/$(lang)/LC_MESSAGES/下文件名即$(domain).po/$(domain).mo/$(domain).json资源目录位于$(root)/$(lang)/LC_RESOURCE/$(domain)/下文件名即原始资源名加载顺序固定为.po→.mo→.json先命中者胜出。这一顺序写死在 locale.go 的syncTrMap中依次尝试LoadMessagesFile(domain, lang, .po)、LoadMessagesFile(domain, lang, .mo)、LoadMessagesFile(domain, lang, .json)全部失败则回退到nilTranslator此时翻译请求原样返回 msgid。目录路径的拼接逻辑在 fs_os.go 中func (p *osFS) makeMessagesFileName(domain, lang, ext string) string { return fmt.Sprintf(%s/%s/LC_MESSAGES/%s%s, p.root, lang, domain, ext) } func (p *osFS) makeResourceFileName(domain, lang, name string) string { return fmt.Sprintf(%s/%s/LC_RESOURCE/%s/%s, p.root, lang, domain, name) }核心接口一Gettexterv1.0.0 将翻译能力收敛为一个Gettexter接口gettext.gotype Gettexter interface { FileSystem() FileSystem GetDomain() string SetDomain(domain string) Gettexter GetLanguage() string SetLanguage(lang string) Gettexter Gettext(msgid string) string PGettext(msgctxt, msgid string) string NGettext(msgid, msgidPlural string, n int) string PNGettext(msgctxt, msgid, msgidPlural string, n int) string DGettext(domain, msgid string) string DPGettext(domain, msgctxt, msgid string) string DNGettext(domain, msgid, msgidPlural string, n int) string DPNGettext(domain, msgctxt, msgid, msgidPlural string, n int) string Getdata(name string) []byte DGetdata(domain, name string) []byte } func New(domain, path string, data ...interface{}) Gettexter接口中的方法可以分为五组含义与 GNU gettext 同名函数一一对应方法作用Gettext/PGettext单数翻译PGettext额外携带上下文msgctxtNGettext/PNGettext复数翻译根据数值n选择正确的复数形式DGettext/DPGettext/DNGettext/DPNGettext带D前缀的版本显式指定 domain域可在运行时临时切换消息目录Getdata/DGetdata按语言获取资源文件内容FileSystem/GetDomain/SetDomain/GetLanguage/SetLanguage数据源访问与状态管理D前缀方法并不修改实例的当前 domain而是在本次调用内按传入的 domain 查表翻译locale.gofunc (p *_Locale) gettext(domain, msgctxt, msgid, msgidPlural string, n int) string { if f, ok : p.trMap[p.makeTrMapKey(domain, p.lang)]; ok { return f.PNGettext(msgctxt, msgid, msgidPlural, n) } return msgid }接口的实现是_Locale结构locale.go内部维护fs数据源、lang语言、domain域以及一个以domain_$$$_lang为键的翻译器缓存trMap并通过sync.Mutex保证并发安全。这意味着同一个Gettexter实例可以在多 goroutine 中安全共享。核心接口二FileSystem 抽象v1.0.0 引入FileSystem接口fs.go把翻译数据从哪里来这件事完全抽象化type FileSystem interface { LocaleList() []string LoadMessagesFile(domain, lang, ext string) ([]byte, error) LoadResourceFile(domain, lang, name string) ([]byte, error) String() string } func NewFS(name string, x interface{}) FileSystem func OS(root string) FileSystem func ZipFS(r *zip.Reader, name string) FileSystem func NilFS(name string) FileSystem四种内置实现对应四种数据来源实现数据来源构造方式osFS本地文件系统目录或本地.zip/.json文件自动识别OS(root)zipFS已打开的*zip.Reader内存数据ZipFS(r, name)jsonFS符合特定结构的 JSON 数据由NewFS内部分发nilFS空实现任何加载都返回错误NilFS(name)NewFS的分发逻辑fs.go很巧妙当传入的x是[]byte或string时先尝试按 zip 格式解析成功则ZipFS再尝试按 JSON 格式解析成功则jsonFS都失败则回退NilFS当x本身已是FileSystem时直接复用x为空则退化为OS(name)。以OS为例newOsFSfs_os.go还会在构造时做二次识别如果路径指向一个以.zip结尾的文件自动读入并转成ZipFS如果以.json结尾则尝试转成jsonFS。因此New(hello, locale.zip)与New(hello, locale.zip, zipData)最终都会落到 zip 数据源上——区别只是 zip 数据来自文件还是内存。这一点对在 Go 二进制中内嵌翻译数据静态编译、无需部署额外语言文件尤其有价值。JSON 数据源的结构fs_json.go约定为按语言分组{ zh_CN: { LC_MESSAGES: { hello.po: [ {msgctxt: , msgid: Hello, world!, msgstr: [你好, 世界!]} ] }, LC_RESOURCE: { hello: {poems.txt: ...} } } }注意 JSON 的msgstr是字符串数组对应复数形式单个字符串时取[0]tr.go。包级便捷函数与翻译查找原理除实例 API 外gettext-go 还提供了与 GNU gettext 同名的包级函数全部委托给内部单例defaultGettextergettext.goGettext(msgid)等价于PGettext(, msgid)PGettext(msgctxt, msgid)带上下文翻译NGettext(msgid, msgidPlural, n)复数翻译PNGettext(msgctxt, msgid, msgidPlural, n)带上下文的复数翻译DGettext / DPGettext / DNGettext / DPNGettext上述各函数的指定 domain 版本Getdata(name)/DGetdata(domain, name)资源文件翻译BindLocale(g Gettexter)绑定全局翻译实例传nil则重置为默认SetLanguage/SetDomain设置或查询全局语言与域翻译查找的底层实现在 tr.go所有条目以msgctxt \x04 msgidmo.EotSeparator为键存入哈希表查询时先按精确键查找命中且MsgStr非空才返回译文否则原样返回 msgid保证缺翻译时程序依然可用func (p *translator) findMsgStr(msgctxt, msgid string) string { key : p.makeMapKey(msgctxt, msgid) if v, ok : p.MessageMap[key]; ok { if v.MsgStr ! { return v.MsgStr } } return msgid }在 MO 二进制中带上下文的条目正是以\x04分隔msgctxt与msgid复数条目以\x00mo.NulSeparator分隔单复数形态mo/file.go解析时按这两个分隔符切分还原mo/file.go。复数形式Plural Forms不同语言的复数规则差异很大英语只有 1/2 两种形式俄语有 3 种斯洛文尼亚语多达 4 种。gettext-go 的plural包内置了标准规则表plural/table.goFormula(lang)按语言前缀匹配并返回对应的func(n int) intplural/formula.go未命中时回退到未知语言的nplurals1; plural0;规则。常用语言规则摘录语言复数规则Plural-Forms头字段含义ja / vi / konplurals1; plural0;只有一种形式en / de / es / it / hu / trnplurals2; plural(n ! 1);n1 用单数其余用复数pt_BR / frnplurals2; plural(n 1);n1 用复数ru / uk / be / sr / hrnplurals3; plural(n%101 n%100!11 ? 0 : n%102 n%104 (n%10010 || n%10020) ? 1 : 2);俄语系三形式规则plnplurals3; plural(n1 ? 0 : n%102 n%104 (n%10010 || n%10020) ? 1 : 2);波兰语三形式规则slnplurals4; plural(n%1001 ? 0 : n%1002 ? 1 : n%1003 || n%1004 ? 2 : 3);斯洛文尼亚语四形式规则实际翻译时PNGettext先用PluralFormula(n)计算出形式下标再从MsgStrPlural数组中取对应译文并做了越界防护下标超出时取最后一个与降级兜底无译文时回退到msgidPlural或msgidtr.go。PO / MO 文件的解析细节PO 文本格式po包负责解析可读的 PO 文本。File结构由MimeHeader文件头与Messages消息条目列表组成po/file.go。文件头的msgid 条目会被解析为Headerpo/header.go其中Language与Plural-Forms字段分别决定复数规则的选择。一条典型的消息条目形如msgctxt menu msgid Open msgstr 打开 msgid Hello, world! msgstr 你好, 世界!一个典型的hello.po头部包含Project-Id-Version、Report-Msgid-Bugs-To、POT-Creation-Date、Last-Translator、Language-Team、Language、MIME-Version、Content-Type、Content-Transfer-Encoding、Plural-Forms、X-Generator等字段解析器对未知字段也会保留到UnknowFields中po/header.go。po.Load(data)与po.LoadFile(path)分别从内存字节与文件加载po/file.go。MO 二进制格式mo包解析 gettext 的编译产物.mo。格式要点mo/file.go文件头固定 28 字节首个字段是魔数用于探测字节序小端魔数0x950412de大端魔数0xde120495解析器据此自动切换binary.LittleEndian/binary.BigEndian头之后是 msgid 表与 msgstr 表的偏移/长度描述符条目按偏移量定位读取msgid为空串的条目视为 MIME 头含\x04EotSeparator的 msgid 拆分为 msgctxt msgid含\x00NulSeparator的 msgid 拆分为单数/复数形态msgstr 则按\x00切分为复数译文数组。加载优先级小结对同一个(domain, lang)syncTrMap的尝试顺序是.po优先 →.mo次之 →.json再次 → 全部失败则用nilTranslator兜底locale.go。因此如果目录中同时存在hello.po与hello.mo实际生效的是.po——这为调试提供了便利直接修改 PO 文件即可生效无需重新编译 MO。v0.1.0 → v1.0.0 迁移指南v1.0.0 对 API 做了一次较大的整理README 给出了两份迁移对照表。正在使用旧版本或参考旧示例代码的读者需要重点关注。包路径重命名v0.1.0旧v1.0.0新github.com/chai2010/gettext-go/gettextgithub.com/chai2010/gettext-gogithub.com/chai2010/gettext-go/gettext/pogithub.com/chai2010/gettext-go/pogithub.com/chai2010/gettext-go/gettext/mogithub.com/chai2010/gettext-go/mogithub.com/chai2010/gettext-go/gettext/pluralgithub.com/chai2010/gettext-go/plural函数重命名v0.1.0旧v1.0.0新gettext-go/gettext.*gettext-go.*gettext-go/gettext.DefaultLocalgettext-go.DefaultLanguagegettext-go/gettext.BindTextdomaingettext-go.BindLocalegettext-go/gettext.Textdomaingettext-go.SetDomaingettext-go/gettext.SetLocalegettext-go.SetLanguagegettext-go/gettext/po.Loadgettext-go/po.LoadFilegettext-go/gettext/po.LoadDatagettext-go/po.Loadgettext-go/gettext/mo.Loadgettext-go/mo.LoadFilegettext-go/gettext/mo.LoadDatagettext-go/mo.Load注意后四行是一组语义互换旧版po.Load是按文件名加载LoadData按数据加载新版中Load统一表示按字节数据加载、LoadFile统一表示按文件路径加载语义更清晰po/file.go、mo/file.go。默认上下文msgctxt语义变更v1.0.0 之前当上下文缺失时库会把调用者函数名callerName(2)如main.main隐式当作 msgctxtv1.0.0 起改为使用空字符串作为默认上下文。这一改动让无上下文条目的匹配行为更加直觉化package main // v0.1.0上下文缺失时使用 callerName(2)调用者函数名作为上下文 // v1.0.0上下文缺失时使用空字符串作为上下文 func main() { gettext.Gettext(hello) // v0.1.0 gettext.PGettext(main.main, hello) // v1.0.0 gettext.PGettext(, hello) gettext.DGettext(domain, hello) // v0.1.0 gettext.DPGettext(domain, main.main, hello) // v1.0.0 gettext.DPGettext(domain, , hello) gettext.NGettext(domain, hello, hello2, n) // v0.1.0 gettext.PNGettext(domain, main.main, hello, hello2, n) // v1.0.0 gettext.PNGettext(domain, , hello, hello2, n) gettext.DNGettext(domain, hello, hello2, n) // v0.1.0 gettext.DPNGettext(domain, main.main, hello, hello2, n) // v1.0.0 gettext.DPNGettext(domain, , hello, hello2, n) }如果你过去依赖调用者函数名作上下文的行为升级后需要检查 PO 文件中是否出现了以函数名为 msgctxt 的条目并在调用处显式传入PGettext/DPGettext等带上下文的方法。BindLocale 支持 FileSystem 接口v1.0.0 起BindLocale的入参统一为Gettexter并支持通过FileSystem自定义数据源。README 中的示例// Use FileSystem: // BindLocale(New(poedit, name, OS(path/to/dir))) // bind poedit domain // BindLocale(New(poedit, name, OS(path/to.zip))) // bind poedit domainBindLocale(nil)会重置全局实例为默认状态gettext.go。结合NewFS的分发逻辑你还可以传入任意自定义的FileSystem实现例如从数据库或远程配置中心加载翻译这是将 gettext-go 接入云原生环境的扩展点。使用建议与问题反馈实践建议优先使用目录形式开发、zip 形式发布开发期直接用New(hello, locale)指向目录改动 PO 即时生效发布时打包locale.zip甚至用New(hello, locale.zip, zipData)内嵌到二进制中彻底摆脱运行期文件依赖保持.po为单一事实来源由于加载顺序是.po→.mo→.json本地调试时只保留.po即可避免旧.mo掩盖新译文资源文件按语言分目录需要本地化的非文本资源图标、说明文档等放在LC_RESOURCE/$(domain)/下用Getdata/DGetdata读取并发安全Gettexter实例内部有互斥锁保护多个 goroutine 可共享同一个实例。问题反馈README 的 BUGS 一节注明发现缺陷请提交到维护者邮箱chaishushangmail.comREADME 原述。总结gettext-go 以不到十个源文件实现了 GNU gettext 的核心能力语言探测LC_MESSAGES/LANG、统一目录布局、PO/MO/JSON 三种消息目录、按语言与 domain 的翻译表缓存、复数形式规则以及FileSystem抽象带来的目录 / zip / 内嵌 zip / JSON / 自定义多形态数据源。通过 README.md、gettext.go、locale.go 与 fs.go 的对照阅读你既可以把它当作开箱即用的 i18n 工具也可以把它作为理解 gettext 体系在 Go 中如何落地的范本——而 origin 仓库的 vendor 目录恰好提供了这份原汁原味的参考源码。赞分享测试云原生质量保障【免费下载链接】originConformance test suite for OpenShift项目地址https://gitcode.com/gh_mirrors/or/origin点击查看免费下载相关推荐gettext-go 完全指南在 Go 项目中接入 GNU gettext 国际化与本地化gettext go 完全指南在 Go 项目中接入 GNU gettext 国际化与本地化 导读 gettext go 是 GNU gettext 国际化/本云原生多集群集群管理微服务kops 仓库内嵌的 gettext-go 完整指南在 Go 中实现 GNU gettext 国际化i18nkops 仓库内嵌的 gettext go 完整指南在 Go 中实现 GNU gettext 国际化i18n 导读 gettext go https://云原生集群管理运维IaCCNNDetection与StyleGAN3如何应对最新的GAN生成技术挑战CNNDetection与StyleGAN3如何应对最新的GAN生成技术挑战 随着AI图像生成技术的飞速发展StyleGAN3等先进模型能够创建出高度逼真的后端云原生容器编排微服务创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考